Header beta

I "beta headers" (header beta) ti consentono di accedere a funzionalità sperimentali e a 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 ciascuna 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 l'SDK, usando come esempio la beta di modifica del contesto. L'SDK accetta i nomi beta tramite betas e invia l'header anthropic-beta al posto tuo:

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["context-management-2025-06-27"],
)

print(response.content)

Funzionalità beta multiple

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

Puoi anche inviare l'header anthropic-beta più di una volta nella stessa richiesta. La Claude API legge ogni header anthropic-beta, quindi quanto segue equivale all'esempio precedente:

anthropic-beta: feature1
anthropic-beta: feature2
anthropic-beta: feature3

Con l'SDK, elenca ciascuna funzionalità (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). Puoi anche ripetere il flag (ad esempio, --beta feature1 --beta feature2).

Funzionalità beta su altre piattaforme

I nomi beta sono gli stessi su ogni piattaforma che li accetta, ma non tutte le piattaforme accettano ogni beta. Claude Platform on AWS, Microsoft Foundry e Google Cloud accettano i nomi beta nell'header anthropic-beta, come fa la Claude API. Per inviare più beta, inserisci i loro nomi in un unico header, separati da virgole: Google Cloud legge un solo header anthropic-beta e ignora gli altri, quindi le beta negli altri header non hanno effetto.

Su Amazon Bedrock, la posizione dei nomi beta dipende dall'API che chiami:

• Claude in Amazon Bedrock (endpoint bedrock-mantle) li accetta nell'header anthropic-beta.
• L'API InvokeModel li legge dal corpo della richiesta, non da un header. Elencali nell'array anthropic_beta del corpo, un nome per elemento, ad esempio "anthropic_beta": ["feature1", "feature2"].

Header specifici per endpoint

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

Il namespace client.beta dell'SDK aggiunge questi header automaticamente. Aggiungili tu stesso solo quando effettui richieste HTTP dirette. Consulta la panoramica di Managed Agents, Usare la memoria degli agenti e il riferimento dei tunnel MCP per i dettagli.

Gli header specifici per endpoint che si applicano allo stesso endpoint non sono sempre combinabili. Sugli endpoint dei memory store, agent-memory-2026-07-22 sostituisce managed-agents-2026-04-01: inviarli entrambi nella stessa richiesta restituisce un errore 400. L'SDK invia automaticamente l'header corretto per ciascun endpoint.

Convenzioni di denominazione delle versioni

I nomi delle funzionalità beta seguono tipicamente lo schema 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 assistenza

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

Prossimi passi