协议兼容性与迁移说明
Fluxlane 各厂商模型对 Chat Completions、Responses、Messages 等接口路径的支持对照，以及从 OpenAI、Anthropic 官方 API 迁移的步骤和参数映射。
接口路径支持对照
Base URL 为 https://run.fluxlane.ai。对话、识图、工具往往在同一条路径上，用不同字段区分。
| 厂商 | /v1/chat/completions | /v1/responses | /v1/messages | /v1/completions | /v1/images/generations |
|---|---|---|---|---|---|
| OpenAI | 支持（只用 Responses 的 4 个模型除外） | 支持；部分模型只能用这条路径 | — | 旧版文本补全 | 未接入 |
| Anthropic | 支持，平台转换为 Claude Messages | 不支持，返回 not implemented | 支持（推荐） | 不支持 | 不支持 |
| GLM | 支持 | 不支持 | 不支持 | 不支持 | — |
| Kimi | 支持 | 不支持 | 不支持 | 不支持 | 不支持 |
| DeepSeek | 支持 | 支持 | 不支持 | 不支持 | 不支持，DeepSeek 没有生图接口 |
视频生成使用独立的接口，见视频生成：Seedance和视频生成：Kling、Hailuo、Vidu。按模型列出的能力见模型能力矩阵。
旧版与未接入的路径
POST /v1/completions：旧版文本补全，图像和工具都不在这条路径上。对话请用/v1/chat/completions或/v1/responses。POST /v1/images/generations：官方生图使用gpt-image-*图像模型；GPT 对话模型在/v1/chat/completions上只返回文字。平台尚未接入图像模型，本路径当前不可用。
从官方 API 迁移
从 OpenAI 迁移
- 把
base_url改为https://run.fluxlane.ai/v1，api_key换成 Fluxlane 的 API Key。 - 把
model换成平台上的模型 ID（以GET /v1/models为准）。 - 检查输出长度参数：GPT 新系列使用
max_completion_tokens，带max_tokens的请求会被拒绝。 - GPT-6 的工具调用按模型选择路径，见工具调用 · GPT-6。
从 Anthropic 迁移
- 把 Anthropic SDK 的
base_url改为https://run.fluxlane.ai（不带/v1），api_key换成 Fluxlane 的 API Key。 - 鉴权可继续使用
x-api-key+anthropic-version，也可以改用Authorization: Bearer。 - 不需要改请求体，
/v1/messages的字段与官方一致。注意 Haiku 5.5 的采样参数限制，见 Anthropic Messages。
参数映射
| 用途 | Chat Completions | Responses | Anthropic Messages |
|---|---|---|---|
| 对话内容 | messages | input | messages，系统提示词在顶层 system |
| 输出长度 | max_completion_tokens（GPT 新系列） | max_output_tokens | max_tokens（必填） |
| 图片 | image_url 对象 | input_image，image_url 为字符串 | image 内容块 |
| 工具声明 | function 嵌套结构 | 扁平结构 | input_schema |
| 工具结果 | role: tool + tool_call_id | function_call_output + call_id | tool_result + tool_use_id |
| 鉴权 | Authorization: Bearer | Authorization: Bearer | x-api-key 或 Authorization: Bearer |
迁移检查清单
- 接口地址与 SDK 的
base_url写法正确 - 模型名已替换为平台模型 ID
- 输出长度参数名与所用接口匹配
- 识图、工具调用使用了所选接口对应的字段
- 不调用目标厂商不支持的路径（见上方对照表）
- 已在测试环境用独立的 API Key 验证，并设置了配额上限