Compatibilità con SDK OpenAI (beta)

​

Prima di iniziare

Questo livello di compatibilità è destinato a testare e confrontare le capacità dei modelli con uno sforzo di sviluppo minimo e non è considerato una soluzione a lungo termine o pronta per la produzione per la maggior parte dei casi d’uso. Per la migliore esperienza e l’accesso al set completo di funzionalità dell’API Anthropic (elaborazione PDF, citazioni, pensiero esteso e caching dei prompt), consigliamo di utilizzare l’API Anthropic nativa.

​

Iniziare con l’SDK OpenAI

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

1. Utilizzare un SDK OpenAI ufficiale
2. Modificare quanto segue
   • Aggiornare l’URL base per puntare all’API di Anthropic
   • Sostituire la tua chiave API con una chiave API Anthropic
   • Aggiornare il nome del modello per utilizzare un modello Claude
3. Consultare la documentazione qui sotto per le funzionalità supportate

​

Esempio di avvio rapido

from openai import OpenAI

client = OpenAI(
    api_key="ANTHROPIC_API_KEY",  # La tua chiave API Anthropic
    base_url="https://api.anthropic.com/v1/"  # Endpoint API di Anthropic
)

response = client.chat.completions.create(
    model="claude-opus-4-20250514", # Nome del modello Anthropic
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"}
    ],
)

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

​

Importanti limitazioni di compatibilità con OpenAI

​

Comportamento dell’API

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

• Il parametro strict per la chiamata di funzioni viene ignorato, il che significa che il JSON per l’uso degli strumenti non è garantito che segua lo schema fornito.
• L’input audio non è supportato; sarà semplicemente ignorato e rimosso dall’input
• Il caching dei prompt non è supportato, ma è supportato nell’SDK Anthropic
• I messaggi di sistema/sviluppatore vengono sollevati 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é generare errori. Tutti questi sono documentati di seguito.

​

Considerazioni sulla qualità dell’output

Se hai fatto molte modifiche al tuo prompt, è probabile che sia ben ottimizzato specificamente per OpenAI. Considera l’utilizzo del nostro miglioratore di prompt nella Console Anthropic come un buon punto di partenza.

​

Sollevamento dei messaggi di sistema / sviluppatore

La maggior parte degli input all’SDK OpenAI si mappa direttamente ai parametri dell’API di Anthropic, ma una differenza distinta è la gestione dei prompt di sistema / sviluppatore. Questi due prompt possono essere inseriti in tutta una conversazione chat tramite OpenAI. Poiché Anthropic supporta solo un messaggio di sistema iniziale, prendiamo tutti i messaggi di sistema/sviluppatore e li concateniamo insieme con un singolo carattere di nuova riga (\n) tra di loro. Questa stringa completa viene quindi fornita come un singolo messaggio di sistema all’inizio dei messaggi.

​

Supporto al pensiero esteso

Puoi abilitare le capacità di pensiero esteso aggiungendo il parametro thinking. Sebbene questo migliorerà il ragionamento di Claude per compiti complessi, l’SDK OpenAI non restituirà il processo di pensiero dettagliato di Claude. Per le funzionalità complete di pensiero esteso, incluso l’accesso all’output del ragionamento passo-passo di Claude, utilizza l’API Anthropic nativa.

response = client.chat.completions.create(
    model="claude-opus-4-20250514",
    messages=...,
    extra_body={
        "thinking": { "type": "enabled", "budget_tokens": 2000 }
    }
)

​

Limiti di frequenza

I limiti di frequenza 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 di 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. Consigliamo di utilizzare i messaggi di errore solo per la registrazione e il debug.

​

Compatibilità degli header

Mentre l’SDK OpenAI gestisce automaticamente gli header, ecco l’elenco completo degli header supportati dall’API di Anthropic per gli sviluppatori che hanno bisogno di lavorare direttamente con essi.