🤖 AI 摘要
OpenAI-compatible API Gateway 是指使用与 OpenAI API 相同请求格式的 API 代理服务。它通过统一的 Base URL + API Key 机制，让各种客户端（Codex CLI、Cursor、Continue、LobeChat、NextChat 等）无需修改代码，只需要更换 Base URL 即可切换到不同的模型源。Link-AI 提供 api1（普通请求）和 api2（长任务直连）两个通道，兼容主流 OpenAI-compatible 客户端。如果你正在配置 Continue.dev、Cursor、Codex 或 Cline，OpenAI-compatible API 的关键是 Base URL、API Key、模型名和 /v1 模式是否匹配，选对通道可以显著减少 401、403、524 等错误。
💡 直接答案
OpenAI-compatible 的核心是 Base URL + API Key + /v1 + 模型名，四者必须同时匹配。换 Base URL = 换模型源，换 API Key = 换账户。如果你正在配置 Continue.dev、Cursor、Codex 或 Cline，OpenAI-compatible API 的关键是 Base URL、API Key、模型名和 /v1 模式是否匹配。Codex CLI、Claude Code 等长任务工具用 api2.link-ai.cc/v1；普通聊天工具（Cursor 快速问答、LobeChat）用 api1.link-ai.cc/v1。常见错误：401 = Key 无效，403 = 没权限，404 = 路径错误，524 = 超时（换 api2）。
如果你需要在 Continue.dev 里单独配置 OpenAI-compatible Provider（API Key / Base URL / model），可以看这篇承接页：/continue-openai-compatible-api/。
OpenAI-compatible 是什么
OpenAI-compatible 是指 API 的请求格式与 OpenAI 官方 API 完全兼容：
- 请求格式：
POST /v1/chat/completions - 认证方式：
Authorization: Bearer sk-xxx - Body 结构：
model、messages、max_tokens等字段
只要中转站支持这个格式，客户端就可以通过换 Base URL 来接入，而不需要任何代码修改。
Base URL 和 API Key 的关系
- Base URL：API 服务器地址，决定请求发到哪里。例如
https://api1.link-ai.cc/v1 - API Key：身份认证令牌，从 Link-AI 控制台获取
- 两者的关系：Base URL 决定用哪个模型源（哪个中转站），API Key 决定用哪个账户
关于 Base URL、API Key、/v1 和模型名的完整填写逻辑，参考 OpenAI API Key 和 Base URL 是什么？新手配置指南。
Google I/O 2026 后，为什么 OpenAI-compatible API Gateway 更重要
Google I/O 2026 后，agentic coding 工具不再只是"一次 chat completion"，而是包含工具调用、代码执行、长任务编排的整体系统。Antigravity CLI、Claude Code、Codex CLI、Cursor 这类工具对 API Provider 的要求更高：
- 需要统一的 Base URL 接入多个模型
- 需要长请求通道（避免 524 Gateway Timeout）
- 需要清晰的 usage log（核验扣费是否透明）
- 需要可靠的错误透传（401/403/503/524 都能溯源）
OpenAI-compatible API Gateway 的核心价值，正是提供以上统一能力。无论开发者用的是 Claude Code（ANTHROPIC_BASE_URL）、Codex CLI（config.toml）、Cursor（Provider 配置）还是 Antigravity CLI（API Provider），只要 Base URL 和 API Key 格式一致，都可以共用同一个网关。
相关页面：Antigravity CLI API Provider 配置准备清单｜Claude Code API 为什么会超时
为什么很多客户端只要换 Base URL
因为这些客户端内置了 OpenAI API 兼容层。用户只需要：
- 填入 Base URL（指向 Link-AI 而不是 OpenAI）
- 填入从 Link-AI 获取的 API Key
- 选择想用的模型（claude-3-opus、gpt-4 等）
客户端会自动用 OpenAI 兼容格式发送请求，Link-AI 会处理并路由到对应模型。
主流客户端接入指南
| 客户端 | 使用场景 | 推荐文档 | 推荐 Base URL |
|---|---|---|---|
| Codex CLI | 编码代理、长任务 | docs/codex-cli | https://api2.link-ai.cc/v1 |
| Claude Code | 长上下文/Agent | docs/claude-code | https://api2.link-ai.cc/v1 |
| Cursor | IDE 编程 | docs/cursor-api-base-url | api1 或 api2 |
| Continue | IDE 插件 | docs/continue-api-base-url | api1 或 api2 |
| LobeChat / NextChat | 聊天前端 | docs/lobechat-nextchat | https://api1.link-ai.cc/v1 |
api1 / api2 怎么选
| 通道 | Base URL | 适合场景 | 不适合场景 |
|---|---|---|---|
| api1 | https://api1.link-ai.cc/v1 |
普通聊天、LobeChat、快速问答 | Claude Code 长任务、Codex CLI |
| api2 | https://api2.link-ai.cc/v1 |
Claude Code、Codex CLI、长上下文 | 对响应延迟敏感的快速问答 |
常见错误排查
| 错误码 | 含义 | 常见原因 | 解决方案 |
|---|---|---|---|
| 401 | 认证失败 | API Key 无效、未设置、格式错误 | 检查 ANTHROPIC_AUTH_TOKEN 或 Authorization header |
| 403 | 权限不足 | Key 没有该模型访问权限、用户分组限制 | 在控制台检查模型授权，参考 403 排查 |
| 404 | 未找到 | Base URL 路径错误、模型名不存在 | 确认 Base URL 是 /v1 结尾，模型名正确 |
| 524 | 超时 | 任务太长，Cloudflare 120s 超时 | 切换到 api2 直连通道，参考 524 排查 |
| 503 | 服务不可用 | 上游过载或暂时不可用 | 等待后重试，检查渠道状态，参考 503 排查 |
Link-AI 的接入路径
- 注册账号：api1.link-ai.cc/register
- 创建 API Key：在控制台 #/console/token 创建
- 选择客户端对应文档：根据上表的客户端类型，选择对应的配置文档
- 测试连通性：用 curl 或客户端自带测试功能验证
快速接入 Link-AI
注册后即可获取 API Key，支持所有主流 OpenAI-compatible 客户端
普通请求: https://api1.link-ai.cc/v1
|
长任务: https://api2.link-ai.cc/v1
FAQ
https://api1.link-ai.cc/v1；如果是长请求或容易超时的任务，可以根据客户端支持情况考虑 https://api2.link-ai.cc/v1。API Key 必须来自同一平台。