Ошибка temperature в Claude Opus 4.7 и новее: 400 и TypeError
Opus 4.7 и новее, включая 5.5, отвечают 400 на temperature, отличную от 1.0, top_p ниже 0.99 и любой top_k; Python SDK 1.x — TypeError. Удалите поле.
Содержание

Если запрос к Claude Opus 4.7 падает из-за temperature, безопасного значения не существует: поле нужно убрать из запроса. Начиная с Opus 4.7 модели Claude отвечают ошибкой 400 на temperature, top_p и top_k со значением, отличным от значения по умолчанию, а Python SDK версии 1.0 и новее вообще не принимает эти аргументы и выбрасывает TypeError ещё до отправки. Правило распространяется и на Opus 4.8, Opus 5 и Opus 5.5, поэтому смена модели на более новую ошибку не уберёт.
Чинить нужно в том слое, который добавляет поле. Это может быть ваш код, общий вспомогательный модуль, адаптер Amazon Bedrock, OpenAI-совместимый шлюз или инструмент вроде Cursor, Cline и ComfyUI, который подставляет temperature сам.
Три вида ошибки temperature: TypeError, 400 от API и сбой в инструменте
Сначала определите, кто именно отказывает: SDK у вас на машине, сервер Anthropic или AWS, либо инструмент, который пересказывает ответ сервера.
Python SDK 1.x, исключение до отправки. Запрос в сеть не уходит, ответ сервера здесь ни при чём:
TypeError: Messages.create() got an unexpected keyword argument 'temperature'То же сообщение появляется для top_p и top_k, причём даже при temperature=1.0. Anthropic прямо пишет в таблице устаревших параметров, что Python SDK v1.0 и новее убрал temperature, top_p и top_k из сигнатуры и их передача вызывает TypeError.
Ответ API с кодом 400. Так выглядит ответ сервера, который пользователи приводят в публичных логах (issue picoclaw #2939, модель claude-opus-4-7, клиент по умолчанию отправлял temperature: 0.7):
{"error":{"code":"invalid_request_error","message":"temperature is deprecated for this model.","type":"invalid_request_error"}}Сообщение внутри инструмента. ComfyUI, Cline и Cursor показывают тот же серверный текст в своей обёртке, например:
`temperature` is deprecated for this model. (Type: invalid_request_error)Слово «deprecated» здесь сбивает с толку. Обычно «устаревший» означает предупреждение: работает, но скоро перестанет. На Claude 4.7 и более новых моделях это уже отказ: запрос с нестандартным значением не выполняется. Сообщения про top_p и top_k в публичных отчётах встречаются реже; по аналогии они, скорее всего, называют соответствующий параметр, но дословно такой текст не опубликован.
| Что вы видите | Где возникает | Что это значит | Где чинить |
|---|---|---|---|
TypeError: ... unexpected keyword argument 'temperature' | Python SDK 1.0 и новее, локально | SDK не знает такого аргумента, запроса не было | Ваш вызов messages.create() или словарь параметров |
HTTP 400, temperature is deprecated for this model. | Сервер Claude API | Поле дошло до модели 4.7 или новее | Слой, который собирает тело запроса |
| Та же ошибка через Bedrock | Amazon Bedrock | Адаптер или ваш код кладёт поле в тело запроса Bedrock | Тело InvokeModel или inferenceConfig в Converse |
| Ошибка в Cursor, Cline, ComfyUI, агентном фреймворке | Инструмент поверх API | Инструмент сам добавляет temperature | Настройки или версия инструмента |
temperature: 0 или 1.0 не помогут: поле нужно удалить
Ни одно «правильное» число проблему не решает. Таблица устаревших параметров Anthropic формулирует правило так: для temperature, top_p и top_k значение, отличное от значения по умолчанию, возвращает 400 на моделях Claude 4.7 и новее, рекомендованная замена — не передавать их и управлять поведением через промпт. Точные допустимые значения приведены в справочнике Messages API для моделей, выпущенных после Claude Opus 4.6:
| Параметр | Что сервер принимает | Что возвращает 400 |
|---|---|---|
temperature | Только 1.0 (значение по умолчанию), ради обратной совместимости | Любое другое значение: 0, 0.2, 0.7 |
top_p | Значения от 0.99 и выше | Всё, что меньше 0.99 |
top_k | Ничего | Любое значение |
Отсюда практические следствия:
temperature: 0даёт ту же ошибку 400. К тому же, как отмечает Anthropic, и на прежних моделях ноль не гарантировал одинаковых ответов.temperature: 1сервер примет, но Python SDK 1.x отклоняет и его: аргумента в сигнатуре больше нет, иTypeErrorвозникает раньше, чем запрос дойдёт до API.- Отдельные модели строже общего справочника. Руководство по миграции на Claude Haiku 5.5 требует для
top_pровно0.99(значение1отклоняется) и не допускает одновременной передачиtemperatureиtop_p. Значение, которое проходит на одной модели, может не пройти на другой. - Поэтому самый надёжный вариант, который рекомендуют и Anthropic, и AWS, — не отправлять ни одно из трёх полей. Тогда не важно, какие значения принимает конкретная модель и что подставляет SDK, шлюз или платформа.
Переход на Opus 4.8, Opus 5 или 5.5 ошибку не убирает
Ограничение действует для всех моделей начиная с Claude 4.7. Руководство по миграции на Opus 5.5 прямо называет «Claude Opus 4.7 и более поздние модели, включая Claude Opus 5.5». Пользователи Cursor в конце мая 2026 года получали ту же ошибку с Opus 4.8 через Bedrock. Если инструмент или шлюз продолжает слать temperature, новая модель упадёт так же.
Сама claude-opus-4-7 активна: по таблице жизненного цикла Anthropic её вывод из эксплуатации — не раньше 16 апреля 2027 года. Уходить с неё из-за этой ошибки не нужно.
Модели старше 4.7 под правило не попадают: claude-opus-4-6 (активна как минимум до 5 февраля 2027 года) и claude-sonnet-4-6 (до 17 февраля 2027 года). Это временный мост на случай, когда прямо сейчас нельзя заставить инструмент перестать отправлять поле. То, что они по-прежнему принимают нестандартную temperature, следует из формулировки «4.7 и новее», отдельно не проверялось. У Bedrock и Google Cloud собственные графики вывода моделей. Взвесить откат помогут сравнение Claude Opus 4.7 и Opus 4.6 и, если выбираете между текущими моделями, разбор Claude Sonnet 5.5 и Opus 5.5.
Как удалить temperature: Python SDK, TypeScript и Amazon Bedrock
Поле убирают целиком, вместе с top_p и top_k. Ниже примеры «до/после» для основных путей. В них claude-opus-4-7 — ID модели в Claude API; у Bedrock свои ID, о них в отдельном разделе ниже.

На схеме текст ошибки и ID модели условные; верные приведены в статье: temperature is deprecated for this model. и claude-opus-4-7.
Python SDK 1.x: TypeError до отправки запроса
Локальный тест с SDK 1.17.0 (последняя версия на PyPI на 21 октября 2026 года; 1.0.0 вышла 20 августа 2026 года) и mock-сервером вместо настоящего API показал следующее: temperature=0.2, top_p=0.9, top_k=5 и даже temperature=1.0 дают TypeError, HTTP-запрос не отправляется. Реальный ответ Anthropic в этом тесте не проверялся.
До:
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-opus-4-7",
max_tokens=1024,
temperature=0.2, # TypeError в SDK 1.x, 400 от API в SDK 0.x
messages=[{"role": "user", "content": "Опиши причину сбоя в трёх пунктах."}],
)После:
message = client.messages.create(
model="claude-opus-4-7",
max_tokens=1024,
messages=[{"role": "user", "content": "Опиши причину сбоя в трёх пунктах."}],
)Часто аргументы приходят из общего словаря настроек: client.messages.create(**params). Тогда чистите сам словарь:
SAMPLING_FIELDS = {"temperature", "top_p", "top_k"}
clean_params = {k: v for k, v in params.items() if k not in SAMPLING_FIELDS}
message = client.messages.create(**clean_params)Обходной путь через extra_body не годится. В том же тесте extra_body={"temperature": 0.2} миновал проверку сигнатуры, и поле ушло на сервер, где на модели 4.7 и новее его отклонят с 400. Если в коде есть extra_body, уберите temperature, top_p и top_k и оттуда.
Откат на SDK 0.x тоже не помогает: версия 0.99.0 в том же тесте отправила все три поля как есть, то есть TypeError просто сменится ошибкой 400 от сервера.
TypeScript SDK: код компилируется, ошибку возвращает сервер
По словам Anthropic, большинство SDK, кроме Python 1.x, оставили эти поля в типах запроса, чтобы старый код продолжал проходить проверку типов. Поэтому в TypeScript компилятор молчит, а 400 приходит уже от API. Исправление то же:
const message = await client.messages.create({
model: "claude-opus-4-7",
max_tokens: 1024,
// temperature: 0.2, удалить
// top_p: 0.9, удалить
messages: [{ role: "user", content: "Кратко опиши инцидент." }],
});Amazon Bedrock: InvokeModel и поля Converse
Карточка модели Claude Opus 4.7 в документации AWS говорит то же самое: начиная с Opus 4.7 temperature, top_p и top_k больше не поддерживаются, рекомендовано не передавать их совсем. ID модели в Bedrock пишутся без даты:
anthropic.claude-opus-4-7;- географические профили
us.anthropic.claude-opus-4-7,eu.anthropic.claude-opus-4-7,jp.anthropic.claude-opus-4-7,au.anthropic.claude-opus-4-7; - глобальный профиль
global.anthropic.claude-opus-4-7.
При вызове InvokeModel тело запроса имеет формат Anthropic Messages, и параметры лежат на верхнем уровне:
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": "Кратко опиши инцидент."}],
# "temperature": 0.2, удалить
# "top_p": 0.9, удалить
# "top_k": 5, удалить
}
response = brt.invoke_model(
modelId="global.anthropic.claude-opus-4-7",
body=json.dumps(body),
)В Converse API те же параметры называются иначе и разложены по двум местам: temperature и topP находятся в inferenceConfig, а top_k — в additionalModelRequestFields. Удалите все три, maxTokens оставьте.
До:
response = brt.converse(
modelId="global.anthropic.claude-opus-4-7",
messages=[{"role": "user", "content": [{"text": "Кратко опиши инцидент."}]}],
inferenceConfig={"maxTokens": 1024, "temperature": 0.2, "topP": 0.9},
additionalModelRequestFields={"top_k": 5},
)После:
response = brt.converse(
modelId="global.anthropic.claude-opus-4-7",
messages=[{"role": "user", "content": [{"text": "Кратко опиши инцидент."}]}],
inferenceConfig={"maxTokens": 1024},
)Если в additionalModelRequestFields есть другие поля, оставьте их и уберите только top_k.
OpenAI-совместимый шлюз или прокси
Через OpenAI-совместимый шлюз temperature попадает в запрос двумя путями: его передаёт ваш клиент в chat.completions.create(...), или шлюз сам подставляет значение по умолчанию при переводе запроса в формат Anthropic. В первом случае удалите аргумент из вызова. Во втором ищите в настройках шлюза значения по умолчанию для модели или добавьте правило, которое вырезает поля перед отправкой. Удобно перечислить явно только старые модели, которым поле ещё нужно, а для остальных убирать его всегда:
SAMPLING_FIELDS = ("temperature", "top_p", "top_k")
LEGACY_SAMPLING_MODELS = ("claude-opus-4-6", "claude-sonnet-4-6")
def strip_sampling(body: dict) -> dict:
model = body.get("model", "")
if any(legacy in model for legacy in LEGACY_SAMPLING_MODELS):
return body
return {k: v for k, v in body.items() if k not in SAMPLING_FIELDS}Такое правило не придётся дописывать с выходом каждой новой модели.
В коде нет temperature, но ошибка есть: Cursor, Cline, ComfyUI и шлюзы
Если в вашем коде поля нет, а сервер его видит, temperature добавляет кто-то между вызовом и сетью.

