协议与端点

以下是推荐的公开入口。兼容别名主要服务特定客户端，不建议新集成依赖。

OpenAI Chat Completions

POST /v1/chat/completions
GET  /v1/models

请求使用 messages 数组；流式请求设置 stream: true，返回 SSE，并以 [DONE] 结束。

兼容别名：POST /chat/completions。

OpenAI Responses

POST /v1/responses
GET  /v1/models

请求使用 input；流式请求设置 stream: true，返回 Responses 事件。兼容根级别名包括 /responses，Codex 专用兼容入口位于 /backend-api/codex，普通 SDK 不应手工使用。

/v1/responses/compact、图片、视频和 WebSocket 属于专用能力，不能据此推断所有平台都支持。OpenCode Go 仅支持根级 HTTP Responses 生成，不支持 Responses WebSocket 和 /responses/* 专用子路径。

Anthropic Messages

POST /v1/messages
GET  /v1/models
POST /v1/messages/count_tokens

请求使用 messages 和 max_tokens；流式返回 Anthropic SSE 事件，以 message_stop 完成。count_tokens 仅在所选平台具备对应能力时可用，不能作为所有分组的通用保证。

Google GenAI

GET  /v1beta/models
GET  /v1beta/models/{model}
POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{model}:streamGenerateContent
POST /v1/models/{model}:generateContent
POST /v1/models/{model}:streamGenerateContent

/v1beta 用于标准模型发现和生成。稳定 /v1/models/{model}:... 生成路径也受支持，但 GET /v1/models 保持 OpenAI 风格模型列表，不是 Google 列表。

Google API Key 可通过 x-goog-api-key 传入。不要把 Key 放在 ?key= query 中。

专用 Antigravity 路径

/antigravity/v1/* 和 /antigravity/v1beta/* 会强制使用 Antigravity 平台。只有控制台配置或支持人员明确要求时使用；普通接入优先选择上面的统一入口。

认证错误快速判断

• API_KEY_REQUIRED：三个支持的 Header 都未读取到 Key。
• INVALID_API_KEY：Key 不存在。
• API_KEY_DISABLED：Key 已禁用。
• ACCESS_DENIED：IP 访问策略不允许当前来源。

更多状态见HTTP 状态码。