1. 引言
AIone API
  • 引言
    • 快速开始
    • 认证方式
    • 错误码说明
    • 定价说明
    • 联系我们
    • 服务质量保障
    • 完整请求案例
    • 关于缓存与成本优化
    • 模型质量监控与保障
    • 关于模型真实性验证
    • 在IDE中使用AIone
    • 网络与连接说明
    • 模型命名与兼容规则
    • Gemini 图片生成
  • 聊天(Chat)
    • 基础文本对话
      POST
    • 流式响应
      POST
  • 模型(Models)
    • 获取模型列表
      GET
    • List Models
      GET
  • API Key 管理
    • List Keys
      GET
    • Create Key
      POST
    • Get Key
      GET
    • Update Key
      PUT
    • Delete Key
      DELETE
    • Rotate Key
      PUT
    • Disable Key
      PUT
    • Enable Key
      PUT
  • 用量统计
    • Query Usage
    • Get Dashboard
  • 账单
    • Get Current Plan
    • Get Billing Account
    • List Invoices
  • 数据模型
    • HTTPValidationError
    • DashboardResponse
    • KeyCreateRequest
    • KeyListResponse
    • PlanDetailResponse
    • ModelListResponse
    • KeyResponse
    • InvoiceListResponse
    • KeyRotateResponse
    • BillingAccountResponse
    • UsageRow
    • KeyUpdateRequest
    • ValidationError
    • TechDashboardData
    • ModelInfo
    • BusinessDashboardData
    • DailyTrend
    • TeamCostItem
    • ModelDistribution
  1. 引言

模型命名与兼容规则

模型命名与兼容规则#

这篇文档解决什么问题#

这篇文档专门回答一个问题:在不同客户端里,到底应该填写哪个模型名。
AIone 网关内部支持一部分兼容 alias,但客户配置时不应该靠猜。文档里给出的都是推荐填写值。

权威来源#

请优先以这两个来源为准:
实时模型列表:GET https://api.nexara.net/v1/models
Portal 模型列表页:https://portal.nexara.net/customer/plan
说明:
/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-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-6claude-opus-4-6
sonnet-4-6claude-sonnet-4-6
opus-4-5claude-opus-4-5-20251101
sonnet-4-5claude-sonnet-4-5-20250929
opus-4-1claude-opus-4-1-20250805
sonnet-4claude-sonnet-4-20250514
haiku-4-5claude-haiku-4-5-20251001
补充说明:
如果某个 Claude 模型在 Cursor 中没有单独短名,本文会直接把可填写的标准模型 ID 写在 “Cursor Claude 推荐填写” 一列
如果某个 Claude 模型没有出现在上表里,优先填写标准模型 ID

完整模型速查表#

Claude#

显示名称Cursor Claude 推荐填写标准模型 ID
Claude Opus 4.6opus-4-6claude-opus-4-6
Claude Opus 4.6 Thinkingclaude-opus-4-6-thinkingclaude-opus-4-6-thinking
Claude Sonnet 4.6sonnet-4-6claude-sonnet-4-6
Claude Sonnet 4.6 Thinkingclaude-sonnet-4-6-thinkingclaude-sonnet-4-6-thinking
Claude Opus 4.5opus-4-5claude-opus-4-5-20251101
Claude Opus 4.5 Thinkingclaude-opus-4-5-20251101-thinkingclaude-opus-4-5-20251101-thinking
Claude Sonnet 4.5sonnet-4-5claude-sonnet-4-5-20250929
Claude Sonnet 4.5 Thinkingclaude-sonnet-4-5-20250929-thinkingclaude-sonnet-4-5-20250929-thinking
Claude Opus 4.1opus-4-1claude-opus-4-1-20250805
Claude Opus 4.1 Thinkingclaude-opus-4-1-20250805-thinkingclaude-opus-4-1-20250805-thinking
Claude Sonnet 4sonnet-4claude-sonnet-4-20250514
Claude Sonnet 4 Thinkingclaude-sonnet-4-20250514-thinkingclaude-sonnet-4-20250514-thinking
Claude Haiku 4.5haiku-4-5claude-haiku-4-5-20251001
Claude Haiku 4.5 Thinkingclaude-haiku-4-5-20251001-thinkingclaude-haiku-4-5-20251001-thinking
Claude 3.5 Sonnetclaude-3-5-sonnet-20241022claude-3-5-sonnet-20241022
Claude 3.5 Sonnet (Jun 2024)claude-3-5-sonnet-20240620claude-3-5-sonnet-20240620
Claude 3.5 Haikuclaude-3-5-haiku-20241022claude-3-5-haiku-20241022
Claude 3 Haikuclaude-3-haiku-20240307claude-3-haiku-20240307
Claude 3 Sonnetclaude-3-sonnet-20240229claude-3-sonnet-20240229

