Claude Opus 4.7: error de temperature (400 o TypeError) y arreglo
Desde Claude Opus 4.7, una temperature distinta de 1.0, un top_p menor que 0.99 o cualquier top_k dan error 400, también en Opus 5.5. Quita los tres campos.
En esta página

Si tu llamada a Claude Opus 4.7 falla por temperature, el arreglo es quitar el campo, no buscarle otro valor. Desde Opus 4.7, la API de Anthropic responde con un error 400 a cualquier temperature distinta de 1.0, a un top_p menor que 0.99 y a cualquier top_k, y la regla se mantiene en Opus 4.8, Opus 5 y Opus 5.5. Con el SDK de Python 1.0 o posterior ni siquiera llegas al 400: la librería lanza un TypeError antes de enviar nada.
Lo que suele costar es dar con quién añade el campo. Puede ser tu código, un helper compartido, Amazon Bedrock, un gateway compatible con OpenAI o una herramienta como Cursor, Cline o ComfyUI que lo mete por su cuenta.
Qué error tienes: TypeError, 400 o fallo dentro de una herramienta
El texto del error te dice en qué capa está el problema. Hay tres variantes, y cada una se arregla en un sitio distinto.
1. TypeError en Python, sin petición de red. Con el paquete anthropic 1.0 o posterior (la 1.0.0 salió el 20 de agosto de 2026):
TypeError: Messages.create() got an unexpected keyword argument 'temperature'El SDK ya no define temperature, top_p ni top_k en messages.create(), así que el fallo ocurre en tu proceso y la petición nunca sale. En una prueba local del 21 de octubre de 2026 con anthropic==1.17.0 y un servidor simulado (sin llamada real a la API de Anthropic), el TypeError saltó con temperature=0.2, con top_p=0.9, con top_k=5 y también con temperature=1.0. Para el SDK no importa el valor: el argumento ya no existe.
2. Error 400 que devuelve el servidor. Tu código o una librería envió el campo y la API lo rechazó. El cuerpo que aparece en los logs publicados en el issue #2939 de picoclaw en GitHub es este:
{"error":{"code":"invalid_request_error","message":"temperature is deprecated for this model.","type":"invalid_request_error"}}ComfyUI lo mostraba como "temperature is deprecated for this model. (Type: invalid_request_error)". En estos modelos, «deprecated» (obsoleto) no es una advertencia que puedas ignorar: la petición se rechaza. Si el campo culpable es top_p o top_k, es de esperar un mensaje equivalente con ese nombre, aunque los reportes públicos muestran sobre todo el de temperature.
3. El mismo 400 dentro de Cursor, Cline u otra herramienta, aunque tu código no tenga temperature. Ocurre sobre todo con Bedrock y con proveedores «OpenAI Compatible». La herramienta añade el campo; tú solo ves el mensaje.
| Lo que ves | Dónde nace | Qué hacer primero |
|---|---|---|
TypeError: ... unexpected keyword argument 'temperature' | SDK de Python 1.x, antes de enviar | Borrar el argumento de la llamada o del diccionario de parámetros |
400 temperature is deprecated for this model. desde tu código | Tu código, un helper o el SDK 0.x | Quitar el campo en la capa que construye el JSON |
| El mismo 400 en Cursor, Cline, ComfyUI, picoclaw o vía Bedrock | La herramienta o el adaptador | Actualizar la herramienta, quitar el valor de su configuración o seguir el issue |
400 que menciona thinking después de quitar temperature | Otro cambio de la misma migración | Ver el apartado de comprobación más abajo |
Por qué Claude Opus 4.7 rechaza temperature, top_p y top_k
Anthropic marca los tres parámetros de muestreo como «Deprecated (Claude 4.7 and later models)» en su tabla de parámetros obsoletos de la API: con un valor distinto del predeterminado, Claude 4.7 y los modelos posteriores devuelven 400. La guía de migración a Opus 5.5 lo repite con Opus 5.5 incluido y recomienda omitir los tres campos del cuerpo de la petición y guiar el comportamiento con el prompt.
La referencia del endpoint Messages de la API de Claude concreta qué pasa con cada campo en los modelos posteriores a Opus 4.6:
| Campo | Se acepta | Devuelve 400 |
|---|---|---|
temperature | Solo 1.0, el valor por defecto, por compatibilidad | Cualquier otro: 0, 0.2, 0.7… |
top_p | Valores iguales o mayores que 0.99, por compatibilidad | Cualquier valor menor, como 0.9 |
top_k | Ninguno | Cualquier valor |
Hay una excepción más estricta: según su guía de migración, Claude Haiku 5.5 solo acepta top_p exactamente en 0.99 (un 1 se rechaza) y rechaza las peticiones que llevan temperature y top_p a la vez. Por eso los valores «admitidos» no son una base fiable si tu código cambia de modelo.
Dos detalles cambian lo que conviene hacer:
- Omitir es más seguro que dejar el valor admitido. El servidor acepta
temperature: 1.0, pero el SDK de Python 1.x rechaza el argumento igualmente, Haiku 5.5 aplica otras reglas y no todas las capas intermedias reenvían el valor tal cual. Si el campo no está, nada puede fallar por él. temperature = 0nunca garantizó respuestas idénticas. Anthropic lo recuerda en la misma guía, y AWS lo dice en su ficha de Bedrock. Si lo usabas para tests reproducibles, el problema ya existía; ahora simplemente se ve.
Amazon Bedrock aplica la misma regla. La ficha de Claude Opus 4.7 en la documentación de Amazon Bedrock dice que desde Opus 4.7 temperature, top_p y top_k ya no se admiten y que lo recomendado es omitirlos.
Quitar temperature del código: Python y TypeScript

