Cursor IDE attraverso il Portale Modello

Il cursore utilizza l'endpoint compatibile con OpenAI:

https://api.model-gate.com/v1

1. Crea una chiave API

Aprire https://panel.model-gate.com/en/api-keys, crea una chiave e copiala immediatamente.

2. Configurare il cursore

1. Apri Impostazioni del cursore. 2. Apri Modelli O Chiavi API, a seconda della versione del cursore installata. 3. Immettere la chiave Model Gate nel campo Chiave API OpenAI. 4. Abilita la sostituzione dell'URL di OpenAI Base. 5. Imposta l'URL di base su:

https://api.model-gate.com/v1

6. Aggiungi un modello personalizzato utilizzando un breve alias Model Gate. Il cursore può rifiutare o riscrivere gli ID modello canonici completi, quindi utilizzare un alias come ch-47 invece di claude-opus-4.7. 7. Verifica la configurazione e avvia una nuova chat.

Le chiavi API personalizzate nel cursore si applicano alle funzionalità del modello di chat standard. Le funzionalità specializzate ospitate dal cursore possono continuare a utilizzare l'infrastruttura del cursore.

Alias ​​del modello

In Cursore, specificare ad esempio l'alias del modello ch-47, anziché l'ID del modello originale come claude-opus-4.7. Il cursore può rifiutare o riscrivere nomi di modelli completi a causa delle restrizioni interne sui nomi di modello. Model Gate supporta quindi gli alias gestiti dall'amministratore.

Gli alias attualmente abilitati sono elencati di seguito:

Alias	Model
ch-46	claude-opus-4-6
ch-46s	claude-sonnet-4-6
ch-47	claude-opus-4-7
ch-48	claude-opus-4-8
ch-g54	gpt-5.4

Esempio:

Cursor model: ch-47
Resolved model: claude-opus-4.7

Model Gate risolve l'alias prima:

- verifiche disponibilità modelli; - prezzi utente e ufficiali; - calcolo del costo di utilizzo; - accodamento asincrono; - consegna a monte; - archiviazione della cronologia delle richieste.

La risposta upstream può contenere l'ID del modello canonico.

Verificare il cursore esterno

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch-47",
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }'

Risoluzione dei problemi

Problema	Risoluzione
Il cursore rifiuta un ID modello lungo	Utilizza un alias breve abilitato mostrato da /v1/models.
L'autenticazione fallisce	Reinserire la chiave Model Gate e verificarla con curl.
Le richieste non raggiungono Model Gate	Conferma che l'URL di base include /v1.
Il modello non è stato trovato	L'alias può essere disabilitato o mappato su un modello disabilitato.
Una funzionalità del cursore ignora l'API personalizzata	Testare un modello di chat standard; non tutte le funzionalità ospitate dal cursore supportano chiavi API personalizzate.

Documentazione attuale della chiave API del cursore: https://docs.cursor.com/settings/api-keys.