GPT / OpenAI#

以下模型在 Cursor、Cline、Continue、OpenAI SDK 等客户端中都直接填写标准模型 ID:
显示名称标准模型 ID
GPT-5gpt-5
GPT-5 Chat Latestgpt-5-chat-latest
GPT-5 Minigpt-5-mini
GPT-5 Nanogpt-5-nano
GPT-5.1gpt-5.1
GPT-5.2gpt-5.2
GPT-5.4gpt-5.4
GPT-4.1gpt-4.1
GPT-4.1 Minigpt-4.1-mini
GPT-4.1 Nanogpt-4.1-nano
GPT-4.5 Previewgpt-4.5-preview
GPT-4ogpt-4o
GPT-4o Audiogpt-4o-audio-preview
GPT-4o Minigpt-4o-mini
GPT-4o Mini Realtimegpt-4o-mini-realtime-preview
GPT-4o Realtimegpt-4o-realtime-preview
GPT-4 Turbogpt-4-turbo
GPT-4gpt-4
GPT-4 32Kgpt-4-32k
GPT-4 Visiongpt-4-vision-preview
GPT-3.5 Turbogpt-3.5-turbo
GPT-3.5 Turbo 16Kgpt-3.5-turbo-16k
GPT-3.5 Turbo Instructgpt-3.5-turbo-instruct
GPT Image 1gpt-image-1

Gemini#

以下模型在 Cursor、Cline、Continue、OpenAI SDK 等客户端中都直接填写标准模型 ID:
显示名称标准模型 ID
Gemini 2.5 Progemini-2.5-pro
Gemini 2.5 Flashgemini-2.5-flash
Gemini 2.5 Flash (No Thinking)gemini-2.5-flash-nothinking
Gemini 2.5 Flash Imagegemini-2.5-flash-image
Gemini 2.5 Flash Litegemini-2.5-flash-lite
Gemini 3 Pro Previewgemini-3-pro-preview
Gemini 3 Pro Imagegemini-3-pro-image-preview
Gemini 3 Pro Image 2Kgemini-3-pro-image-preview-2k
Gemini 3 Pro Image 4Kgemini-3-pro-image-preview-4k
Gemini 3 Flash Previewgemini-3-flash-preview
Gemini 3.1 Progemini-3.1-pro
Gemini 3.1 Pro Previewgemini-3.1-pro-preview
Gemini 3.1 Pro Custom Toolsgemini-3.1-pro-preview-customtools
Gemini 3.1 Flash Imagegemini-3.1-flash-image-preview
Gemini 3.1 Flash Litegemini-3.1-flash-lite-preview

如何自己核对模型名#

方法 1:查 /v1/models#

你会拿到标准模型 ID 列表。除了 Cursor 里的 Claude 之外,其他客户端都优先直接使用这些 ID。

方法 2:查 Portal 模型列表页#

进入 https://portal.nexara.net/customer/plan 查看当前模型列表。

常见误区#

不要把 Cursor Claude 的短模型名规则套用到其他客户端
不要默认把所有兼容 alias 都当成推荐写法
不要手动把 Claude Code 的模型名改成 Cursor 短名
如果文档和 /v1/models 看起来不一致,请以 /v1/models 和 Portal 实时页面为准
修改于 2026-04-01 23:36:07
上一页
网络与连接说明
下一页
Gemini 图片生成
Built with