El texto del error y el ID de modelo de la imagen son ilustrativos: los correctos son los que aparecen en el texto (temperature is deprecated for this model. y claude-opus-4-7, sin fecha).
Python con el SDK anthropic 1.x
Antes, con el TypeError:
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-opus-4-7",
max_tokens=1024,
temperature=0.2, # anthropic>=1.0: TypeError, no se envía nada
messages=[{"role": "user", "content": "Resume este informe en cinco puntos."}],
)Después:
message = client.messages.create(
model="claude-opus-4-7",
max_tokens=1024,
messages=[{"role": "user", "content": "Resume este informe en cinco puntos."}],
)Si los parámetros vienen de un archivo de configuración o de un helper compartido (client.messages.create(**params)), filtra las tres claves en un solo sitio en lugar de buscarlas llamada por llamada:
SAMPLING_KEYS = {"temperature", "top_p", "top_k"}
params = {k: v for k, v in params.items() if k not in SAMPLING_KEYS}
message = client.messages.create(**params)No uses extra_body para «colar» el campo. Con extra_body={"temperature": 0.2} el SDK 1.x lo envía sin quejarse, pero entonces el que responde es el servidor, y con Opus 4.7 o posterior lo hará con el 400. Ese parámetro solo tiene sentido si apuntas temporalmente a un modelo anterior a 4.7 (más abajo).
Para saber qué versión tienes instalada: pip show anthropic.
Python 0.x y TypeScript: el 400 llega del servidor
El SDK de Python 0.99.0 envía temperature, top_p y top_k tal cual (en la misma prueba local aparecían en el JSON enviado), así que ves el 400 como anthropic.BadRequestError. La corrección es la misma: borrar el argumento.
Según la documentación de Anthropic, la mayoría de los SDK, a diferencia del de Python 1.x, conservan los campos en sus tipos para que el código antiguo siga compilando. En TypeScript el compilador no te avisa y el error aparece al ejecutar:
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();
const message = await client.messages.create({
model: "claude-opus-4-7",
max_tokens: 1024,
// temperature: 0.2, ← bórralo: compila, pero la API responde 400
messages: [{ role: "user", content: "Resume este informe en cinco puntos." }],
});Si llamas a la API por HTTP sin SDK, el criterio es el mismo: el JSON que se envía no debe llevar ninguna de las tres claves.
Amazon Bedrock: ID sin fecha y campos en inferenceConfig
En Bedrock el error aparece igual, pero los campos están en sitios distintos según la API que uses. Los ID de Opus 4.7 no llevan sufijo de fecha: anthropic.claude-opus-4-7, los perfiles regionales us., eu., jp. y au.anthropic.claude-opus-4-7, y el global global.anthropic.claude-opus-4-7.
Con InvokeModel o la API Messages, el cuerpo tiene el formato de Anthropic: quita temperature, top_p y top_k del JSON.
import json
import boto3
brt = boto3.client("bedrock-runtime", region_name="us-east-1")
body = {
"anthropic_version": "bedrock-2023-05-31",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Resume este informe en cinco puntos."}],
# sin temperature, top_p ni top_k
}
response = brt.invoke_model(
modelId="global.anthropic.claude-opus-4-7",
body=json.dumps(body),
)Con Converse, el muestreo va en inferenceConfig (temperature, topP) y lo que no es estándar, como top_k, en additionalModelRequestFields. Antes:
response = brt.converse(
modelId="us.anthropic.claude-opus-4-7",
messages=[{"role": "user", "content": [{"text": "Resume este informe."}]}],
inferenceConfig={"maxTokens": 1024, "temperature": 0.2, "topP": 0.9},
additionalModelRequestFields={"top_k": 50},
)Después: maxTokens se queda; temperature, topP y top_k se van.
response = brt.converse(
modelId="us.anthropic.claude-opus-4-7",
messages=[{"role": "user", "content": [{"text": "Resume este informe."}]}],
inferenceConfig={"maxTokens": 1024},
)Si additionalModelRequestFields llevaba otras claves además de top_k, conserva esas y quita solo top_k.
Tu código no envía temperature: Cursor, Cline, ComfyUI y gateways

