跳到主要内容

接入速查与通用配置规则

在第三方客户端、编程工具和 Agent 框架中接入 Fluxlane 的通用规则：判断工具使用的协议、填写接口地址与 API Key、核对模型名、先用 curl 验证。

关于兼容性

工具名称出现在文档目录中，不代表平台已验证兼容。下面是通用的配置规则，适用于支持「自定义 OpenAI 兼容端点」或「自定义 Anthropic 端点」的工具。

第一步：确认工具使用的协议​

工具设置中的说法协议接口地址填写
OpenAI 兼容、自定义 OpenAI 端点、OpenAI API BaseOpenAI Chat Completionshttps://run.fluxlane.ai/v1
使用 Responses API（如部分 Codex 类工具）OpenAI Responseshttps://run.fluxlane.ai/v1
Anthropic、Claude API Base、ANTHROPIC_BASE_URLAnthropic Messageshttps://run.fluxlane.ai

工具文档中如果写明需要填写「完整请求地址」，则填写到具体接口，例如 https://run.fluxlane.ai/v1/chat/completions。各写法的区别见地址写法。

第二步：填写 API Key 与模型名​

  • API Key：为每个工具单独创建一个密钥，并设置配额上限，便于单独停用和对账，见创建与管理 API Key。
  • 模型名：填写完整的模型 ID，大小写和版本号都要一致，以 GET /v1/models 的返回为准。
  • 能力匹配：工具需要识图或工具调用时，先在模型能力矩阵确认所选模型支持；例如 glm-5.3 不接受图片，GPT-6 在 Chat Completions 上使用工具有特殊要求。

第三步：先用 curl 验证​

在工具里排查之前，先用同一个 Key 和模型名在命令行确认平台侧正常：

bash
curl https://run.fluxlane.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLUXLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"模型名称","messages":[{"role":"user","content":"ping"}]}'
  • curl 成功、工具失败：问题在工具配置（地址写法、协议选择、模型名）。
  • curl 也失败：按返回的状态码查看 HTTP 状态与平台错误码。

安全建议​

  • 不要把 API Key 写进会提交到代码仓库的配置文件；优先使用环境变量。
  • 在共享电脑或团队共用的工具中使用独立的密钥，并设置过期时间。
  • 发现异常用量时立即在控制台停用对应密钥。

常见问题​

现象可能原因
404地址多写或少写了 /v1，或把接口路径重复拼接
401Key 填错、带了多余空格或换行
400 / 666工具发送了所选模型不支持的字段，例如向不支持识图的模型发送图片
Claude Code 返回 400实验性 beta 请求头被拒绝，见模型、参数与协议问题