Cursor IDE

Connetti il cursore al Model Gate tramite l'API compatibile con OpenAI e gli alias di modello brevi.

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

Aprire Impostazioni del cursore.
Aprire Modelli O Chiavi API, a seconda della versione del cursore installata.
Inserisci la chiave Model Gate nel campo Chiave API OpenAI.
Abilita l'override dell'URL di OpenAI Base.
Imposta l'URL di base su:

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

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.
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 dei costi 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.