Migrare da OpenAI

Tre righe di diff. Il tuo SDK OpenAI esistente continua a funzionare.

La modifica

- client = OpenAI()
+ client = OpenAI(
+ api_key=os.environ["ONEPROVIDER_KEY"],
+ base_url="https://api.oneprovider.dev/v1",
+ )

Scegli in base al carico di lavoro

Non sosteniamo un'equivalenza uno a uno inventata tra i nomi dei modelli dei vari fornitori. Scegli il livello GPT attuale in base a qualità, costo e latenza richiesti:

Cosa funziona senza modifiche

• chat.completions.create con messages, temperature, max_tokens, stream.
• Function calling tramite tools; tool_choice: "auto".
• Modalità JSON (response_format: {"type": "json_object"}).
• Streaming tramite iteratori asincroni sia in Python sia in Node.

Cosa cambia

• seed e logprobs vengono ignorati senza avviso.
• Gli ID restituiti hanno il prefisso chatcmpl-op- invece di chatcmpl-.
• La vecchia forma function_call viene mappata internamente su tool_use di Anthropic; la superficie della risposta non cambia.

Usare la CLI Codex di OpenAI

Se usi la CLI Codex di OpenAI, puntala al nostro endpoint Responses API e riusa la stessa chiave. La configurazione completa è nella pagina del client Codex . In breve: ~/.codex/auth.json per la chiave, ~/.codex/config.toml con base_url = "https://api.oneprovider.dev/v1" e wire_api = "responses".

Verifica dopo la migrazione

response = client.chat.completions.create(
model="gpt-6.1-terra",
messages=[{"role": "user", "content": "Reply with: migration works"}],
)
print(response.choices[0].message.content)

Passare da OpenRouter o da un altro gateway

Cosa cambia nel mio client?

Tre impostazioni: base URL, chiave e ID del modello. Gli SDK OpenAI e gli strumenti compatibili con OpenAI usano https://api.oneprovider.dev/v1; Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Una sola chiave OneProvider funziona con entrambi.

In cosa differiscono gli ID dei modelli?

Gli ID di OneProvider non hanno prefisso del fornitore, per esempio claude-sonnet-5-5 o gpt-6.1-terra. Copiali dalla pagina dei modelli : un ID sconosciuto restituisce un 400 che indica il problema.

Cosa aggiunge OneProvider?

Endpoint nativi Anthropic e compatibili con OpenAI con una sola chiave, un saldo prepagato che non scade e senza abbonamento, ricariche con crypto, carte, Apple Pay, Google Pay o SBP, un limite di spesa e una scadenza per ogni chiave, e un registro dei consumi di ogni richiesta. Secondo la nostra policy il testo dei prompt non viene conservato; i server sono a Francoforte.

Come confronto i costi?

Confronta lo stesso modello: le tariffe per milione di token, comprese quelle della cache, sono nella pagina dei prezzi . Poi esegui un compito reale e leggi l'addebito nella pagina «Consumo».

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 .