AIone API (English)
    • 01 - Quick Start
    • 02 - Authentication
    • 03 - Error Codes
    • 04 - Pricing
    • 05 - Contact Us
    • 06 - Quality of Service
    • 07 - Complete Examples
    • 08 - Caching & Cost Optimization
    • 11 - Model Quality Monitoring
    • 12 - Network & Connectivity
    • 13 - Model Naming & Compatibility
    • 14 - Gemini Image Generation
    • 09 - Model Verification
    • 10 - IDE Integration

    13 - Model Naming & Compatibility

    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:
    Real-time model list: GET https://api.nexara.net/v1/models
    Portal model list page: https://portal.nexara.net/customer/plan
    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 / ScenarioModel Name to Use
    Cursor + ClaudeShort name, e.g., opus-4-6, sonnet-4-6, haiku-4-5
    Cursor + GPT / GeminiStandard model ID, e.g., gpt-5.4, gpt-5.2, gemini-3.1-pro
    Cline / Continue / OpenAI SDK / OpenAI-compatible clientsStandard model ID
    Claude Code / Anthropic SDKStandard model ID

    Cursor Claude Short Name Mapping#

    When using Claude models in Cursor, use the short name from the left column:
    Cursor Claude ValueCorresponding Standard Model 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
    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 NameCursor Claude RecommendedStandard Model 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#

    The following models use the standard model ID across all clients (Cursor, Cline, Continue, OpenAI SDK, etc.):
    Display NameStandard Model 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#

    The following models use the standard model ID across all clients (Cursor, Cline, Continue, OpenAI SDK, etc.):
    Display NameStandard Model 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

    How to Verify Model Names Yourself#

    Method 1: Query /v1/models#

    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.nexara.net/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
    Modified at 2026-04-04 16:04:15
    Previous
    12 - Network & Connectivity
    Next
    14 - Gemini Image Generation
    Built with