端点与鉴权
生产 API 地址默认是:
text
https://api.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 分组可以按入口协议把请求路由到不同来源。
| 请求入口 | 普通分组要求 | Mixed 分组行为 |
|---|---|---|
/v1/responses | OpenAI 分组 | 按 openai_responses 规则选择来源 |
/v1/chat/completions | OpenAI 分组 | 按 openai_chat_completions 规则选择来源 |
/v1/messages | Anthropic 分组 | 按 anthropic_messages 规则选择来源 |
/v1beta/* | Gemini 分组 | 按 gemini_v1beta 规则选择来源 |
请求 ID
建议客户端传入稳定的请求 ID,便于排查:
http
x-request-id: your-request-id响应错误中也可能包含网关生成的 request id。向支持反馈问题时,请提供:
- 请求时间。
- API Key 名称或末尾 4 位。
- 模型名。
- 端点。
- request id。
- 完整错误 JSON。