Skip to content

端点与鉴权

生产 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_KEY

WARNING

不要把 API Key 放在 URL 查询参数中。?key=?api_key= 已被视为不安全用法,网关会拒绝。

支持的入口

协议端点说明
OpenAI ResponsesPOST /v1/responses推荐给 Codex CLI 和新 OpenAI SDK。
OpenAI Responses aliasPOST /responses兼容部分客户端。
OpenAI Chat CompletionsPOST /v1/chat/completions兼容传统 OpenAI 客户端。
Anthropic MessagesPOST /v1/messages兼容 Claude Code 和 Anthropic SDK。
Anthropic Count TokensPOST /v1/messages/count_tokens仅支持具备该能力的分组和渠道。
ModelsGET /v1/models返回当前 Key 可用模型。
UsageGET /v1/usage查询当前 Key 用量。
Gemini ModelsGET /v1beta/models兼容 Gemini SDK/CLI。
Gemini GeneratePOST /v1beta/models/{model}:generateContentGemini 非流式生成。
Gemini StreamPOST /v1beta/models/{model}:streamGenerateContent?alt=sseGemini SSE 流式生成。

分组与端点匹配

普通分组通常只对应一个协议。Mixed 分组可以按入口协议把请求路由到不同来源。

请求入口普通分组要求Mixed 分组行为
/v1/responsesOpenAI 分组openai_responses 规则选择来源
/v1/chat/completionsOpenAI 分组openai_chat_completions 规则选择来源
/v1/messagesAnthropic 分组anthropic_messages 规则选择来源
/v1beta/*Gemini 分组gemini_v1beta 规则选择来源

请求 ID

建议客户端传入稳定的请求 ID,便于排查:

http
x-request-id: your-request-id

响应错误中也可能包含网关生成的 request id。向支持反馈问题时,请提供:

  • 请求时间。
  • API Key 名称或末尾 4 位。
  • 模型名。
  • 端点。
  • request id。
  • 完整错误 JSON。

Enodot 提供 AI API 接入管理与开发者网关服务。