Referencia de la APISoporte y configuración

Versiones de la API

Copy page



Al realizar solicitudes a la API, debes enviar un encabezado de solicitud anthropic-version. Por ejemplo, anthropic-version: 2026-10-21. Si estás usando el SDK de cliente, este establece este encabezado por ti.

Para cualquier versión dada de la API, Anthropic preserva:

• Los parámetros de entrada existentes
• Los parámetros de salida existentes

Sin embargo, Anthropic puede hacer lo siguiente:

• Agregar entradas opcionales adicionales
• Agregar valores adicionales a la salida
• Cambiar las condiciones para tipos de error específicos
• Agregar nuevas variantes a valores de salida de tipo enum (por ejemplo, tipos de eventos de streaming)

En general, si estás usando la API tal como se documenta en esta referencia, Anthropic no romperá tu uso.

Historial de versiones

Anthropic recomienda usar la versión más reciente de la API siempre que sea posible.

• 2026-10-21
  • Migración a la versión de la API 2026-10-21 muestra cómo actualizar.
  • Disponible en la Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) y Microsoft Foundry. En Amazon Bedrock, está disponible para Claude 4.7 y modelos posteriores. Para modelos de Claude anteriores en Bedrock, mantén la versión de la API que usas hoy.
  • Messages API:
    • Una solicitud que coloca un bloque document directamente en un mensaje assistant devuelve un error 400.
    • Enviar un bloque text con un arreglo citations no vacío en un mensaje user, directamente o dentro de un bloque search_result, devuelve un error 400.
    • Se eliminan los parámetros de solicitud temperature, top_p y top_k. Una solicitud que envíe cualquiera de ellos devuelve un error 400 en todos los modelos.
  • Admin API:
    • Los grupos RBACVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. ya no devuelven roles. Usa role_ids en su lugar.
    • Los miembros de grupos RBACVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver., y la respuesta al eliminar uno, ya no devuelven group_id. Usa rbac_group_id en su lugar.
    • Los roles RBACVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. ya no devuelven name. Usa display_name en su lugar.
    • Las entradas de límite de velocidad de la organizaciónVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. y del espacio de trabajoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver., y la respuesta a establecer los límites de velocidad de un espacio de trabajoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver., ya no devuelven group_type. Usa group.type en su lugar.
    • Las claves de APIVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. ya no devuelven workspace_id. Usa scope.workspace_id en su lugar. Contiene el ID del espacio de trabajo de la clave, incluido el espacio de trabajo predeterminado. Una clave de todos los espacios de trabajo no tiene scope.workspace_id.
  • Claude Enterprise Analytics API:
    • Los informes por usuario de usoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. y costoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. ya no tienen actor.email. Usa actor.email_address en su lugar.
    • La respuesta de resúmenes de actividadVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. ya no tiene summaries. Usa data en su lugar.
• 2023-06-01
  • Nuevo formato para los “server-sent events” (eventos enviados por el servidor), o SSE, de streaming:
    • Las completaciones son incrementales. Por ejemplo, " Hello", " my", " name", " is", " Claude." en lugar de " Hello", " Hello my", " Hello my name", " Hello my name is", " Hello my name is Claude.".
    • Todos los eventos son eventos con nombre, en lugar de eventos solo de datos.
    • Se eliminó el evento innecesario data: [DONE].
  • Se eliminaron los valores heredados exception y truncated en las respuestas.
• 2023-01-01: Lanzamiento inicial.