Encabezados beta

Los encabezados beta te permiten acceder a funciones experimentales y nuevas capacidades del modelo antes de que formen parte de la API estándar.

Estas funciones están sujetas a cambios y pueden modificarse o eliminarse en versiones futuras.



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
Content-Type: application/json
X-API-Key: YOUR_API_KEY
anthropic-beta: BETA_FEATURE_NAME

Al usar el SDK, puedes especificar los encabezados beta en las opciones de la solicitud:

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



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



Encabezados específicos de endpoint

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

Consulta la descripción general de Managed Agents y la referencia de túneles MCP para obtener más detalles.



Convenciones de nomenclatura de versiones

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



Manejo de errores

Si usas un encabezado beta no válido o no disponible, recibirás una respuesta de error:

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



Obtener ayuda

Para preguntas sobre funciones beta:

1. Consulta la documentación de la función específica
2. Revisa el registro de cambios de la API para ver actualizaciones
3. Contacta al soporte para obtener asistencia con el uso en producción

Recuerda que las funciones beta se proporcionan "tal cual" y es posible que no tengan las mismas garantías de SLA que las funciones estables de la API.