端点与鉴权
生产 API 地址默认是:
text
https://ai.enodot.shop如果控制台展示了不同地址,请以控制台为准。
鉴权方式
推荐使用 Authorization: Bearer:
http
Authorization: Bearer YOUR_ENODOT_API_KEY也兼容部分 SDK 常用请求头:
http
x-api-key: YOUR_ENODOT_API_KEY
x-goog-api-key: YOUR_ENODOT_API_KEYWARNING
不要把 API Key 放在 URL 查询参数中。?key= 和 ?api_key= 已被视为不安全用法,网关会拒绝。
支持的入口
| 协议 | 端点 | 说明 |
|---|---|---|
| OpenAI Responses | POST /v1/responses | 推荐给 Codex CLI 和新 OpenAI SDK。 |
| OpenAI Responses alias | POST /responses | 兼容部分客户端。 |
| OpenAI Chat Completions | POST /v1/chat/completions | 兼容传统 OpenAI 客户端。 |
| Anthropic Messages | POST /v1/messages | 兼容 Claude Code 和 Anthropic SDK。 |
| Anthropic Count Tokens | POST /v1/messages/count_tokens | 仅支持具备该能力的分组和渠道。 |
| Models | GET /v1/models | 返回当前 Key 可用模型。 |
| Usage | GET /v1/usage | 查询当前 Key 用量。 |
| Gemini Models | GET /v1beta/models | 兼容 Gemini SDK/CLI。 |
| Gemini Generate | POST /v1beta/models/{model}:generateContent | Gemini 非流式生成。 |
| Gemini Stream | POST /v1beta/models/{model}:streamGenerateContent?alt=sse | Gemini SSE 流式生成。 |
分组与端点匹配
普通分组通常只对应一个协议。Mixed 分组可以按入口协议把请求路由到不同来源。
| 请求入口 | 普通分组要求 | 默认聚合路由行为 | 默认聚合最终倍率 |
|---|---|---|---|
/v1/responses | OpenAI 分组 | 路由到 OpenAI 官方渠道 | 0.2000 |
/responses | OpenAI 分组 | 路由到 OpenAI 官方渠道 | 0.2000 |
/v1/chat/completions | OpenAI 分组 | 路由到 OpenAI 官方渠道 | 0.2000 |
/v1/messages | Anthropic 分组 | 路由到 Claude 官方渠道 | 2.0000 |
/v1/messages/count_tokens | Anthropic 分组 | 路由到 Claude 官方渠道 | 2.0000 |
/v1beta/* | Gemini 分组 | 路由到 Gemini 官方渠道 | 0.5000 |
当前公开分组关系。Claude 系列按统一模型名合并展示;日期名、小数写法和 -thinking 写法按同一模型档位计费。真实请求时,以你的 Key 调用 /v1/models 返回的模型名为准。
| 分组 | 协议 | 可用入口 | 当前模型 |
|---|---|---|---|
| OpenAI 官方渠道 | OpenAI | /v1/responses/responses/v1/chat/completions | GPT 文本:gpt-5.4-mini、gpt-5.4、gpt-5.5Codex: codex-auto-review图片: gpt-image-1、gpt-image-1.5、gpt-image-2 |
| Claude 官方渠道 | Anthropic | /v1/messages/v1/messages/count_tokens | Opus:claude-opus-4、claude-opus-4-1、claude-opus-4-5、claude-opus-4-6、claude-opus-4-7、claude-opus-4-8Sonnet: claude-sonnet-4、claude-sonnet-4-5、claude-sonnet-4-6Haiku: claude-haiku-4-5 |
| Claude Kiro | Anthropic | /v1/messages/v1/messages/count_tokens | Opus:claude-opus-4-5、claude-opus-4-6、claude-opus-4-7、claude-opus-4-8Sonnet: claude-sonnet-4、claude-sonnet-4-5、claude-sonnet-4-6Haiku: claude-haiku-4-5 |
| Gemini 官方渠道 | Gemini | /v1beta/* | Flash:models/gemini-2.0-flash、models/gemini-2.5-flash、models/gemini-3-flash-preview、models/gemini-3.5-flashPro: models/gemini-2.5-pro、models/gemini-3-pro-preview、models/gemini-3.1-pro-preview、models/gemini-3.1-pro-preview-customtools图片: models/gemini-2.5-flash-image、models/gemini-3.1-flash-image |
| 默认聚合路由 | Mixed | 上面所有入口 | Opus:claude-opus-4-5、claude-opus-4-6、claude-opus-4-7、claude-opus-4-8Sonnet: claude-sonnet-4-5、claude-sonnet-4-6Haiku: claude-haiku-4-5 |
这里展示的是当前线上模型列表。实际使用时,以你自己的 Key 调用 /v1/models 或 /v1beta/models 返回为准。
请求 ID
建议客户端传入稳定的请求 ID,便于排查:
http
x-request-id: your-request-id响应错误中也可能包含网关生成的 request id。向支持反馈问题时,请提供:
- 请求时间。
- API Key 名称或末尾 4 位。
- 模型名。
- 端点。
- request id。
- 完整错误 JSON。