模型命名与兼容规则
这篇文档解决什么问题
这篇文档专门回答一个问题:在不同客户端里,到底应该填写哪个模型名。
AIone 网关内部支持一部分兼容 alias,但客户配置时不应该靠猜。文档里给出的都是推荐填写值。
权威来源
请优先以这两个来源为准:
- 实时模型列表:
GET https://api.openbili.com/v1/models - Portal 模型列表页:https://portal.openbili.com/customer/plan
说明:
/v1/models返回的是标准模型 ID 和展示名- 本文给出的表格是“客户实际配置时该填什么”
- 兼容 alias 主要用于历史兼容,不建议作为默认写法
先记住这 4 条规则
- 只有 Cursor 里的 Claude 模型需要优先使用短模型名。
- 除了 Cursor Claude 之外,其他客户端一律优先使用标准模型 ID。
- Claude Code / Anthropic SDK 虽然走 Anthropic 原生协议,但模型名仍然优先填写标准模型 ID。
- 如果你不确定该填什么,先看
/v1/models,再对照本文的“按客户端填写规则”。
按客户端填写规则
| 客户端 / 场景 | 应填写的模型名 |
|---|---|
| Cursor + Claude | 短模型名,例如 opus-4-6、sonnet-4-6、haiku-4-5 |
| Cursor + GPT / Gemini | 标准模型 ID,例如 gpt-5.4、gpt-5.2、gemini-3.1-pro |
| Cline / Continue / OpenAI SDK / OpenAI Compatible 客户端 | 标准模型 ID |
| Claude Code / Anthropic SDK | 标准模型 ID |
Cursor Claude 短模型名对照
如果你在 Cursor 里使用 Claude,优先填写下表左侧的短模型名:
| Cursor Claude 填写值 | 实际对应的标准模型 ID |
|---|---|
opus-4-6 |
claude-opus-4-6 |
sonnet-4-6 |
claude-sonnet-4-6 |
opus-4-5 |
claude-opus-4-5-20251101 |
sonnet-4-5 |
claude-sonnet-4-5-20250929 |
opus-4-1 |
claude-opus-4-1-20250805 |
sonnet-4 |
claude-sonnet-4-20250514 |
haiku-4-5 |
claude-haiku-4-5-20251001 |
补充说明:
- 如果某个 Claude 模型在 Cursor 中没有单独短名,本文会直接把可填写的标准模型 ID 写在 “Cursor Claude 推荐填写” 一列
- 如果某个 Claude 模型没有出现在上表里,优先填写标准模型 ID
完整模型速查表
Claude
| 显示名称 | Cursor Claude 推荐填写 | 标准模型 ID |
|---|---|---|
| Claude Opus 4.6 | opus-4-6 |
claude-opus-4-6 |
| Claude Opus 4.6 Thinking | claude-opus-4-6-thinking |
claude-opus-4-6-thinking |
| Claude Sonnet 4.6 | sonnet-4-6 |
claude-sonnet-4-6 |
| Claude Sonnet 4.6 Thinking | claude-sonnet-4-6-thinking |
claude-sonnet-4-6-thinking |
| Claude Opus 4.5 | opus-4-5 |
claude-opus-4-5-20251101 |
| Claude Opus 4.5 Thinking | claude-opus-4-5-20251101-thinking |
claude-opus-4-5-20251101-thinking |
| Claude Sonnet 4.5 | sonnet-4-5 |
claude-sonnet-4-5-20250929 |
| Claude Sonnet 4.5 Thinking | claude-sonnet-4-5-20250929-thinking |
claude-sonnet-4-5-20250929-thinking |
| Claude Opus 4.1 | opus-4-1 |
claude-opus-4-1-20250805 |
| Claude Opus 4.1 Thinking | claude-opus-4-1-20250805-thinking |
claude-opus-4-1-20250805-thinking |
| Claude Sonnet 4 | sonnet-4 |
claude-sonnet-4-20250514 |
| Claude Sonnet 4 Thinking | claude-sonnet-4-20250514-thinking |
claude-sonnet-4-20250514-thinking |
| Claude Haiku 4.5 | haiku-4-5 |
claude-haiku-4-5-20251001 |
| Claude Haiku 4.5 Thinking | claude-haiku-4-5-20251001-thinking |
claude-haiku-4-5-20251001-thinking |
| Claude 3.5 Sonnet | claude-3-5-sonnet-20241022 |
claude-3-5-sonnet-20241022 |
| Claude 3.5 Sonnet (Jun 2024) | claude-3-5-sonnet-20240620 |
claude-3-5-sonnet-20240620 |
| Claude 3.5 Haiku | claude-3-5-haiku-20241022 |
claude-3-5-haiku-20241022 |
| Claude 3 Haiku | claude-3-haiku-20240307 |
claude-3-haiku-20240307 |
| Claude 3 Sonnet | claude-3-sonnet-20240229 |
claude-3-sonnet-20240229 |
GPT / OpenAI
以下模型在 Cursor、Cline、Continue、OpenAI SDK 等客户端中都直接填写标准模型 ID:
| 显示名称 | 标准模型 ID |
|---|---|
| GPT-5 | gpt-5 |
| GPT-5 Chat Latest | gpt-5-chat-latest |
| GPT-5 Mini | gpt-5-mini |
| GPT-5 Nano | gpt-5-nano |
| GPT-5.1 | gpt-5.1 |
| GPT-5.2 | gpt-5.2 |
| GPT-5.4 | gpt-5.4 |
| GPT-4.1 | gpt-4.1 |
| GPT-4.1 Mini | gpt-4.1-mini |
| GPT-4.1 Nano | gpt-4.1-nano |
| GPT-4.5 Preview | gpt-4.5-preview |
| GPT-4o | gpt-4o |
| GPT-4o Audio | gpt-4o-audio-preview |
| GPT-4o Mini | gpt-4o-mini |
| GPT-4o Mini Realtime | gpt-4o-mini-realtime-preview |
| GPT-4o Realtime | gpt-4o-realtime-preview |
| GPT-4 Turbo | gpt-4-turbo |
| GPT-4 | gpt-4 |
| GPT-4 32K | gpt-4-32k |
| GPT-4 Vision | gpt-4-vision-preview |
| GPT-3.5 Turbo | gpt-3.5-turbo |
| GPT-3.5 Turbo 16K | gpt-3.5-turbo-16k |
| GPT-3.5 Turbo Instruct | gpt-3.5-turbo-instruct |
| GPT Image 1 | gpt-image-1 |
Gemini
以下模型在 Cursor、Cline、Continue、OpenAI SDK 等客户端中都直接填写标准模型 ID:
| 显示名称 | 标准模型 ID |
|---|---|
| Gemini 2.5 Pro | gemini-2.5-pro |
| Gemini 2.5 Flash | gemini-2.5-flash |
| Gemini 2.5 Flash (No Thinking) | gemini-2.5-flash-nothinking |
| Gemini 2.5 Flash Image | gemini-2.5-flash-image |
| Gemini 2.5 Flash Lite | gemini-2.5-flash-lite |
| Gemini 3 Pro Preview | gemini-3-pro-preview |
| Gemini 3 Pro Image | gemini-3-pro-image-preview |
| Gemini 3 Pro Image 2K | gemini-3-pro-image-preview-2k |
| Gemini 3 Pro Image 4K | gemini-3-pro-image-preview-4k |
| Gemini 3 Flash Preview | gemini-3-flash-preview |
| Gemini 3.1 Pro | gemini-3.1-pro |
| Gemini 3.1 Pro Preview | gemini-3.1-pro-preview |
| Gemini 3.1 Pro Custom Tools | gemini-3.1-pro-preview-customtools |
| Gemini 3.1 Flash Image | gemini-3.1-flash-image-preview |
| Gemini 3.1 Flash Lite | gemini-3.1-flash-lite-preview |
如何自己核对模型名
方法 1:查 /v1/models
curl https://api.openbili.com/v1/models \
-H "Authorization: Bearer sk-nex-your-key-here"你会拿到标准模型 ID 列表。除了 Cursor 里的 Claude 之外,其他客户端都优先直接使用这些 ID。
方法 2:查 Portal 模型列表页
进入 https://portal.openbili.com/customer/plan 查看当前模型列表。
常见误区
- 不要把 Cursor Claude 的短模型名规则套用到其他客户端
- 不要默认把所有兼容 alias 都当成推荐写法
- 不要手动把 Claude Code 的模型名改成 Cursor 短名
- 如果文档和
/v1/models看起来不一致,请以/v1/models和 Portal 实时页面为准