1. FluxNode API
文档
  • FluxNode API
    • 01-前言
    • 02-如何使用FluxNode
    • 03-Claude-Code配置教程
    • 04-Cursor配置教程
    • 05-Windsurf配置教程
    • 06-Cline配置教程
    • 07-Trae配置教程
    • 08-Aider配置教程
    • 09-Gemini-CLI配置教程
    • 10-OpenAI-Codex配置教程
    • 11-Cherry-Studio配置教程
    • 12-ChatBox配置教程
    • 13-LobeChat配置教程
    • 14-NextChat配置教程
    • 15-沉浸式翻译配置教程
    • 16-Dify配置教程
    • 17-N8N工作流配置教程
    • 18-OpenClaw配置教程
    • 19-OpenClaw配置API教程
    • 20-OpenCode配置API教程
    • 21-OpenAI-SDK使用教程
    • 22-高并发批量请求示例
    • 23-模型兼容性说明
    • 24-常见问题FAQ
    • 25-联系客服
    • README
    • 模型信息
      • 列出可用模型
      • 列出单个模型
    • 聊天模型(Chat)
      • 聊天接口(通用)
      • 聊天接口(图片分析)
      • 聊天接口(函数调用)
      • 聊天接口(o1-o3系列模型)
      • gpt-4o-all 文件分析
      • gpt-4-all 文件分析
      • 聊天补全
      • Claude (OpenAI格式)-可PDF分析
      • Claude (原生格式)-可PDF分析
      • Gemini (OpenAI格式)-可文件分析
      • Gemini (原生格式)-可文件分析
      • GPTs
  1. FluxNode API

24-常见问题FAQ

1. 报错 401 Unauthorized / API key is invalid#

原因:API Key 无效或未正确设置。
解决方法:
确认令牌以 sk- 开头,且完整复制(没有多余空格)
登录 FluxNode 后台检查令牌是否存在且未被禁用
确认令牌的额度未用完

2. 报错 402 / Insufficient quota / 额度不足#

原因:账户余额不足。
解决方法:
登录 FluxNode 后台充值
检查令牌是否设置了额度上限

3. 报错 404 Not Found / Model not found#

原因:请求的模型不存在或不可用。
解决方法:
检查模型名称是否拼写正确
访问 https://api.fluxnode.org/v1/models 查看当前可用的模型列表
部分模型可能需要特定分组的令牌才能访问

4. 报错 429 Too Many Requests / Rate limit#

原因:请求频率过高,触发了速率限制。
解决方法:
降低请求频率
在代码中添加重试逻辑和延迟
如需更高并发,请联系客服

5. 报错 500 / 502 / 503 / Internal Server Error#

原因:上游服务暂时不可用。
解决方法:
等待几秒后重试
如果持续出现,尝试切换到其他模型
联系客服反馈

6. 回复速度很慢#

可能原因:
使用的模型本身响应较慢(如 o1、o3 等推理模型)
输入内容过长
网络波动
解决方法:
切换到更快的模型(如 gpt-4o-mini、claude-haiku)
减少输入的上下文长度
开启流式输出(stream: true)

7. API 地址到底要不要加 /v1?#

这取决于你使用的应用:
应用API 地址格式
ChatBoxhttps://api.fluxnode.org(不加 /v1)
Cherry Studiohttps://api.fluxnode.org(不加 /v1)
Claude Codehttps://api.fluxnode.org(不加 /v1)
NextChathttps://api.fluxnode.org(不加 /v1)
Cursorhttps://api.fluxnode.org/v1(需要加 /v1)
Windsurfhttps://api.fluxnode.org/v1(需要加 /v1)
Clinehttps://api.fluxnode.org/v1(需要加 /v1)
Traehttps://api.fluxnode.org/v1(需要加 /v1)
Aiderhttps://api.fluxnode.org/v1(需要加 /v1)
LobeChathttps://api.fluxnode.org/v1(需要加 /v1)
Difyhttps://api.fluxnode.org/v1(需要加 /v1)
N8Nhttps://api.fluxnode.org/v1(需要加 /v1)
Python SDKhttps://api.fluxnode.org/v1(需要加 /v1)
沉浸式翻译https://api.fluxnode.org/v1/chat/completions(需要完整路径)
一般规则:如果应用要求填写 "Base URL",通常需要加 /v1;如果要求填写 "API 域名" 或 "API Host",通常不加。

8. 支持哪些模型?#

访问 FluxNode 官网 的「模型价格」页面查看完整的模型列表和价格。
常用模型包括:
OpenAI: gpt-4o, gpt-4o-mini, gpt-4.1, o1, o3, o4-mini
Claude: claude-opus-4, claude-sonnet-4, claude-haiku-3.5
Gemini: gemini-2.5-pro, gemini-2.5-flash
DeepSeek: deepseek-chat, deepseek-reasoner
Grok: grok-3, grok-3-mini

9. 如何查看消费记录?#

登录 FluxNode 后台 → 点击顶部「日志」→ 可以查看每次 API 调用的详细记录,包括模型、token 用量和费用。

10. 令牌丢失了怎么办?#

令牌创建后只显示一次,无法再次查看。如果丢失了:
1.
登录后台 → 令牌管理
2.
删除旧令牌
3.
创建一个新令牌
4.
在应用中更新为新令牌

联系客服#

如果以上方法都无法解决你的问题,请联系我们:
微信:P1248978166-
修改于 2026-03-18 10:52:53
上一页
23-模型兼容性说明
下一页
25-联系客服
Built with