На схеме текст ошибки и ID модели условные; верные приведены в статье: temperature is deprecated for this model. и claude-opus-4-7.
Задокументированные случаи из публичных отчётов:
| Инструмент | Что происходило | Статус по отчёту |
|---|---|---|
| Cursor с Opus 4.7 через Bedrock | 16 апреля 2026 года сотрудник Cursor признал: «This is a bug on our side», клиент продолжал отправлять temperature | В конце мая 2026 года та же ошибка появилась у пользователей Opus 4.8 через Bedrock |
| Cline, issue #10573 | Opus 4.7 через Amazon Bedrock: «temperature is deprecated» | Открыт |
| picoclaw, issue #2939 | Клиент всегда отправлял свои 0.7 | Закрыт ботом за неактивностью, исправление не подтверждено |
| ComfyUI, issue #13923 | Встроенный узел Anthropic всегда передавал temperature | Закрыт как исправленный 18 мая 2026 года |
| OpenAI-совместимые провайдеры | 20 мая 2026 года на GitHub сообщали об ошибке про устаревшую temperature через провайдер «OpenAI Compatible» | Зависит от конкретного шлюза |
Статус каждого инструмента меняется с обновлениями. Порядок действий: обновите инструмент; если не помогло, найдите в его настройках модели значение temperature и очистите его; если поле задано жёстко, откройте issue или следите за существующим, а пока используйте модель старше 4.7.
Помимо инструментов, поле подмешивают:
- общая обёртка над SDK с «параметрами генерации по умолчанию»;
- переменные окружения вроде
MODEL_TEMPERATUREили конфиги с пресетами моделей; - скрипты и стенды для оценки (eval), где
temperatureфиксировали ради сравнимости прогонов; - middleware повторных попыток, которое берёт старый шаблон тела запроса;
- адаптер Bedrock, который сливает настройки проекта с параметрами конкретного запроса.
Чтобы найти виновника, смотрите на итоговый JSON запроса в последней точке перед отправкой: в шлюзе, прокси или в собственном логе. Достаточно записать ID модели и список ключей верхнего уровня, без промпта и ключей API. В чистом запросе есть model, max_tokens, messages и нет temperature, top_p, top_k.
Если похожее сообщение про top_p выдаёт Claude Code, это отдельный случай со своими настройками: см. разбор ошибки top_p deprecated в Claude Code.
Чем заменить temperature: формат, разнообразие, глубина рассуждения
Поля, которое делало бы то же, что temperature, в API нет. Сначала сформулируйте, ради чего вы её выставляли, и подберите замену под эту задачу.
| Для чего была temperature | Чем заменить | Ограничение |
|---|---|---|
| Стабильный формат, строгий JSON | Структурированный вывод (output_config={"format": ...}), схема в промпте, примеры, валидация ответа | Формат становится предсказуемым, текст ответа — нет |
| Повторяемость для тестов и eval | Тот же промпт и маршрут, проверка свойств ответа вместо сравнения строк | Одинаковых ответов не гарантировал и temperature: 0 |
| Разнообразие вариантов | Попросить несколько вариантов в одном ответе с критериями различия | Расходует больше выходных токенов |
| Глубина рассуждения, расход токенов | effort | Управляет рассуждением, а не случайностью |
Для строгого JSON без структурированного вывода хватает ясной инструкции:
Верни один JSON-объект с ключами "root_cause", "fix" и "verification".
Не добавляй текст вне JSON.
Если данных недостаточно, укажи в "root_cause" значение "unknown".effort — не переименованная temperature. По руководству Anthropic, это единственный параметр запроса, который управляет глубиной рассуждения: уровни low, medium, high, xhigh и max, передаются как output_config={"effort": "medium"}. Он влияет на то, сколько модель думает и сколько токенов тратит, но не делает ответ более или менее случайным.
Проверка исправления на том же маршруте
Исправление подтверждено, когда тот же запрос проходит по тому же пути без других изменений:
- Та же модель, тот же провайдер (Claude API, Bedrock или шлюз), тот же промпт.
- В итоговом JSON запроса нет
temperature,top_pиtop_k, включаяextra_body,inferenceConfigиadditionalModelRequestFields. - Один повтор запроса, и он проходит.
- Есть защита от возврата поля: тест или правило в шлюзе, которое проверяет ключи тела запроса.
Если одновременно поменять модель, провайдера и промпт, успешный ответ ничего не докажет: непонятно, что именно помогло.
После удаления temperature тот же запрос может упасть с другой ошибкой 400 из той же миграции. thinking: {"type": "enabled", "budget_tokens": N} на Opus 4.7 и новее отклоняется: нужен адаптивный режим ("adaptive"), глубина регулируется через effort. Заполненный ответ ассистента в конце messages (prefill) тоже отклоняется, подробности в разборе ошибки 400 prefill в Claude.
В Claude Code есть встроенный навык для такой миграции: команда /claude-api migrate this project to claude-opus-5-5, по описанию Anthropic, меняет ID модели и вносит нужные изменения параметров. Результат всё равно стоит проверить по списку выше.
Вопросы об ошибке temperature в Claude Opus 4.7
Почему запрос с temperature раньше работал, а теперь возвращает 400?
Изменилась модель, а не ваш код. Модели до Opus 4.7 принимали нестандартную temperature, модели начиная с 4.7 её отклоняют. Ошибка появляется, когда вы, ваш инструмент или шлюз переключаетесь на Opus 4.7 или новее, а старое значение остаётся в запросе. Второй вариант — обновление Python SDK до 1.x: тогда вместо 400 вы видите TypeError.
Откуда TypeError, если запрос к API ещё не отправлялся?
Python SDK 1.0 и новее убрал temperature, top_p и top_k из сигнатуры messages.create(). Python отклоняет неизвестный именованный аргумент до любого сетевого вызова. Удалите аргумент; обход через extra_body только перенесёт ошибку на сервер.
Почему Cursor или Cline падают с ошибкой temperature, если я её не задавал?
Инструмент сам добавляет temperature в запрос. Для Cursor с Opus 4.7 через Bedrock это подтвердил сотрудник Cursor, для Cline открыт issue #10573. Обновите инструмент, проверьте настройки модели в нём, а пока проблема не исправлена, используйте модель старше 4.7.
Есть ли в Claude Opus 4.7 замена параметру temperature?
Прямой замены нет. Формат задают структурированным выводом, схемой в промпте и валидацией, разнообразие — просьбой выдать несколько вариантов, глубину рассуждения — параметром effort. Anthropic рекомендует управлять поведением модели через промпт.
Источники4
Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 21 окт. 2026 г..
Источники4
Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 21 окт. 2026 г..
- 1.Cursor с Opus 4.7 через Bedrockforum.cursor.com/t/opus-4-7-not-functioning-on-bedrock-because-of-temperature-deprecation-400/158212
- 2.Cline, issue #10573github.com/cline/cline/issues/10573
- 3.picoclaw, issue #2939github.com/sipeed/picoclaw/issues/2939
- 4.ComfyUI, issue #13923github.com/Comfy-Org/ComfyUI/issues/13923





