Header beta

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

Queste funzionalità sono soggette a modifiche e potrebbero essere modificate o rimosse nelle versioni future.



Come utilizzare gli header beta

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

POST /v1/messages
Content-Type: application/json
X-API-Key: YOUR_API_KEY
anthropic-beta: BETA_FEATURE_NAME

Quando utilizzi l'SDK, puoi specificare gli header beta nelle opzioni della richiesta:

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"],
)



Funzionalità beta multiple

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

anthropic-beta: feature1,feature2,feature3



Header specifici per endpoint

Alcune funzionalità beta sono limitate a endpoint specifici anziché a singoli parametri di richiesta e richiedono un header beta specifico per la funzionalità in ogni richiesta:

Consulta la panoramica sui Managed Agents e il riferimento sui 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 è stata rilasciata la versione beta. Utilizza sempre il nome esatto della funzionalità beta come documentato.



Gestione degli errori

Se utilizzi un header beta non valido o non disponibile, riceverai una risposta di errore:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unsupported beta header: invalid-beta-name"
  }
}



Ottenere assistenza

Per domande sulle funzionalità beta:

1. Consulta la documentazione per la funzionalità specifica
2. Rivedi il changelog dell'API per gli aggiornamenti
3. Contatta il supporto per assistenza con l'utilizzo in produzione

Ricorda che le funzionalità beta sono fornite "così come sono" e potrebbero non avere le stesse garanzie SLA delle funzionalità stabili dell'API.