Compatibilità con l'SDK OpenAI

Iniziare con l'SDK OpenAI

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

1. Usare un SDK OpenAI ufficiale
2. Modificare quanto segue
   • Aggiorna il tuo URL di base per puntare all'API di Claude
   • Sostituisci la tua chiave API con una chiave API di Claude
   • Aggiorna il nome del modello per utilizzare un modello Claude
3. Consultare la documentazione seguente 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-4-8",  # 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à OpenAI

Comportamento dell'API

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

• Il parametro strict per il function calling viene ignorato, il che significa che non è garantito che il JSON di tool use segua lo schema fornito. Per una conformità garantita allo schema, usa l'API di Claude nativa con Structured Outputs.
• L'input audio non è supportato; verrà semplicemente ignorato e rimosso dall'input
• La cache dei prompt non è supportata, ma è supportata negli SDK 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 anziché produrre errori. Questi sono tutti documentati di seguito.

Considerazioni sulla qualità dell'output

Se hai dedicato molto tempo a perfezionare il tuo prompt, è probabile che sia ottimizzato specificamente per OpenAI. Considera l'utilizzo del prompt improver nella Claude Console come buon punto di partenza.

Spostamento dei messaggi system / developer

La maggior parte degli input dell'SDK OpenAI corrisponde chiaramente e direttamente ai parametri dell'API di Anthropic, ma una differenza distintiva è la gestione dei prompt system / developer. Questi due tipi di 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 un singolo messaggio di sistema all'inizio dei messaggi.

Supporto per il pensiero esteso

Puoi abilitare le capacità di pensiero esteso aggiungendo il parametro thinking. Sebbene questo migliori il ragionamento di Claude per compiti complessi, l'SDK OpenAI non restituisce il processo di pensiero dettagliato di Claude. Per le funzionalità complete del pensiero esteso, incluso l'accesso all'output del ragionamento passo-passo di Claude, usa l'API di Claude 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 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 OpenAI gestisca automaticamente gli header, ecco l'elenco completo degli header supportati dall'API di Claude per gli sviluppatori che hanno bisogno di lavorarci direttamente.