Compatibilità con l'SDK di OpenAI



Iniziare con l'SDK di OpenAI

Per utilizzare la funzionalità di compatibilità con l'SDK di OpenAI, dovrai:

1. Usare un SDK ufficiale di OpenAI
2. Modificare quanto segue
   • Aggiorna il tuo URL di base in modo che punti alla Claude API
   • Sostituisci la tua chiave API con una chiave API di Claude
   • Aggiorna il nome del modello per utilizzare un modello Claude
3. Consultare le sezioni seguenti per sapere quali funzionalità sono supportate



Esempio di avvio rapido

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),  # Your Claude API key
    base_url="https://api.anthropic.com/v1/",  # the Claude API endpoint
)

response = client.chat.completions.create(
    model="claude-opus-5",  # Claude model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
)

print(response.choices[0].message.content)



Limitazioni importanti della compatibilità con OpenAI



Comportamento dell'API

Ecco le differenze più sostanziali rispetto all'uso di OpenAI:

• Il parametro strict per la chiamata di funzioni viene ignorato, il che significa che non è garantito che il JSON dell'uso degli strumenti segua lo schema fornito. Per una conformità garantita allo schema, usa la Claude API nativa con Structured Outputs.
• L'input audio non è supportato; verrà ignorato e rimosso dall'input
• La cache dei prompt non è supportata, ma è supportata negli SDK di Anthropic
• I messaggi system/developer vengono spostati e concatenati all'inizio della conversazione, poiché Anthropic supporta solo un singolo messaggio di sistema iniziale.

La maggior parte dei campi non supportati viene ignorata silenziosamente invece di produrre errori. Tutti questi sono documentati nelle sezioni seguenti.



Considerazioni sulla qualità dell'output

Se hai apportato molte ottimizzazioni al tuo prompt, è probabile che sia ben calibrato specificamente per OpenAI. Valuta di rielaborarlo per Claude utilizzando la guida alle best practice per i prompt.



Spostamento dei messaggi system / developer

La maggior parte degli input dell'SDK di OpenAI si mappa chiaramente e direttamente sui parametri dell'API di Anthropic, ma una differenza distinta è la gestione dei prompt system / developer. Questi due prompt possono essere inseriti in qualsiasi punto di una conversazione chat tramite OpenAI. Poiché Anthropic supporta solo un messaggio di sistema iniziale, l'API prende tutti i messaggi system/developer e li concatena insieme con un singolo carattere di nuova riga (\n) tra di essi. Questa stringa completa viene quindi fornita come singolo messaggio di sistema all'inizio dei messaggi.



Supporto per il pensiero

Puoi abilitare il pensiero aggiungendo il parametro thinking. Sui modelli attuali il pensiero è adattivo, con Claude che decide quando e quanto a fondo pensare, e sui modelli Claude 5 è attivo per impostazione predefinita; il pensiero esteso configurato manualmente è una modalità legacy. Sebbene il pensiero migliori il ragionamento di Claude per compiti complessi, l'SDK di OpenAI non restituisce il processo di pensiero dettagliato di Claude. Per le funzionalità complete di pensiero, incluso l'accesso all'output del ragionamento passo-passo di Claude, usa la Claude API nativa.

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Who are you?"}],
    extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)



Limiti di velocità

I limiti di velocità seguono i limiti standard di Anthropic per l'endpoint /v1/messages.



Supporto dettagliato dell'API compatibile con OpenAI



Campi della richiesta



Campi semplici



Campi tools / functions



Campi dell'array messages



Campi della risposta



Compatibilità dei messaggi di errore

Il livello di compatibilità mantiene formati di errore coerenti con l'API di OpenAI. Tuttavia, i messaggi di errore dettagliati non saranno equivalenti. Usa i messaggi di errore solo per il logging e il debugging.



Compatibilità degli header

Sebbene l'SDK di OpenAI gestisca automaticamente gli header, ecco l'elenco completo degli header supportati dalla Claude API per gli sviluppatori che hanno bisogno di lavorarci direttamente.