Cursor

Usa l'Override OpenAI Base URL di Cursor per eseguire in Ask e Agent i modelli GPT del catalogo di OneProvider.

Editor di codice con IA Cursor

Cosa funziona

Le richieste Ask e Agent per gli ID dei modelli GPT che aggiungi passano da OneProvider, comprese le richieste ApplyPatch in streaming. Cursor invia queste richieste dai propri server, quindi funziona solo l'endpoint pubblico; Cursor controlla comunque il proprio runtime degli agenti e le funzioni ospitate specializzate.

Limite del client

Serve un piano Cursor a pagamento (Pro o superiore): da gennaio 2026 Cursor ignora le tue chiavi sul piano Free. L'override è globale: finché è attivo, ogni modello tranne quelli Anthropic e Google, compresi i modelli GPT, Composer e Grok di Cursor, viene inviato a OneProvider, quindi disattivalo per usare di nuovo i modelli di Cursor. Gli ID Anthropic/Claude e Google integrati non usano mai l'override, e il completamento con Tab e le funzioni ospitate da Cursor mantengono il loro normale instradamento.

Configurazione

1. Aggiorna Cursor e prepara una chiave dedicata

   Usa l'ultima versione stabile di Cursor con un piano Pro o superiore. Crea una chiave OneProvider dedicata, limitane i modelli e la spesa e ricarica il saldo prima della verifica.

2. Attiva l'OpenAI API Key

   Apri Cursor Settings → Models → API Keys (Impostazioni di Cursor → Modelli → Chiavi API), incolla la chiave OneProvider dedicata in OpenAI API Key e accendi il suo interruttore: incollare solo la chiave non la attiva.

   OpenAI API Key: sk-your-key-here

3. Sostituisci la base URL di OpenAI

   Attiva Override OpenAI Base URL (Sostituisci la base URL di OpenAI) e inserisci esattamente https://api.oneprovider.dev/v1: con /v1 e senza /chat/completions; il percorso lo aggiunge Cursor stesso. Cursor richiede un ID di modello OpenAI compatibile; scegli dal catalogo un ID di modello di testo GPT (un modello di immagini non funziona nella chat).

   Override OpenAI Base URL: https://api.oneprovider.dev/v1

4. Salva e seleziona un modello compatibile

   Salva la chiave OpenAI e la base URL. Aggiungi come modello personalizzato l'ID compatibile che hai scelto, se non è nell'elenco, poi esegui una nuova richiesta Ask o Agent. Gli ID dei modelli Claude e Google non passano da questo override. Disattiva l'override quando vuoi tornare al normale instradamento OpenAI di Cursor.

Verifica la connessione

Controlla la richiesta nella tua Dashboard

La richiesta dovrebbe mostrare gpt-6.1-terra, l'endpoint compatibile con OpenAI, il consumo di token e l'importo addebitato. Se invece Cursor mostra un errore:

"does not work with your current plan or api key" → piano Free, oppure l'interruttore OpenAI API Key è spento
"Model name is not valid" → accendi l'interruttore OpenAI API Key e avvia una nuova chat
404 / "Invalid URL" → la base URL deve essere esattamente https://api.oneprovider.dev/v1
401 → chiave OneProvider sbagliata, revocata o senza saldo
"model … is not available" → l'ID del modello non è nel catalogo di OneProvider
I modelli di Cursor non funzionano → disattiva Override OpenAI Base URL mentre li usi

Dati di connessione

Protocollo

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Sicurezza della chiave

Cursor compone le richieste tramite un proprio servizio, quindi non limitare la chiave all'IP della tua postazione. Meglio una chiave dedicata con controlli su modelli, frequenza, spesa, scadenza e ambito.

Quale modello scegliere

L'override trasporta solo ID di modelli in stile OpenAI, quindi scegli un modello di testo GPT. gpt-6.1-terra è la scelta predefinita bilanciata per Ask e Agent. gpt-6.1-sol è il livello di punta per attività difficili su più file, e gpt-5.6-luna è il livello economico per domande rapide. Aggiungi l'ID che hai scelto come modello personalizzato, esattamente come scritto nel catalogo . Gli ID Claude non passano mai da questo override: per usare Claude, esegui Claude Code accanto a Cursor.

Errori comuni e soluzioni

«Model name is not valid»

L'interruttore OpenAI API Key è spento oppure il modello è stato aggiunto prima di accenderlo. Accendi l'interruttore, salva e avvia una nuova chat.

«Does not work with your current plan or api key»

Sei sul piano Free, oppure l'interruttore è spento. Cursor ignora le tue chiavi sul piano Free; serve Pro o superiore.

404 o «Invalid URL»

Inserisci https://api.oneprovider.dev/v1 esattamente: con /v1, senza /chat/completions. Il percorso lo aggiunge Cursor.

401

La chiave è sbagliata, revocata oppure il saldo è a zero. Incolla la chiave intera senza spazi e ricarica l'area personale.

I modelli di Cursor non funzionano mentre l'override è attivo

L'override è globale: ogni modello che non sia Anthropic o Google va a OneProvider. Disattiva Override OpenAI Base URL per usare di nuovo i modelli di Cursor.

Le richieste non compaiono nella mia Dashboard

Il modello che hai usato è di Claude o di Google, oppure l'override è spento. Scegli l'ID GPT che hai aggiunto ed esegui una nuova richiesta Ask o Agent.

FAQ

Il completamento con Tab ne risente?

No. Tab e le funzioni ospitate da Cursor mantengono il loro normale instradamento.

Posso limitare la chiave al mio IP?

No. Cursor invia le richieste dai propri server, quindi una lista di IP consentiti le bloccherebbe. Usa invece limiti per modello, frequenza e spesa.

Posso usare i modelli Claude in Cursor tramite OneProvider?

Non con questo override. Per Claude usa Claude Code o Cline .

Come torno indietro?

Disattiva Override OpenAI Base URL. Le altre impostazioni restano.

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .