接口总览

网关地址

所有接口统一走：

https://goodcode.store

请求路由到哪个上游平台，由 API Key 所绑定分组的平台类型决定，详见 分组与模型。

鉴权方式

请求头	适用范围	示例
Authorization: Bearer <key>	所有端点	Authorization: Bearer sk-xxx
x-api-key: <key>	所有端点	x-api-key: sk-xxx
x-goog-api-key: <key>	Gemini /v1beta 端点	x-goog-api-key: sk-xxx

注意

不支持把 API Key 放在 URL query 参数中（如 ?key=），会返回 400 错误。

端点列表

Claude（Anthropic 协议）

方法	路径	说明
POST	/v1/messages	对话（Messages API，支持流式）
POST	/v1/messages/count_tokens	Token 计数
GET	/v1/models	模型列表
GET	/v1/usage	用量查询

OpenAI / Codex 协议

方法	路径	说明
POST	/v1/responses	Responses API（Codex 使用，支持流式 / WebSocket）
POST	/v1/chat/completions	Chat Completions（兼容接口）
POST	/v1/embeddings	向量嵌入（仅 OpenAI 分组）
POST	/v1/images/generations	图片生成（仅 OpenAI / Grok 分组）
POST	/v1/images/edits	图片编辑（仅 OpenAI / Grok 分组）

相关信息

/responses、/chat/completions、/embeddings 等也提供不带 /v1 前缀的别名（如 https://goodcode.store/responses），两种写法等价。

Gemini（原生 v1beta 协议）

方法	路径	说明
GET	/v1beta/models	模型列表
GET	/v1beta/models/{model}	模型详情
POST	/v1beta/models/{model}:generateContent	生成内容
POST	/v1beta/models/{model}:streamGenerateContent	流式生成

Antigravity 专用端点

方法	路径	说明
POST	/antigravity/v1/messages	Claude 模型对话
POST	/antigravity/v1/messages/count_tokens	Token 计数
GET	/antigravity/models	模型列表
POST	/antigravity/v1beta/models/{model}:generateContent	Gemini 生成
POST	/antigravity/v1beta/models/{model}:streamGenerateContent	Gemini 流式生成

跨协议说明

GoodCode 网关内置协议转换，常见组合：

• OpenAI 分组的 Key 也可以调用 /v1/messages（Anthropic 兼容桥接），因此 Claude Code 可以直接跑 Codex 模型（需站点开启对应功能）
• /v1/chat/completions 的响应在 OpenAI 分组下由 Responses API 转换而来，个别第三方软件可能存在兼容性差异
• 平台不支持的接口会返回 404 not_found_error，例如非 OpenAI 分组调用 /v1/embeddings