Перейти к основному содержанию

Ошибка 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. Удалите поле.

LaoZhang AI TeamОпубликованоОбновлено 11 мин чтения
Содержание
Схема исправления ошибки temperature в Claude Opus 4.7: удаление параметров сэмплирования из запроса и проверка на том же маршруте

Если запрос к 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):

json
{"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 или новееСлой, который собирает тело запроса
Та же ошибка через BedrockAmazon 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, о них в отдельном разделе ниже.

Тело запроса к Claude Opus 4.7 до и после удаления параметров temperature, top_p и top_k в Python SDK, TypeScript, Amazon Bedrock и шлюзе

На схеме текст ошибки и 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 в этом тесте не проверялся.

До:

python
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": "Опиши причину сбоя в трёх пунктах."}],
)

После:

python
message = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Опиши причину сбоя в трёх пунктах."}],
)

Часто аргументы приходят из общего словаря настроек: client.messages.create(**params). Тогда чистите сам словарь:

python
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. Исправление то же:

ts
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, и параметры лежат на верхнем уровне:

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": "Кратко опиши инцидент."}],
    # "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 оставьте.

До:

python
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},
)

После:

python
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. В первом случае удалите аргумент из вызова. Во втором ищите в настройках шлюза значения по умолчанию для модели или добавьте правило, которое вырезает поля перед отправкой. Удобно перечислить явно только старые модели, которым поле ещё нужно, а для остальных убирать его всегда:

python
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 добавляет кто-то между вызовом и сетью.

Карта слоёв, которые могут добавить temperature в запрос к Claude Opus 4.7: SDK, Amazon Bedrock, шлюз, плагин IDE и скрипт для оценки

На схеме текст ошибки и ID модели условные; верные приведены в статье: temperature is deprecated for this model. и claude-opus-4-7.

Задокументированные случаи из публичных отчётов:

ИнструментЧто происходилоСтатус по отчёту
Cursor с Opus 4.7 через Bedrock16 апреля 2026 года сотрудник Cursor признал: «This is a bug on our side», клиент продолжал отправлять temperatureВ конце мая 2026 года та же ошибка появилась у пользователей Opus 4.8 через Bedrock
Cline, issue #10573Opus 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"}. Он влияет на то, сколько модель думает и сколько токенов тратит, но не делает ответ более или менее случайным.

Проверка исправления на том же маршруте

Исправление подтверждено, когда тот же запрос проходит по тому же пути без других изменений:

  1. Та же модель, тот же провайдер (Claude API, Bedrock или шлюз), тот же промпт.
  2. В итоговом JSON запроса нет temperature, top_p и top_k, включая extra_body, inferenceConfig и additionalModelRequestFields.
  3. Один повтор запроса, и он проходит.
  4. Есть защита от возврата поля: тест или правило в шлюзе, которое проверяет ключи тела запроса.

Если одновременно поменять модель, провайдера и промпт, успешный ответ ничего не докажет: непонятно, что именно помогло.

После удаления 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 г..

  1. 1.Cursor с Opus 4.7 через Bedrockforum.cursor.com/t/opus-4-7-not-functioning-on-bedrock-because-of-temperature-deprecation-400/158212
  2. 2.Cline, issue #10573github.com/cline/cline/issues/10573
  3. 3.picoclaw, issue #2939github.com/sipeed/picoclaw/issues/2939
  4. 4.ComfyUI, issue #13923github.com/Comfy-Org/ComfyUI/issues/13923
Обработка Claude API 500: ограниченные повторы, отложенная задача и поддержка
Claude и Anthropic

Ошибка 500 в Claude API: повторы, request_id и обращение в поддержку

Если Claude API вернул 500 api_error, сохраните request_id и разрешите ограниченные повторы с увеличением паузы. При постоянном сбое завершите запрос с понятной ошибкой или отложите задачу, сохранив данные для поддержки.

7 мин
Перегрузка Claude API 529, ограниченные повторы и данные запроса для диагностики
Claude и Anthropic

Claude API: ошибка 529 overloaded_error и настройка повторов

529 overloaded_error означает временную перегрузку Claude API. Для восстановления проверьте статус нужного сервиса, ограничьте повторные попытки и снизьте параллелизм. Если запрос снова не выполнен, завершите его понятным результатом и сохраните request_id.

8 мин