Skip to content

模型与分组

Enodot 的 API Key 会绑定到一个分组。分组决定三件事:

  • 这个 Key 能使用哪种 API 协议:OpenAI、Anthropic、Gemini 或 Mixed 聚合。
  • 这个 Key 调用 /v1/models/v1beta/models 时能看到哪些模型。
  • 这个 Key 的计费倍率。

实际使用时请记住一条规则:模型列表所见即所得。你的 Key 调用模型列表接口返回什么模型,就填写什么模型名;没有返回的模型不要手动填进客户端。Claude 系列在文档里按统一模型名展示;日期名、小数写法和 -thinking 写法会归并到同一个模型档位。

生产地址

text
https://ai.enodot.shop

常见 Base URL:

协议Base URL适合客户端
OpenAIhttps://ai.enodot.shop/v1Codex CLI/Desktop、OpenAI SDK、OpenAI Compatible 客户端
Anthropichttps://ai.enodot.shopClaude Code、Claude Desktop、Anthropic SDK、CC-Switch
Geminihttps://ai.enodot.shop/v1betaGemini CLI、Gemini SDK

先查看你的模型

OpenAI 分组或 Mixed 分组:

bash
curl https://ai.enodot.shop/v1/models \
  -H "Authorization: Bearer $ENODOT_API_KEY"

Anthropic 分组:

bash
curl https://ai.enodot.shop/v1/models \
  -H "x-api-key: $ENODOT_API_KEY" \
  -H "anthropic-version: 2023-06-01"

Gemini 分组:

bash
curl https://ai.enodot.shop/v1beta/models \
  -H "x-goog-api-key: $ENODOT_API_KEY"

如果接口返回空列表或报错,说明当前 Key 暂时没有可见模型,客户端里也不应该手动填写模型名。

当前分组

下表按当前线上 /v1/models/v1beta/models 返回值整理。不同用户的 Key 如果绑定不同分组,以自己的 Key 实时返回为准。

分组协议倍率当前可见模型数主要用途
OpenAI 官方渠道OpenAI0.20007Codex、OpenAI SDK、OpenAI Compatible 客户端
Claude 官方渠道Anthropic2.000011Claude Code、Claude Desktop、Anthropic SDK
Claude KiroAnthropic0.300018Anthropic 兼容格式的 Claude/Kiro 模型
默认聚合路由Mixed按入口决定7一把 Key 按入口协议路由到对应来源
Gemini 官方渠道Gemini0.500010Gemini CLI、Gemini SDK、Gemini 原生客户端

OpenAI 官方渠道

倍率:0.2000

可用入口:

text
POST /v1/responses
POST /responses
POST /v1/chat/completions
GET  /v1/models

当前 /v1/models 可见 OpenAI 模型按统一模型名聚合;gpt-5.4-2026-03-05gpt-5.4 同价,合并展示为 gpt-5.4

类型模型建议入口
GPT 文本gpt-5.4-mini/v1/responses
GPT 文本gpt-5.4/v1/responses
GPT 文本gpt-5.5/v1/responses
Codexcodex-auto-review/v1/responses
图片生成gpt-image-1/v1/images/generations
图片生成gpt-image-1.5/v1/images/generations
图片生成gpt-image-2/v1/images/generations

OpenAI 客户端的最小测试:

bash
curl https://ai.enodot.shop/v1/responses \
  -H "Authorization: Bearer $ENODOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "hi",
    "max_output_tokens": 64
  }'

Claude 官方渠道

倍率:2.0000

可用入口:

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

当前 /v1/models 可见 Claude 模型按统一模型名聚合;日期版本名按同一模型档位计费,例如 claude-opus-4-5-20251101 归入 claude-opus-4-5

系列模型类型建议入口
Opusclaude-opus-4文本 / 视觉/v1/messages
Opusclaude-opus-4-1文本 / 视觉/v1/messages
Opusclaude-opus-4-5文本 / 视觉/v1/messages
Opusclaude-opus-4-6文本 / 视觉/v1/messages
Opusclaude-opus-4-7文本 / 视觉/v1/messages
Opusclaude-opus-4-8文本 / 视觉/v1/messages
Sonnetclaude-sonnet-4文本 / 视觉/v1/messages
Sonnetclaude-sonnet-4-5文本 / 视觉/v1/messages
Sonnetclaude-sonnet-4-6文本 / 视觉/v1/messages
Haikuclaude-haiku-4-5文本 / 视觉/v1/messages

claude-opus-4claude-opus-4-1 是高价旧 Opus 档,官方定价明显偏高。常规使用建议优先选 Opus 4.8/4.7/4.6/4.5 或 Sonnet 4.6,避免无意间把长上下文任务跑到高价旧档上。

Anthropic 客户端的最小测试:

bash
curl https://ai.enodot.shop/v1/messages \
  -H "x-api-key: $ENODOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 64,
    "messages": [
      {
        "role": "user",
        "content": "hi"
      }
    ]
  }'

Claude Kiro

倍率:0.3000

可用入口:

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

