AI API 中转站 · 高意图问题直达

从“怎么接入”到“为什么报错”，按问题直接找到答案

这里不把所有问题混在一篇长文里。先选择客户端或错误码，再用最小请求确认 Base URL、认证、模型、速率与超时分别处在哪一层。

选择最接近你当前的问题

每页包含明确症状、三步验证、可复制配置、结果判断和下一条相关路径。

OpenAI API 国内接入教程：使用 LinkAGI AI API 中转站配置 Base URL、API Key、Python SDK 与首次请求，附 401、404、429 和价格核对入口。

CC Switch 配置 LinkAGI API 中转站教程：添加供应商、填写 Codex 与 Claude Code 地址、API Key、启用配置并排查 /v1 重复问题。

Cherry Studio 接入 LinkAGI API 中转站：新增 OpenAI-compatible 提供方、填写 https://api.linktoagi.com/v1、API Key、模型名并完成连通性测试。

Codex 接入 API 中转站出现 401 Invalid token 的排查方法：确认请求已到认证层，检查环境变量、config.toml、API Key、分组和余额。

Codex API 中转站返回 404 Invalid URL 的原因与修复：区分 Base URL 和最终端点，检查 /v1 缺失、重复路径以及 Responses 协议配置。

OpenAI-compatible API 返回 429 的排查方法：区分请求速率、并发、余额、模型号池和上游限制，使用指数退避、限并发和日志核对。

AI API 中转站出现 504 的系统排查：区分边缘代理、网关、上游模型和客户端超时，检查流式传输、首字节时间、图片任务与重试边界。

Claude Code 接入 API 中转站出现 model not found 的修复方法：从实时模型广场复制模型名，检查令牌分组、环境变量、地址与当前模型状态。

Gemini CLI 接入 API 中转站返回 403 的排查步骤：检查 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY、模型权限、分组与认证方式。

先确认域名可达、证书有效，区分网页连通和接口路由。

404 先查路径；401/403 再查 Key、环境变量和权限。

认证通过后再查模型名、分组、余额、限流和上游。

状态码用于缩小范围，不是服务质量结论。有效模型调用需要正确 Key、可用余额、允许的分组与当前可用上游。

地址诊断器不需要填写 API Key。