Compatibilità SDK OpenAI

Questo livello di compatibilità è principalmente destinato a testare e confrontare le capacità del modello, e non è considerato una soluzione a lungo termine o pronta per la produzione per la maggior parte dei casi d’uso. Anche se intendiamo mantenerlo completamente funzionale e non apportare modifiche che causino interruzioni, la nostra priorità è l’affidabilità e l’efficacia dell’API Anthropic.Per maggiori informazioni sulle limitazioni di compatibilità note, vedi Importanti limitazioni di compatibilità OpenAI.Se riscontri problemi con la funzionalità di compatibilità SDK OpenAI, faccelo sapere qui.

Per la migliore esperienza e l’accesso al set completo di funzionalità dell’API Anthropic (elaborazione PDF, citazioni, pensiero esteso, e caching dei prompt), raccomandiamo di utilizzare l’API Anthropic nativa.

Iniziare con l’SDK OpenAI

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

Utilizzare un SDK OpenAI ufficiale
Modificare quanto segue
- Aggiornare il tuo URL base per puntare all’API di Anthropic
- Sostituire la tua chiave API con una chiave API Anthropic
- Aggiornare il nome del tuo modello per utilizzare un modello Claude
Rivedere la documentazione qui sotto per vedere quali funzionalità sono 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": "Sei un assistente utile."},
        {"role": "user", "content": "Chi sei?"}
    ],
)

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

Importanti limitazioni di compatibilità OpenAI

Comportamento API

Ecco le differenze più sostanziali dall’utilizzo di OpenAI:

Il parametro strict per la chiamata di funzioni viene ignorato, il che significa che il JSON di utilizzo degli strumenti non è garantito seguire lo schema fornito.
L’input audio non è supportato; verrà semplicemente ignorato e rimosso dall’input
Il caching dei prompt non è supportato, ma è supportato nell’SDK Anthropic
I messaggi di sistema/sviluppatore vengono elevati e concatenati all’inizio della conversazione, poiché Anthropic supporta solo un singolo messaggio di sistema iniziale.

La maggior parte dei campi non supportati vengono silenziosamente ignorati piuttosto che produrre errori. Questi sono tutti documentati qui sotto.

Considerazioni sulla qualità dell’output

Se hai fatto molte modifiche al tuo prompt, è probabile che sia ben sintonizzato specificamente per OpenAI. Considera di utilizzare il nostro miglioratore di prompt nella Console Anthropic come buon punto di partenza.

Elevazione dei messaggi di Sistema / Sviluppatore

La maggior parte degli input all’SDK OpenAI si mappano chiaramente 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 di chat tramite OpenAI. Poiché Anthropic supporta solo un messaggio di sistema iniziale, prendiamo tutti i messaggi di sistema/sviluppatore e li concateniamo insieme con una singola nuova riga (\n) tra di loro. 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. Anche se 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 di 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 velocità

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

Supporto dettagliato dell’API compatibile OpenAI

Campi di richiesta

Campi semplici

Campo	Stato di supporto
`model`	Usa i nomi dei modelli Claude
`max_tokens`	Completamente supportato
`max_completion_tokens`	Completamente supportato
`stream`	Completamente supportato
`stream_options`	Completamente supportato
`top_p`	Completamente supportato
`parallel_tool_calls`	Completamente supportato
`stop`	Tutte le sequenze di stop non-whitespace funzionano
`temperature`	Tra 0 e 1 (inclusi). Valori maggiori di 1 sono limitati a 1.
`n`	Deve essere esattamente 1
`logprobs`	Ignorato
`metadata`	Ignorato
`response_format`	Ignorato
`prediction`	Ignorato
`presence_penalty`	Ignorato
`frequency_penalty`	Ignorato
`seed`	Ignorato
`service_tier`	Ignorato
`audio`	Ignorato
`logit_bias`	Ignorato
`store`	Ignorato
`user`	Ignorato
`modalities`	Ignorato
`top_logprobs`	Ignorato
`reasoning_effort`	Ignorato

Campi `tools` / `functions`

Mostra campi

Campo	Stato di supporto
`name`	Completamente supportato
`description`	Completamente supportato
`parameters`	Completamente supportato
`strict`	Ignorato

