模型命名与兼容规则

这篇文档解决什么问题

这篇文档专门回答一个问题:在不同客户端里,到底应该填写哪个模型名。

AIone 网关内部支持一部分兼容 alias,但客户配置时不应该靠猜。文档里给出的都是推荐填写值

权威来源

请优先以这两个来源为准:

说明:

  • /v1/models 返回的是标准模型 ID 和展示名
  • 本文给出的表格是“客户实际配置时该填什么”
  • 兼容 alias 主要用于历史兼容,不建议作为默认写法

先记住这 4 条规则

  1. 只有 Cursor 里的 Claude 模型需要优先使用短模型名。
  2. 除了 Cursor Claude 之外,其他客户端一律优先使用标准模型 ID。
  3. Claude Code / Anthropic SDK 虽然走 Anthropic 原生协议,但模型名仍然优先填写标准模型 ID。
  4. 如果你不确定该填什么,先看 /v1/models,再对照本文的“按客户端填写规则”。

按客户端填写规则

客户端 / 场景 应填写的模型名
Cursor + Claude 短模型名,例如 opus-4-6sonnet-4-6haiku-4-5
Cursor + GPT / Gemini 标准模型 ID,例如 gpt-5.4gpt-5.2gemini-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 实时页面为准