Saltar al contenido principal

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.

LaoZhang AI TeamPublicadoActualizado 11 min de lectura
En esta página
Esquema de Claude Opus 4.7 con temperature, top_p y top_k retirados de la petición y las capas que pueden volver a añadirlos

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:

json
{"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 vesDónde naceQué hacer primero
TypeError: ... unexpected keyword argument 'temperature'SDK de Python 1.x, antes de enviarBorrar el argumento de la llamada o del diccionario de parámetros
400 temperature is deprecated for this model. desde tu códigoTu código, un helper o el SDK 0.xQuitar el campo en la capa que construye el JSON
El mismo 400 en Cursor, Cline, ComfyUI, picoclaw o vía BedrockLa herramienta o el adaptadorActualizar la herramienta, quitar el valor de su configuración o seguir el issue
400 que menciona thinking después de quitar temperatureOtro cambio de la misma migraciónVer 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:

CampoSe aceptaDevuelve 400
temperatureSolo 1.0, el valor por defecto, por compatibilidadCualquier otro: 0, 0.2, 0.7…
top_pValores iguales o mayores que 0.99, por compatibilidadCualquier valor menor, como 0.9
top_kNingunoCualquier 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 = 0 nunca 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

Comparación del JSON de la petición antes y después de quitar temperature, top_p y top_k en el SDK de Python, TypeScript, Bedrock y un gateway

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:

python
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:

python
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:

python
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:

ts
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.

python
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:

python
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.

python
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

Mapa de las capas que pueden añadir temperature a una petición: SDK, Bedrock, gateway, plugin del IDE y arnés de evaluación

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 temperature a 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 temperature y 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:

python
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 temperatureQué usar ahoraLímite
Formato estable, JSON válidoSalidas estructuradas (structured outputs), instrucciones de formato en el system prompt, ejemplos y validación en tu códigoEl texto no será idéntico entre llamadas
Respuestas sobrias, sin adornosInstrucciones explícitas de tono y extensión en el promptDepende de lo bien que describas el estilo
Variedad de ideasPedir varias alternativas distintas en una misma llamada, con criterios para diferenciarlasMás tokens de salida
Más o menos razonamientoeffort (low, medium, high, xhigh, max)No regula la aleatoriedad
Tests reproduciblesComprobar estructura y propiedades del resultado, no el texto exactotemperature = 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ó.

  1. Confirma en el log que el JSON enviado ya no lleva temperature, top_p ni top_k (en Converse, ni temperature ni topP en inferenceConfig).
  2. Lanza la petición una vez en la misma ruta y comprueba que la respuesta es correcta.
  3. 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 por thinking: {"type": "adaptive"} y controla la profundidad con effort. En Bedrock, Opus 4.7 solo admite adaptive.
  • Prefill del asistente. Un último mensaje de assistant escrito 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.

  1. 1.issue #2939 de picoclaw en GitHubgithub.com/sipeed/picoclaw/issues/2939
  2. 2.tabla de parámetros obsoletos de la APIplatform.claude.com/docs/en/about-claude/model-deprecations
  3. 3.referencia del endpoint Messages de la API de Claudeplatform.claude.com/docs/en/api/messages/create
  4. 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. 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. 6.issue #10573 de Clinegithub.com/cline/cline/issues/10573
  7. 7.issue #13923 de ComfyUIgithub.com/Comfy-Org/ComfyUI/issues/13923