Header beta

Gli header beta ti consentono di accedere a funzionalità sperimentali e nuove capacità dei modelli prima che diventino parte dell'API standard.



Come usare gli header beta

Per accedere alle funzionalità beta, includi l'header anthropic-beta nelle tue richieste API:

POST /v1/messages
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
anthropic-beta: BETA_FEATURE_NAME
content-type: application/json

La documentazione di ogni funzionalità indica il nome beta esatto da inviare. La panoramica dell'API elenca le API attualmente in beta.

Gli esempi seguenti mostrano la stessa richiesta con cURL, la CLI ant e gli SDK. Gli SDK accettano i nomi beta nel parametro betas e inviano l'header anthropic-beta per te:

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)

print(response.content)



Più funzionalità beta

Per usare più funzionalità beta in una singola richiesta, includi tutti i nomi delle funzionalità nell'header separati da virgole:

anthropic-beta: feature1,feature2,feature3

Quando usi un SDK, elenca ogni funzionalità nel parametro betas (ad esempio, betas=["feature1", "feature2"]). Con la CLI, passa un singolo flag --beta con i nomi delle funzionalità separati da virgole (ad esempio, --beta feature1,feature2). Evita di ripetere il flag: attualmente solo il valore del primo flag ha effetto.



Header specifici per endpoint

Alcune API beta sono limitate a endpoint specifici e richiedono un header beta specifico per la funzionalità in ogni richiesta:

I namespace beta degli SDK aggiungono questi header automaticamente. Aggiungili tu stesso solo quando effettui richieste HTTP dirette. Consulta la panoramica dei Managed Agents e il riferimento dei tunnel MCP per i dettagli.



Convenzioni di denominazione delle versioni

I nomi delle funzionalità beta seguono tipicamente il pattern feature-name-YYYY-MM-DD, dove la data indica quando la beta è stata rilasciata. Usa sempre il nome esatto della funzionalità beta come documentato.



Gestione degli errori

Se usi un nome beta non valido, o una beta a cui la tua organizzazione non ha accesso, riceverai una risposta di errore 400:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unexpected value(s) `invalid-beta-name` for the `anthropic-beta` header. Please consult our documentation at platform.claude.com/docs or try again without the header."
  },
  "request_id": "req_011CcnGfC9fELffo2EALu4Wd"
}



Ottenere aiuto

Per gli aggiornamenti sulle funzionalità beta, consulta le note di rilascio. Per assistenza con problemi in produzione, contatta il supporto.



Prossimi passi