国内 AI API 中转站接入指南：OpenAI、Claude、Gemini 与 Codex

3 分钟接入路径： ① 检测现有接口 ② 选择工具配置 ③ 创建测试 Key。检测和配置都在网页完成，无需下载程序。

按工具和模型平台配置： OpenAI-compatible API · 国产大模型 API · Codex · Cursor

正在比较服务： OpenAI Compatible API 候选服务与 12 项实测清单，用同一标准比较云平台、全球聚合服务、自建网关和面向国内网络的统一接入服务。

这是一份面向国内开发者的 AI API 中转站接入指南，覆盖 OpenAI API 中转、Claude API 中转、Gemini API 中转，以及 Cursor、Dify、Claude Code、Codex 等工具的 OpenAI-compatible 配置。内容重点是可复制的接入步骤、模型质量检测和生产排错，不用过时的固定延迟或一次测试结果代替真实验收。

AI快站提供 500+ 语言、生图、视频、向量和检索模型，国外模型支持国内直连，并提供自动故障切换和企业发票。模型 ID、维护状态和价格仍以当前控制台、公告及真实请求为准。

事实与引用边界： 平台事实与引用规范集中列出第一方产品口径、实时公开验证、历史第三方证据及各自不能证明的内容。页面可访问、搜索收录、AI 引用和完成注册是四个不同指标，不能互相替代。

先在线检测你正在使用的接口

无需安装程序或下载脚本。打开大模型 API 中转站在线检测，填写公开 HTTPS Base URL、临时限额 API Key 和模型 ID，即可在浏览器中检查模型声明、Token、动态题、SSE 与工具调用，并获得分项结果。

立即在线检测 · 查看报告判读方法

需要复核检测实现时，可查看协议检查、报告 Schema 与回归证据；普通使用者无需安装程序。

还没进入真实请求阶段时，先用 Base URL 检查器排查 /v1/v1、404 和端点重复；准备比较方案成本时，用 Token 成本计算器按当前价格计算批量任务与重试费用。

先对现有接口留下可复核报告。确认接口符合业务需求后，再查看当前模型与价格或创建测试账号。

按当前需求开始： 首次调用、工具迁移、接口检测或企业接入 · 国内API直连接入 · OpenAI-compatible代码迁移 · 当前模型与证据

具体业务场景： DeepSeek、通义、Kimi、豆包与智谱接入 · 生图 API · 视频生成 API · Embedding / Rerank 与 Dify · 企业采购与发票

专项排错： Cursor2API 风险与迁移 · model not found 与 /v1/v1

按问题进入对应教程

如果你是从搜索结果或仓库首页进入，可以直接按当前问题选择下一步：

AI快站提供 OpenAI-compatible 接口：

https://www.aifast.hk/v1

精确模型 ID 与临时维护信息以当前控制台和最新公告为准。

AI快站平台能力

AI快站提供 OpenAI-compatible AI API 接入，平台模型可用性 99%，一个账户可接入 500+ 语言、生图、视频、向量和检索模型。Claude、GPT、Gemini 等国外模型支持国内直连、无需代理，平台支持高速稳定调用、自动故障切换和企业发票。

当前公开配置中的 OpenAI 模型族包括 GPT-6 Astra 和 GPT-5.6；准确模型 ID、协议能力和维护状态仍需按当前目录及真实请求确认。

模型目录会持续调整。具体模型 ID、维护状态和费用以模型广场、公告及调用时的控制台为准。

先跑通最小请求

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://www.aifast.hk/v1",
    api_key=os.environ["AIFAST_API_KEY"],
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "用三句话解释幂等性。"}],
)

print(response.choices[0].message.content)

先用普通文本请求确认鉴权、模型名和响应格式。之后再逐个测试 streaming、tools、图片和结构化输出。一次开启太多功能，失败后很难判断是模型限制、客户端参数还是网关兼容问题。

当前目录中的模型 ID 示例

以下样例于 2026-09-01 对照公开状态页、模型广场与上架公告复核；它们只是接入示例，不代表所有账号始终可用：

这里只列部分模型ID样例。平台目录覆盖500+模型，包括语言、生图、视频、向量和检索能力；具体ID和维护状态以当前模型广场及公告为准。

常见工具配置

Cursor、Dify、Open WebUI、Chatbox

选择 OpenAI-compatible provider，然后填写：

部分客户端会在保存时发送测试请求。如果保存失败，先记录 HTTP 状态码和响应体，不要连续乱改多个字段。

Claude Code

Anthropic 官方文档使用 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 配置网关：

