Documentazione API Claude e GPT: chiavi, SDK, client

Una chiave e due base URL compatibili per modelli di produzione, client e API multimediali.

Per un agente AI

Sei bloccato? Passa il compito a un agente AI

Invia il link qui sotto a un qualsiasi agente AI (Claude Code, Codex, Cursor…) e chiedigli di configurare il tuo client: ha tutto ciò che serve a un agente, dalle impostazioni di ogni client fino alla verifica.

Tre passaggi

1. Ottieni una chiave nell'area personale

   Apri l'area personale, ricarica il saldo (o riscatta un codice di marketplace) e premi «Emetti una chiave».

   app.oneprovider.dev Come funziona

2. Scegli il tuo client

   Ogni client ha una sua breve guida.

   • Claude Code
   • Claude Desktop
   • Codex (OpenAI)
   • Cursor
   • Hermes Agent
   • Cline
   • OpenClaw
   • VS Code
   • OpenCode
   • Open Cowork
   • Factory Droid
   • n8n
   • Python SDK
   • Node SDK

3. Imposta la base URL e la chiave

   La chiave va nell'header x-api-key o Authorization: Bearer. L'indirizzo dipende dal tipo di client:

   Anthropic (Claude Code, SDK Anthropic), senza /v1 https://api.oneprovider.dev OpenAI (Codex, Cursor, SDK OpenAI), con /v1 https://api.oneprovider.dev/v1 bash

   curl -s https://api.oneprovider.dev/v1/models \
   -H "Authorization: Bearer sk-your-key-here"

   Se nella risposta compare un elenco di modelli, la chiave funziona.

Avanti

• Modelli e prezzi
• Autenticazione
• Messages API
• Chat Completions
• Area personale e chiavi
• Errori e diagnostica

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 .