Claude API 2026-10-21 elimina temperature, top_p y top_k

Anthropic lanzó una nueva versión de la API de Claude, 2026-10-21, el 21 de octubre de 2026. Elimina los ajustes de muestreo temperature, top_p y top_k. Cualquier solicitud que envíe uno de ellos falla ahora con un error 400. Siete SDK oficiales y la herramienta de línea de comandos ant publicaron nuevas versiones principales que la usan por defecto.

La versión anterior, 2023-06-01, ha sido la predeterminada durante más de tres años. El resumen diario de herramientas para agentes de Munder Difflin la describe como la primera versión nueva de la API de Anthropic desde entonces.

Cómo funcionan las versiones de la API de Claude

Cada solicitud a la API de Claude lleva un encabezado anthropic-version. Su valor es una fecha que fija la solicitud a un conjunto concreto de comportamientos. Para usar la nueva versión sin un SDK, envíe anthropic-version: 2026-10-21.

Dentro de una misma versión, la página de versiones de Anthropic promete que los campos de entrada y salida existentes se mantienen como están. Anthropic sí puede añadir entradas opcionales, nuevos valores de salida y nuevos tipos de eventos de streaming. Eliminar o renombrar un campo requiere una nueva versión con fecha, y eso es lo que ha ocurrido aquí.

Los SDK eligen la versión por usted. La guía de migración dice que las solicitudes «usan la versión de la API que estaba vigente cuando se lanzó la versión principal de su SDK». El código que usa una versión principal anterior del SDK sigue enviando 2023-06-01 hasta que lo actualice.

Qué deja de funcionar en la API Messages

Tres formas de solicitud devuelven ahora un error 400, según las notas de versión de Anthropic:

• Ajustes de muestreo. Se eliminan temperature, top_p y top_k. Enviar cualquiera de ellos falla en todos los modelos.
• Documentos en turnos del asistente. Se rechaza un bloque document colocado directamente en un mensaje assistant.
• Citas en turnos del usuario. Se rechaza un bloque text con un array citations no vacío en un mensaje user. Eso incluye uno anidado dentro de un bloque search_result.

La Admin API también renombra varios campos. Los grupos RBAC usan role_ids en lugar de roles, y los roles usan display_name en lugar de name. En las claves de API, workspace_id pasa a scope.workspace_id. También cambian dos campos de Claude Enterprise Analytics: actor.email pasa a ser actor.email_address, y summaries pasa a ser data.

La nueva versión funciona en la API de Claude, Claude Platform on AWS, Microsoft Foundry y Google Cloud. En Amazon Bedrock solo cubre Claude 4.7 y modelos posteriores.

Las nuevas versiones principales de los SDK

Estas son las primeras versiones que envían 2026-10-21, según las notas de versión y la guía de migración:

SDK o herramienta	Primera versión con 2026-10-21
Python (anthropic)	2.0.0
TypeScript (@anthropic-ai/sdk)	1.0.0
C# (Anthropic)	13.0.0
Go (anthropic-sdk-go/v2)	2.0.0
Java (com.anthropic:anthropic-java)	3.0.0
PHP (anthropic-ai/sdk)	1.0.0
Ruby (gem anthropic)	2.0.0
CLI ant	2.0.0

Los SDK traen sus propios cambios incompatibles, aparte de la versión de la API. La guía de migración enumera los principales:

• Encabezado de autorización. Los SDK y la CLI envían ahora la clave como Authorization: Bearer, no como X-Api-Key. La API acepta cualquiera de los dos encabezados, pero un proxy o gateway que lea X-Api-Key debe cambiar.
• Una credencial por cliente. Pasar a la vez una clave de API y un token de autenticación es ahora un error. En Python lanza ValueError; en TypeScript, TypeError.
• Text Completions eliminado. La antigua interfaz de completions desaparece de los SDK de TypeScript, Go, Java y Ruby, y de la CLI. Use la API Messages.
• Ruta del módulo de Go. El código en Go debe cambiar cada importación a github.com/anthropics/anthropic-sdk-go/v2 y necesita Go 1.25 o posterior.
• Comando de actualización en PHP. Un simple composer update se queda en la versión principal anterior. Use composer require para pasar a la 1.0.0.

La licencia también cambia. A partir de estas versiones, los SDK y la CLI tienen licencia Apache 2.0 en lugar de MIT. Las versiones anteriores siguen bajo MIT, y la guía dice que eso no requiere cambios en el código.

Más tarde, el 21 de octubre, Python SDK 2.1.0 y TypeScript SDK 1.1.0 añadieron a los perfiles de usuario el estado y las acciones de aplicación de normas. Es una función aparte, no forma parte del cambio de versión.

Qué significa esto para los desarrolladores

Nada se rompe hasta que actualice un SDK a una nueva versión principal o cambie el encabezado usted mismo. Eso le da tiempo, pero las notas de versión no fijan ninguna fecha de retirada para 2023-06-01. Planifique el cambio en lugar de esperar a que llegue esa fecha.

• Busque primero los ajustes de muestreo. Encuentre cada llamada que fije temperature, top_p o top_k, también en wrappers y archivos de configuración. Cada una se convertirá en un error 400 tras la actualización.
• Revise lo que hay entre usted y la API. Un proxy de registro, un gateway o un escáner de secretos que lea X-Api-Key dejará de ver la clave en cuanto el SDK envíe Authorization: Bearer.
• Fije la versión principal en su lockfile. Un rango sin fijar de anthropic o @anthropic-ai/sdk puede saltar a la nueva versión principal en la próxima instalación. Actualice a propósito y con pruebas.
• Revise las conversaciones guardadas. Si reproduce historiales de mensajes guardados, compruebe que no tengan documentos en turnos del asistente ni citas en turnos del usuario.
• Avise a quien lleve el control de licencias. Las nuevas versiones principales usan Apache 2.0, no MIT. Registre el cambio antes de que se publique la actualización.