Campi dell’array `messages`

Mostra campi

Campi per messages[n].role == "developer"

I messaggi di sviluppatore vengono elevati all’inizio della conversazione come parte del messaggio di sistema iniziale

Campo	Stato di supporto
`content`	Completamente supportato, ma elevato
`name`	Ignorato

Campi di risposta

Campo	Stato di supporto
`id`	Completamente supportato
`choices[]`	Avrà sempre una lunghezza di 1
`choices[].finish_reason`	Completamente supportato
`choices[].index`	Completamente supportato
`choices[].message.role`	Completamente supportato
`choices[].message.content`	Completamente supportato
`choices[].message.tool_calls`	Completamente supportato
`object`	Completamente supportato
`created`	Completamente supportato
`model`	Completamente supportato
`finish_reason`	Completamente supportato
`content`	Completamente supportato
`usage.completion_tokens`	Completamente supportato
`usage.prompt_tokens`	Completamente supportato
`usage.total_tokens`	Completamente supportato
`usage.completion_tokens_details`	Sempre vuoto
`usage.prompt_tokens_details`	Sempre vuoto
`choices[].message.refusal`	Sempre vuoto
`choices[].message.audio`	Sempre vuoto
`logprobs`	Sempre vuoto
`service_tier`	Sempre vuoto
`system_fingerprint`	Sempre vuoto

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. Raccomandiamo di utilizzare i messaggi di errore solo per logging e debugging.

Compatibilità degli header

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

Header	Stato di Supporto
`x-ratelimit-limit-requests`	Completamente supportato
`x-ratelimit-limit-tokens`	Completamente supportato
`x-ratelimit-remaining-requests`	Completamente supportato
`x-ratelimit-remaining-tokens`	Completamente supportato
`x-ratelimit-reset-requests`	Completamente supportato
`x-ratelimit-reset-tokens`	Completamente supportato
`retry-after`	Completamente supportato
`request-id`	Completamente supportato
`openai-version`	Sempre `2020-10-01`
`authorization`	Completamente supportato
`openai-processing-ms`	Sempre vuoto

Utilizzo delle API

Riferimento API

SDK

Esempi

API di terze parti

Utilizzo dell'API Admin

Supporto e configurazione

Compatibilità SDK OpenAI

Iniziare con l’SDK OpenAI

Esempio di avvio rapido

Importanti limitazioni di compatibilità OpenAI

Comportamento API

Considerazioni sulla qualità dell’output

Elevazione dei messaggi di Sistema / Sviluppatore

Supporto per il pensiero esteso

Limiti di velocità

Supporto dettagliato dell’API compatibile OpenAI

Campi di richiesta

Campi semplici

Campi `tools` / `functions`

Campi dell’array `messages`

Campi di risposta

Compatibilità dei messaggi di errore

Compatibilità degli header

Utilizzo delle API

Riferimento API

SDK

Esempi

API di terze parti

Utilizzo dell'API Admin

Supporto e configurazione

​Iniziare con l’SDK OpenAI

​Esempio di avvio rapido

​Importanti limitazioni di compatibilità OpenAI

​Comportamento API

​Considerazioni sulla qualità dell’output

​Elevazione dei messaggi di Sistema / Sviluppatore

​Supporto per il pensiero esteso

​Limiti di velocità

​Supporto dettagliato dell’API compatibile OpenAI

​Campi di richiesta

​Campi semplici

​Campi tools / functions

​Campi dell’array messages

​Campi di risposta

​Compatibilità dei messaggi di errore

​Compatibilità degli header

Iniziare con l’SDK OpenAI

Esempio di avvio rapido

Importanti limitazioni di compatibilità OpenAI

Comportamento API

Considerazioni sulla qualità dell’output

Elevazione dei messaggi di Sistema / Sviluppatore

Supporto per il pensiero esteso

Limiti di velocità

Supporto dettagliato dell’API compatibile OpenAI

Campi di richiesta

Campi semplici

Campi `tools` / `functions`

Campi dell’array `messages`

Campi di risposta

Compatibilità dei messaggi di errore

Compatibilità degli header