Autenticazione

OneProvider accetta sia il Bearer in stile OpenAI sia x-api-key in stile Anthropic. Usa uno dei due, mai entrambi.

Forme degli header

L'API accetta l'uno o l'altro header. Usa quello che il tuo SDK già invia.

Authorization: Bearer sk-... # OpenAI-style
x-api-key: sk-... # Anthropic-style

Variabili d'ambiente

I nostri esempi tengono la chiave in ONEPROVIDER_KEY. I client SDK, però, leggono per impostazione predefinita i propri nomi nativi: o esporti la chiave con quel nome, oppure passi ONEPROVIDER_KEY esplicitamente al costruttore. La matrice qui sotto mostra cosa legge ogni strumento:

Verificare l'autenticazione

Chiama /v1/models per un controllo economico e senza effetti collaterali:

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

Una risposta riuscita elenca i modelli attuali. Un 401 qui significa che la chiave è malformata, revocata o non ancora attiva.

Dove tenere la chiave

• Variabili d'ambiente: la scelta predefinita per la maggior parte dei casi.
• ~/.zshrc / ~/.bashrc con HISTCONTROL=ignorespace impostato, così i comandi che iniziano con uno spazio non finiscono nella cronologia della shell.
• Gestori di segreti: 1Password CLI, AWS Secrets Manager, Doppler, GCP Secret Manager.
• File .env per progetto: sempre inclusi in .gitignore.

Errori comuni

• Barra finale. https://api.oneprovider.dev/v1/ contro https://api.oneprovider.dev/v1: alcuni SDK concatenano il percorso in modo ingenuo. Usa la forma senza barra finale mostrata sopra.
• Doppio Bearer. Authorization: Bearer Bearer sk-... succede quando uno strumento antepone già Bearer e tu lo aggiungi di nuovo. Togli il prefisso dalla configurazione.
• Header della versione Anthropic. Includi sempre anthropic-version: 2023-06-01 nelle chiamate HTTP dirette. Gli SDK lo aggiungono per te.

Rotazione delle chiavi

Emetti una nuova chiave nell'area personale («Chiavi» → «Emetti una chiave»), aggiornala nei tuoi client, poi elimina quella vecchia. È immediato e gratuito, e il saldo è condiviso da tutte le chiavi dell'area personale. Altro: Area personale e chiavi .

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 .