AIin1Portal

Model Naming & Compatibility Rules

What This Guide Covers

This guide answers one specific question: What model name should you enter in each client?

The AIone gateway supports a number of compatibility aliases internally, but you should not have to guess. This document provides the recommended values for every scenario.

Authoritative Sources

Always refer to these two sources first:

Notes:

  • /v1/models returns standard model IDs and display names
  • The tables in this guide show "what to actually enter in each client"
  • Compatibility aliases exist primarily for backward compatibility and are not recommended as default values

4 Rules to Remember

  1. Only Claude models in Cursor need the short model name format.
  2. For all other clients, always use the standard model ID.
  3. Claude Code / Anthropic SDK uses the Anthropic native protocol, but the model name should still be the standard model ID.
  4. When in doubt, check /v1/models first, then cross-reference with the client-specific rules below.

Client-Specific Rules

Client / Scenario Model Name to Use
Cursor + Claude Short name, e.g., opus-4-6, sonnet-4-6, haiku-4-5
Cursor + GPT / Gemini Standard model ID, e.g., gpt-5.4, gpt-5.2, gemini-3.1-pro
Cline / Continue / OpenAI SDK / OpenAI-compatible clients Standard model ID
Claude Code / Anthropic SDK Standard model ID

Cursor Claude Short Name Mapping

When using Claude models in Cursor, use the short name from the left column:

Cursor Claude Value Corresponding Standard Model 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

Additional notes:

  • If a Claude model does not have a dedicated short name, the standard model ID is listed in the "Cursor Claude Recommended" column instead
  • If a Claude model is not listed above, use the standard model ID

Complete Model Reference

Claude

Display Name Cursor Claude Recommended Standard Model 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

The following models use the standard model ID across all clients (Cursor, Cline, Continue, OpenAI SDK, etc.):

Display Name Standard Model 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

The following models use the standard model ID across all clients (Cursor, Cline, Continue, OpenAI SDK, etc.):

Display Name Standard Model 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

How to Verify Model Names Yourself

Method 1: Query /v1/models

curl https://api.portal.aiin1.ai/v1/models \
  -H "Authorization: Bearer sk-nex-your-key-here"

This returns the standard model ID list. Except for Claude models in Cursor, all other clients should use these IDs directly.

Method 2: Check the Portal Model List

Visit https://portal.aiin1.ai/customer/plan to see the current model list.

Common Mistakes to Avoid

  • Do not apply the Cursor Claude short name convention to other clients
  • Do not assume all compatibility aliases are the recommended way to specify models
  • Do not manually change Claude Code model names to Cursor short names
  • If this document and /v1/models appear inconsistent, trust /v1/models and the Portal real-time page