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 gli SDK, usando come esempio la beta di context editing (modifica del contesto). 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-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

Quando usi un SDK, elenca ciascuna 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 ha effetto solo il valore del primo flag.

Header specifici per endpoint

Alcune API beta sono limitate a endpoint specifici e richiedono un header beta specifico della 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 di Managed Agents, Uso della 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. Gli SDK client inviano 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