LO ESENCIAL EN 30 SEGUNDOS

  • Con 2026-10-21, enviar temperature, top_p o top_k a la API Messages devuelve un error 400, incluso con los valores por defecto.
  • Las nuevas versiones mayores incluyen Python 2.0.0, TypeScript 1.0.0, Go 2.0.0, Java 3.0.0 y C# 13.0.0, con licencia Apache 2.0.
  • Se puede seguir en 2023-06-01; no se ha anunciado fecha de retirada.

Anthropic publicó el 21 de octubre una nueva versión de la API de Claude, el primer cambio en el encabezado anthropic-version desde 2023-06-01. Llega acompañada de nuevas versiones mayores de todos los SDK oficiales y de la herramienta de línea de comandos ant, que envían la nueva versión por defecto.

Qué se rompe en la API Messages

El cambio más visible afecta al muestreo. Las peticiones que incluyen temperature, top_p o top_k se rechazan ahora con un error 400, incluso si esos parámetros llevan su valor por defecto. La guía de migración advierte que el código que bajaba la temperatura para lograr respuestas más estables pierde ese efecto y que no existe un ajuste equivalente; quien lo necesite debe mantener esas llamadas en la versión anterior.

También se endurecen dos reglas de estructura. Un bloque document ya no puede ir directamente en un mensaje del asistente, y los bloques de texto del usuario no pueden llevar un arreglo citations con contenido. Las API Admin y Enterprise Analytics renombran varios campos; por ejemplo, workspace_id pasa a ser un objeto scope en las claves de API.

Cambios en los SDK y la CLI

Según las notas de versión, las nuevas entregas son Python 2.0.0, TypeScript 1.0.0, C# 13.0.0, Go 2.0.0, Java 3.0.0, PHP 1.0.0, Ruby 2.0.0 y la CLI ant 2.0.0. Algunos cambios se aplican sea cual sea la versión de la API: las claves se envían ahora como Authorization: Bearer en lugar de X-Api-Key, lo que afecta a proxies y filtros de registros; un cliente solo puede tener una credencial; la antigua interfaz Text Completions desaparece de varios SDK; y el tipo MessageParam de Python se divide según el rol. Además, los SDK pasan de la licencia MIT a Apache 2.0.

Qué deben hacer los equipos

La actualización es voluntaria. Quien llama directamente a la API elige la versión con el encabezado; con un SDK, basta con pasar a la nueva versión mayor. Anthropic aconseja probar contra 2026-10-21 y publicar la actualización del SDK junto con las correcciones de código. En Amazon Bedrock, la nueva versión solo funciona con Claude 4.7 y modelos posteriores.

La guía no fija fecha de retirada para 2023-06-01, por lo que no hay un plazo inmediato. La eliminación de los controles de muestreo es el cambio que más probablemente exija una decisión de producto y no solo un parche, sobre todo en aplicaciones que dependían de una temperatura baja para obtener resultados reproducibles.