El texto del error y el ID de modelo de la imagen son ilustrativos: los correctos son los que aparecen en el texto (temperature is deprecated for this model. y claude-opus-4-7, sin fecha).
Cuando tu código está limpio y el 400 sigue apareciendo, alguna capa intermedia añade el campo. Varios casos públicos lo muestran:
- Cursor con Bedrock. El 16 de abril de 2026, el equipo de Cursor respondió en su foro sobre Opus 4.7 en Bedrock: «This is a bug on our side». Seguían enviando
temperaturea Opus 4.7 en Bedrock. A finales de mayo, otros usuarios reportaron el mismo error con Opus 4.8 por Bedrock. - Cline. El issue #10573 de Cline («Error using Claude Opus 4.7 on Amazon Bedrock») seguía abierto el 21 de octubre de 2026.
- picoclaw. Enviaba siempre su valor por defecto, 0.7, a
claude-opus-4-7. - ComfyUI. El nodo de Anthropic enviaba siempre
temperature; el issue #13923 de ComfyUI se cerró como resuelto el 18 de mayo de 2026. - Proveedores «OpenAI Compatible». Si hablas con Claude a través de un gateway con formato OpenAI, el cliente puede rellenar
temperaturey el gateway lo copia al cuerpo de Anthropic.
El estado de cada herramienta cambia con sus versiones. Lo que puedes hacer es, por orden: actualizarla a la última versión, quitar el valor de temperature de su configuración o del perfil del modelo y, si ninguna de las dos cosas funciona, seguir o abrir el issue con el mensaje exacto.
Si la capa es tuya (un proxy, un gateway propio, un arnés de evaluación que fija temperature para comparar ejecuciones, una variable como MODEL_TEMPERATURE o un reintento que reconstruye la petición desde una plantilla vieja), registra justo antes del envío la lista de claves del JSON, sin contenido ni claves de API. La capa que añade temperature es la que tienes que corregir.
En Claude Code el síntoma suele ser top_p deprecated, con causas propias de versión y configuración: lo tienes en Claude Code con top_p deprecated.
¿Se arregla pasando a Opus 4.8, Opus 5 u Opus 5.5? No
Cambiar a un modelo más nuevo no quita la restricción: Anthropic la aplica a «Claude 4.7 and later models» y su guía de migración nombra expresamente a Opus 5.5. Usuarios de Cursor reportaron el mismo error con Opus 4.8 por Bedrock. Si vas a cambiar de modelo por otros motivos, la comparación está en Claude Sonnet 5.5 vs Opus 5.5, pero el campo tendrás que quitarlo igualmente.
Tampoco hace falta huir de Opus 4.7 por esto: claude-opus-4-7 sigue activo en la API de Claude, con retirada no antes del 16 de abril de 2027.
Solo los modelos anteriores a 4.7 quedan fuera de la regla. Los que siguen activos en la API de Claude son claude-opus-4-6 (no antes del 5 de febrero de 2027) y claude-sonnet-4-6 (no antes del 17 de febrero de 2027). Que acepten temperature se deduce del alcance de la regla, no de una prueba directa. Úsalos solo como puente si hoy no puedes dejar de enviar el campo (por ejemplo, una herramienta de terceros que aún no tiene arreglo) y fija una fecha para volver. Si dudas entre quedarte en 4.6 o subir, mira Claude Opus 4.7 vs Claude Opus 4.6. Bedrock y Google Cloud tienen sus propios calendarios de retirada.
Ten en cuenta que, con el SDK de Python 1.x, temperature= lanza TypeError sea cual sea el modelo, porque el fallo está en la firma de la función. Para mantener temperature en el puente necesitas extra_body:
message = client.messages.create(
model="claude-opus-4-6", # puente temporal, anterior a 4.7
max_tokens=1024,
messages=[{"role": "user", "content": "Resume este informe en cinco puntos."}],
extra_body={"temperature": 0.2},
)Si usas Claude Code para migrar el proyecto a Opus 5.5, la guía de Anthropic indica que /claude-api migrate this project to claude-opus-5-5 aplica estos cambios de parámetros en el código y te deja una lista de comprobaciones.
Qué usar en lugar de temperature: formato, variedad y effort
No hay un campo nuevo que haga lo mismo. Depende de para qué usabas temperature:
| Lo que buscabas con temperature | Qué usar ahora | Límite |
|---|---|---|
| Formato estable, JSON válido | Salidas estructuradas (structured outputs), instrucciones de formato en el system prompt, ejemplos y validación en tu código | El texto no será idéntico entre llamadas |
| Respuestas sobrias, sin adornos | Instrucciones explícitas de tono y extensión en el prompt | Depende de lo bien que describas el estilo |
| Variedad de ideas | Pedir varias alternativas distintas en una misma llamada, con criterios para diferenciarlas | Más tokens de salida |
| Más o menos razonamiento | effort (low, medium, high, xhigh, max) | No regula la aleatoriedad |
| Tests reproducibles | Comprobar estructura y propiedades del resultado, no el texto exacto | temperature = 0 tampoco lo garantizaba |
effort no es temperature con otro nombre. Controla cuánto razona el modelo y cuántos tokens gasta, no cuánto varía la respuesta. En Python se pasa como output_config={"effort": "medium"}. Opus 4.7 usa high por defecto; Opus 5.5, medium.
Para formato estricto suele bastar un contrato de salida en el prompt:
Devuelve exactamente un objeto JSON con las claves "causa", "arreglo" y "verificacion".
No escribas nada fuera del JSON.
Si no hay datos suficientes, pon "causa": "desconocida".Comprobar el arreglo en la misma ruta y descartar otros 400
Repite la misma petición que fallaba: mismo modelo, mismo proveedor (API de Claude, Bedrock o gateway), mismo prompt. Si cambias varias cosas a la vez, no sabrás cuál lo arregló.
- Confirma en el log que el JSON enviado ya no lleva
temperature,top_pnitop_k(en Converse, nitemperaturenitopPeninferenceConfig). - Lanza la petición una vez en la misma ruta y comprueba que la respuesta es correcta.
- Añade una comprobación que impida que el campo vuelva: un test sobre el diccionario de parámetros o una regla en el gateway que lo descarte para modelos 4.7 y posteriores.
Si después de quitar temperature recibes otro 400, probablemente es otro cambio de la misma migración:
- Thinking manual.
thinking: {"type": "enabled", "budget_tokens": N}se rechaza en Opus 4.7 y posteriores. La guía de Anthropic documenta el mensaje"thinking.type.enabled" is not supported for this model.Cámbialo porthinking: {"type": "adaptive"}y controla la profundidad coneffort. En Bedrock, Opus 4.7 solo admiteadaptive. - Prefill del asistente. Un último mensaje de
assistantescrito por ti para forzar el inicio de la respuesta también se rechaza. Usa salidas estructuradas o instrucciones en el system prompt.
Preguntas frecuentes
¿Sirve poner temperature a 0 o a 1 en Claude Opus 4.7?
0 no: en los modelos posteriores a Opus 4.6 la API solo acepta temperature: 1.0 y responde 400 a cualquier otro valor, también a 0.2 o 0.7. Con 1 el servidor la deja pasar porque es el valor por defecto, pero no cambia nada respecto a omitirla, y el SDK de Python 1.x la rechaza igualmente con TypeError. Omite el campo.
¿Por qué el SDK de Python de Anthropic da TypeError con temperature?
Porque desde la versión 1.0 el SDK eliminó temperature, top_p y top_k de messages.create(). El error ocurre en tu máquina, antes de cualquier petición, y no depende del modelo ni del valor. Bórralo; si necesitas el campo para un modelo anterior a 4.7, pásalo con extra_body.
¿effort sustituye a temperature en Claude?
No. effort regula la profundidad de razonamiento y el gasto de tokens. Para formato y estilo usa el prompt y las salidas estructuradas; para variedad, pide varias alternativas.
¿Qué modelos de Claude aceptan todavía temperature?
Los anteriores a Claude 4.7 que siguen activos, como claude-opus-4-6 y claude-sonnet-4-6. Que lo acepten se deduce de que la regla solo cubre «Claude 4.7 and later». Opus 4.8, Opus 5 y Opus 5.5 aplican la misma restricción que Opus 4.7, así que los modelos 4.6 solo sirven como solución temporal.
Fuentes7
Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 21 oct 2026.
Fuentes7
Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 21 oct 2026.
- 1.issue #2939 de picoclaw en GitHubgithub.com/sipeed/picoclaw/issues/2939
- 2.tabla de parámetros obsoletos de la APIplatform.claude.com/docs/en/about-claude/model-deprecations
- 3.referencia del endpoint Messages de la API de Claudeplatform.claude.com/docs/en/api/messages/create
- 4.ficha de Claude Opus 4.7 en la documentación de Amazon Bedrockdocs.aws.amazon.com/bedrock/latest/userguide/model-card-anthropic-claude-opus-4-7.html
- 5.foro sobre Opus 4.7 en Bedrockforum.cursor.com/t/opus-4-7-not-functioning-on-bedrock-because-of-temperature-deprecation-400/158212
- 6.issue #10573 de Clinegithub.com/cline/cline/issues/10573
- 7.issue #13923 de ComfyUIgithub.com/Comfy-Org/ComfyUI/issues/13923