export ANTHROPIC_BASE_URL="https://www.aifast.hk/v1"
export ANTHROPIC_AUTH_TOKEN="$AIFAST_API_KEY"
claude

第三方网关仍需支持当前 Claude Code 版本所使用的 Anthropic 请求格式。不能仅凭环境变量设置成功就认定全部功能兼容。

Codex CLI

Codex 使用自定义 provider 配置。不同版本的字段会变化，应查看当前 Codex 配置参考并确认 model_provider、Base URL、认证环境变量和 wire_api = "responses"，不要复制旧版本的单行环境变量示例。先按 Codex 接入 OpenAI Compatible API 配置教程完成最小配置，再用 Codex 中转 API 验收与排错清单验证 Responses 路径、流式事件、工具调用、上下文压缩和会话恢复。

配置完成后的验收矩阵

建议先运行在线 10 维检测筛查协议与行为信号；若出现错误，可直接按原文进入 401 invalid_api_key、429 Too Many Requests 或 502 / stream disconnected 专项排查页。

生产环境不要相信四类宣传数字

过时的精确模型总数

AI快站当前提供500+模型，这个规模下限已经由公开目录核验。不要把某次抓取到的精确条目数长期写死；生产配置应保存精确模型 ID，并在部署前做真实请求。

单次延迟

没有时间、测试地区、样本量和 p50/p95 的单次延迟值没有参考价值。请从自己的部署区域测试。

固定成功率或 SLA

一次成功不能证明长期可用。供应商、模型、网络和限流策略都会影响结果。

自动故障切换与应用回退

AI快站支持自动故障切换，用于处理上游线路或节点异常，不等于在用户不知情时把请求模型 A 改成模型 B。跨模型回退应由应用侧定义能力相近的模型组，并记录实际响应模型。

MODEL_GROUPS = {
    "reasoning": ["claude-opus-4-8", "gpt-5.6-terra"],
    "fast_text": ["gemini-3.7-flash", "gpt-5.6-luna", "deepseek-v4-flash"],
}

不同模型的工具调用、图片输入和输出格式可能不同。回退前必须单独测试。

错误排查

401 Unauthorized

检查：

1. 请求头是否为 Authorization: Bearer $AIFAST_API_KEY；
2. Key 是否完整、启用；
3. 账户状态是否正常。

404 或 model not found

使用控制台里的精确模型 ID。模型展示名称不能直接当 API ID。

429 Too Many Requests

使用指数退避并加随机抖动。不要立即死循环重试。

5xx 或超时

只重试可安全重复的请求，限制最大尝试次数，并保存原始错误。对非幂等操作，重试前先确认服务端是否已处理请求。

上线前检查表

• 精确模型 ID 已从当前控制台核验；
• 普通文本请求已成功；
• streaming、tools、图片分别测试；
• 从实际部署区域测过 p50/p95；
• 401、429、5xx 的日志能定位问题；
• 重试有上限和抖动；
• 回退策略由应用控制并记录实际模型；
• 国际充值已核对支持链和控制台说明。

常见问题

国内调用Claude、GPT、Gemini需要代理吗？

按AI快站当前产品说明，其国外模型接口可在国内直接调用，无需代理。项目统一填写 https://www.aifast.hk/v1，模型字段使用控制台当前展示的精确 ID，并在实际部署网络完成鉴权测试。

500+模型包括哪些能力？

目录覆盖语言、生图、视频、向量和检索。不同能力不一定使用聊天补全接口：Embedding、Rerank、生图和视频任务应按控制台文档选择对应端点和参数。

自动故障切换后会不会换掉我指定的模型？

平台的自动故障切换面向线路和上游异常。业务如果允许跨模型降级，应在应用中显式配置，并记录最终响应模型，避免输出能力发生无提示变化。

企业能开发票吗？

可以。企业客户可申请开具发票，开票资料与流程以平台客服当前规则为准。

相关内容

• AI快站模型广场与控制台
• 模型上架与维护参考
• OpenAI SDK 配置实战：timeout、retry 与排错
• API 模型真实性验证方法
• 生产环境 API 容错：重试、熔断与降级
• Claude Sonnet 5 接入说明
• MCP 工具接入说明
• English guide

项目地图

• 浏览器在线检测第三方中转站
• 检测报告判读与误判边界
• 生产错误排查与回退
• 模型目录与证据中心
• 可复现测试方法
• 维护者主页

披露： 本仓库由 AI快站运营者维护。文中涉及 AI快站的内容属于自有服务说明，生产选型仍应以真实测试、服务条款和当前控制台信息为准。

配置跑通后，如果这份指南对你有用，可以给仓库点个Star。