OpenAI Compatible API 是什么？兼容范围一页看懂
OpenAI Compatible API 可复用部分 SDK 请求格式，但不保证所有模型、端点或功能都兼容。对比 Chat Completions、Responses、Anthropic Messages 与 Gemini 原生接口，并查看 Link 接入验证入口。
先记住这四条
先确定协议和证据，再开始改配置或更换服务。
- 01
OpenAI Compatible Base URL 使用 https://www.aifast.link/v1；检查客户端是否会再追加 /v1。
- 02
在同一 Link 账号下读取 /v1/models，复制当前可用的 GPT、Claude 或 Gemini 模型 ID。
- 03
先验证 Chat Completions，再单独检查 SSE、工具调用和 usage；不要由一次聊天成功推断其他协议。
- 04
GPT/Claude 月卡只适用于指定分组，额度按天重置；Gemini 使用独立分组，不包含在这些月卡内。
OpenAI Compatible API 兼容什么，不兼容什么？
兼容接口通常复用 OpenAI SDK 的部分请求与响应格式，不代表与 OpenAI 官方账号互通，也不保证所有模型、参数、流式事件和工具调用都可用。迁移时要一起核对 Base URL、同平台 Key、模型 ID 和具体端点。
Python 的 base_url 与 Node.js 的 baseURL 是客户端选项；二者都不能让 Chat Completions 自动变成 Responses、Anthropic Messages 或 Gemini 原生协议。先按任务选择下表中的路径，再使用对应教程的最小示例。
| 客户端或任务 | 最终请求路径 | 验证重点与教程 |
|---|---|---|
| OpenAI SDK 普通聊天 | /v1/chat/completions | curl、Python 与 Node.js 示例 先验证短文本，再单独测试 SSE、工具和 usage。 |
| Codex 自定义 Provider | /v1/responses | config.toml 与 Responses 配置 不能用 Chat Completions 成功代替 Codex 工具任务验收。 |
| Claude Code 原生接入 | /v1/messages | Anthropic Base URL 与鉴权 核对 Messages、流式与工具结果回传。 |
| Gemini 接入 | /v1/chat/completions/v1beta/models/{model}:generateContent | Gemini 模型、Key 与协议选择 兼容模式使用 messages；原生模式使用 contents / parts，Link 原生鉴权仍需单独核验。 |
这张表用于选择协议，不是所有模型已通过所有端点的测试报告。模型目录列出、普通聊天成功和完整客户端任务成功是不同证据；请用当前账号与限额 Key 分别验证。
按错误现象选择排查入口
保留首次失败的状态码和脱敏响应。先定位失败阶段，再决定是否重试或调整方案。
- 01
出现 /v1/v1 或返回 HTML
先用无需 Key 的地址检查器核对拼接路径。网页 200 不等于 API 成功。 - 02
401 / invalid_api_key
核对同平台 Key、认证头和运行进程的环境变量，不公开密钥。 - 03
404 / model not found
核对模型 ID、Key 分组和端点。充值不能修复拼错的模型名或请求路径。 - 04
429 / rate limit / quota
先区分并发限流和额度不足，保留 Retry-After，不无限立即重试。 - 05
502 或流式输出中断
对照短请求与 SSE 结束事件；收到部分文字不代表任务完整结束。 - 06
聊天成功，但 Claude Code 失败
单独核验 Messages、流式和工具回传；Chat Completions 成功不能代替这些结果。
按问题进入对应教程
用 curl、Python 和 Node.js 配置 Base URL，验证模型列表与首次调用，并排查 401、model not found 与 /v1/v1。
查看步骤 02 · 快速开始Gemini API 接入：模型 ID、Base URL 与协议核对配置 AIFast Link Gemini API：核对 Base URL、模型 ID、独立分组和计费。提供离线模型名检查与请求模板，区分 OpenAI 兼容和 generateContent，避免路径、权限与月卡范围混用。
查看步骤 03 · 平台参考GPT、Claude 与 Gemini API 对比测试模板：AIFast Link 能力与成本复核用同一题集比较 AIFast Link 当前 GPT、Claude 与 Gemini 模型，记录实时模型目录、协议、延迟、Token 和计费方案；按真实任务完成情况选择模型和用量方案。
查看步骤 04 · 模型与成本大模型 API 成本估算：按量充值与月度订阅怎么选核算 AIFast Link GPT、Claude 与 Gemini API 使用成本，分别记录按量充值、月度订阅、实时模型价格、额度和实际 Token；不把其他站点或旧价格混入账单比较。
查看步骤 05 · 错误排查Claude Code API 排错：AIFast Link 接入前的协议验收接入 AIFast Link 前先确认 Claude Code 所需协议是否真实开放，再检查 Base URL、认证、流式、工具调用和 401、403、429、502；不以模型名称代替兼容性验证。
查看步骤 06 · 工具接入Claude Code API 配置：自定义 Base URL 与 Anthropic Messages配置 ANTHROPIC_BASE_URL、认证变量和模型映射，区分 Anthropic Messages 与 OpenAI Compatible 协议。
查看步骤 07 · 错误排查OpenAI Compatible Base URL 在线检查器检查 OpenAI Compatible API URL、重复 /v1、完整端点、HTTPS 与最终请求路径，快速定位 /v1/v1 和 404。
查看步骤常见问题
查看配置、验证与排错中的常见问题。
AIFast Link 的 GPT、Claude 或 Gemini 模型都能直接用于 Claude Code 吗？
不能只根据模型名称判断。Claude Code 原生接入需要相应的 Anthropic Messages 协议；先核对 Link 当前账号文档与实际开放端点，若只有 OpenAI Compatible 接口，就不能宣称原生 Claude Code 已兼容。
AIFast Link 的 API Base URL 填什么？
OpenAI Compatible 客户端使用 https://www.aifast.link/v1；Claude Code 的 ANTHROPIC_BASE_URL 使用 https://www.aifast.link，最终请求 /v1/messages；Gemini 原生 generateContent 使用 /v1beta/models/{model}:generateContent。按所选模型声明的协议配置，避免重复 /v1，也不要把原生路径填进兼容客户端。
按量充值和月度订阅怎样比较？
Link 的 GPT/Claude 月卡有效期 30 天，额度每天重置，仅覆盖指定分组；Gemini 不包含在这些月卡内。比较同样任务的按量实付与月费加钱包费用，并记录实际使用天数、日额度超额及钱包回退设置。续费、取消和退款以购买时确认的条款为准。
参考与核对来源
- OpenAI Chat API Reference
核对 Chat Completions 请求、响应和流式结构。
- Google Gemini OpenAI compatibility
区分 Google 官方兼容接口与 Link 的域名、凭据和功能边界。
- RFC 9110: HTTP Semantics
核对 HTTP 方法、状态码和重试语义。
- OWASP API Security Top 10
核对认证、资源消耗和接口安全风险。
当前模型 ID、价格和开放状态以控制台实时目录为准。