当前 /v1/models 可见 Kiro 模型按统一模型名聚合。日期名、小数写法和 -thinking 写法都归入同一个模型档位,例如 claude-opus-4-5-20251101claude-opus-4.5claude-opus-4.5-thinking 都合并为 claude-opus-4-5

系列模型类型
Opusclaude-opus-4-5文本 / 视觉
Opusclaude-opus-4-6文本 / 视觉
Opusclaude-opus-4-7文本 / 视觉
Opusclaude-opus-4-8文本 / 视觉
Sonnetclaude-sonnet-4文本 / 视觉
Sonnetclaude-sonnet-4-5文本 / 视觉
Sonnetclaude-sonnet-4-6文本 / 视觉
Haikuclaude-haiku-4-5文本 / 视觉

-thinking 后缀表示启用 thinking 模式。它仍然使用同一类模型计费,只是输出中可能包含更多推理内容,实际 token 用量可能更高。

默认聚合路由

默认聚合路由 是 Mixed 分组。它不是一个新的模型来源,而是按请求入口分发到真实协议分组。

当前配置:

入口协议入口端点来源分组来源倍率聚合附加倍率最终倍率
OpenAI/v1/responses

/responses

/v1/chat/completions
OpenAI 官方渠道0.20001.00000.2000
Anthropic/v1/messages

/v1/messages/count_tokens
Claude 官方渠道2.00001.00002.0000
Gemini/v1beta/*Gemini 官方渠道0.50001.00000.5000

当前 Mixed Key 调用 /v1/models 可见模型:

系列模型实际入口最终倍率
Opusclaude-opus-4-5Anthropic /v1/messages2.0000
Opusclaude-opus-4-6Anthropic /v1/messages2.0000
Opusclaude-opus-4-7Anthropic /v1/messages2.0000
Opusclaude-opus-4-8Anthropic /v1/messages2.0000
Sonnetclaude-sonnet-4-5Anthropic /v1/messages2.0000
Sonnetclaude-sonnet-4-6Anthropic /v1/messages2.0000
Haikuclaude-haiku-4-5Anthropic /v1/messages2.0000

Mixed Key 的使用重点是:先用这个 Key 查询 /v1/models,再按返回的模型选择对应协议客户端。没有出现在列表里的模型,不建议手动填写。

Gemini 官方渠道

倍率:0.5000

Gemini 使用原生 Gemini 入口:

text
GET  /v1beta/models
POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{model}:streamGenerateContent?alt=sse

当前 /v1beta/models 可见模型:

类型模型建议入口
Flash 文本models/gemini-2.0-flash/v1beta/models/{model}:generateContent
Flash 文本models/gemini-2.5-flash/v1beta/models/{model}:generateContent
Flash 文本models/gemini-3-flash-preview/v1beta/models/{model}:generateContent
Flash 文本models/gemini-3.5-flash/v1beta/models/{model}:generateContent
Pro 文本 / 多模态models/gemini-2.5-pro/v1beta/models/{model}:generateContent
Pro 文本 / 多模态models/gemini-3-pro-preview/v1beta/models/{model}:generateContent
Pro 文本 / 多模态models/gemini-3.1-pro-preview/v1beta/models/{model}:generateContent
Pro 文本 / 多模态models/gemini-3.1-pro-preview-customtools/v1beta/models/{model}:generateContent
图片 / 多模态models/gemini-2.5-flash-image/v1beta/models/{model}:generateContent
图片 / 多模态models/gemini-3.1-flash-image/v1beta/models/{model}:generateContent

Gemini 模型名通常带 models/ 前缀。客户端如果要求只填写短模型名,可以去掉前缀,例如把 models/gemini-2.5-pro 填成 gemini-2.5-pro;如果客户端直接使用原生 REST 路径,则按返回值拼接路径。

使用 Gemini CLI 或 Gemini SDK 前,建议先运行:

bash
curl https://ai.enodot.shop/v1beta/models \
  -H "x-goog-api-key: $ENODOT_API_KEY"

如果返回模型列表,再把返回的模型名填到客户端里。

选择建议

你的用途推荐分组
Codex CLI / DesktopOpenAI 官方渠道
OpenAI SDK / OpenAI Compatible 应用OpenAI 官方渠道
Claude Code / Claude DesktopClaude Kiro 或 Claude 官方渠道
想要低倍率 Claude 兼容调用Claude Kiro
想要官方 Claude 来源Claude 官方渠道
一个 Key 同时给多种协议客户端使用默认聚合路由,并先确认 /v1/models 返回
Gemini CLI / SDKGemini 官方渠道

常见错误

现象原因处理
model_not_found当前 Key 的 /v1/models 没有这个模型换成模型列表里返回的模型名
model_not_entitled当前 Key 或来源账号没有该模型权限换模型或换分组
401Key 填错、过期或请求头写错检查 Authorization: Bearer / x-api-key / x-goog-api-key
404Base URL 或路径写错OpenAI SDK 使用 /v1,Anthropic SDK 不要在 Base URL 后手动加 /v1
429当前模型或来源繁忙稍后重试,或换列表中的其他模型

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