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

Estas funciones están sujetas a cambios y pueden ser modificadas o eliminadas en futuras versiones.

Cómo usar los encabezados beta

Para acceder a las funciones beta, incluye el encabezado anthropic-beta en tus solicitudes de API:

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

Cuando uses el SDK, puedes especificar los encabezados beta en las opciones de la solicitud:

from anthropic import Anthropic

client = Anthropic()

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    extra_headers={
        "anthropic-beta": "beta-feature-name"
    }
)

Las funciones beta son experimentales y pueden:

  • Tener cambios importantes sin previo aviso
  • Ser descontinuadas o eliminadas
  • Tener diferentes límites de tasa o precios
  • No estar disponibles en todas las regiones

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

Convenciones de nomenclatura de versiones

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

Manejo de errores

Si usas un encabezado beta invá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 actualizaciones
  3. Contacta al soporte para obtener ayuda con el uso en producción

Recuerda que las funciones beta se proporcionan “tal cual” y pueden no tener las mismas garantías de SLA que las funciones estables de la API.