Encabezados beta

Los "beta headers" (encabezados beta) te permiten acceder a funciones experimentales y nuevas capacidades de los modelos antes de que formen parte de la API estándar.

Cómo usar los encabezados beta

Para acceder a las funciones beta, incluye el encabezado anthropic-beta en tus solicitudes a la 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 documentación de cada función indica el nombre exacto de la beta que debes enviar. La descripción general de la API enumera las API que actualmente están en beta.

Los siguientes ejemplos muestran la misma solicitud con cURL, la CLI ant y el SDK, usando como ejemplo la beta de edición de contexto. El SDK recibe los nombres beta mediante betas y envía el encabezado anthropic-beta por ti:

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)

Múltiples funciones beta

Para usar múltiples funciones beta en una sola solicitud, incluye todos los nombres de las funciones en el encabezado separados por comas:

anthropic-beta: feature1,feature2,feature3

También puedes enviar el encabezado anthropic-beta más de una vez en la misma solicitud. La Claude API lee cada encabezado anthropic-beta, por lo que lo siguiente es equivalente al ejemplo anterior:

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

Con el SDK, enumera cada función (por ejemplo, betas=["feature1", "feature2"]). Con la CLI, pasa un solo indicador --beta con los nombres de las funciones separados por comas (por ejemplo, --beta feature1,feature2). También puedes repetir el indicador (por ejemplo, --beta feature1 --beta feature2).

Funciones beta en otras plataformas

Los nombres beta son los mismos en todas las plataformas que los aceptan, pero no todas las plataformas aceptan todas las betas. Claude Platform on AWS, Microsoft Foundry y Google Cloud reciben los nombres beta en el encabezado anthropic-beta, al igual que la Claude API. Para enviar varias betas, coloca sus nombres en un solo encabezado, separados por comas: Google Cloud lee solo un encabezado anthropic-beta e ignora el resto, por lo que las betas de los demás no surten efecto.

En Amazon Bedrock, dónde van los nombres beta depende de la API que llames:

• Claude en Amazon Bedrock (endpoints bedrock-mantle) los recibe en el encabezado anthropic-beta.
• La API InvokeModel los lee del cuerpo de la solicitud, no de un encabezado. Enuméralos en el arreglo anthropic_beta del cuerpo, un nombre por elemento, por ejemplo "anthropic_beta": ["feature1", "feature2"].

Encabezados específicos de endpoint

Algunas API beta están limitadas a endpoints específicos y requieren un encabezado beta específico de la función en cada solicitud:

El espacio de nombres client.beta del SDK agrega estos encabezados automáticamente. Agrégalos tú mismo solo cuando hagas solicitudes HTTP sin procesar. Consulta la descripción general de Managed Agents, Uso de la memoria de agentes y la referencia de túneles MCP para obtener más detalles.

Los encabezados específicos de endpoint que se aplican al mismo endpoint no siempre se pueden combinar. En los endpoints de almacenes de memoria, agent-memory-2026-07-22 reemplaza a managed-agents-2026-04-01: enviar ambos en la misma solicitud devuelve un error 400. El SDK envía automáticamente el encabezado correcto para cada endpoint.

Convenciones de nomenclatura de versiones

Los nombres de las funciones beta normalmente siguen el patrón feature-name-YYYY-MM-DD, donde la fecha indica cuándo se lanzó la beta. Usa siempre el nombre exacto de la función beta tal como está documentado.

Manejo de errores

Si usas un nombre de beta no válido, o una beta a la que tu organización no tiene acceso, recibirás una respuesta de error 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"
}

Obtener ayuda

Para conocer las actualizaciones de las funciones beta, consulta las notas de la versión. Para obtener ayuda con problemas en producción, contacta a soporte.

Próximos pasos