Получили 400 после перехода на версию API 2026-10-21? Первым делом проверьте, нет ли в запросе temperature, top_p или top_k. Anthropic выпустила эту версию 21 октября 2026 года. Запрос с любым из трёх параметров возвращает 400, и значение по умолчанию его не спасает. Запрос без них по этой причине не отклоняется. Лечится всё удалением полей. Ниже разобрано, что ещё поменялось в версии, как найти параметры в большом проекте и как остаться на старой версии, если без них не обойтись.
Что изменилось в версии 2026-10-21
В руководстве Anthropic по миграции на 2026-10-21 в разделе про Messages API перечислены три изменения, которые дают 400. Они действуют для запросов к Messages API, для подсчёта токенов и для каждого запроса внутри Message Batch, созданного с этой версией.
| Что в запросе | Что происходит в 2026-10-21 | Что делать |
|---|---|---|
temperature, top_p или top_k в запросе Messages или Message Batches | 400, даже со значением по умолчанию | Убрать три параметра |
Блок document прямо в сообщении с ролью assistant | 400. Документ внутри другого блока, например в результате web fetch, который вернул Claude, по-прежнему принимается | Отправлять документы в сообщениях user |
Блок text в сообщении user с непустым массивом citations, в том числе внутри search_result | 400 | Убрать citations из этих блоков |
С цитатами есть оговорка. Цитаты в текстовых блоках сообщений assistant, то есть в прошлых ответах Claude, которые вы отправляете обратно, по-прежнему принимаются. Настройка "citations": {"enabled": true} на документах и результатах поиска тоже работает.
Кроме Messages API, версия переименовала поля в Admin API и в Claude Enterprise Analytics API. Например, у ключей API вместо workspace_id теперь scope. Если ваш код читает эти ответы, сверьтесь с разделом про Admin API в руководстве.
Новые мажорные версии SDK и CLI меняют и то, как уходит ключ. В Python клиенты Anthropic и AsyncAnthropic (аргумент api_key, переменная ANTHROPIC_API_KEY) и AnthropicAWS (api_key, ANTHROPIC_AWS_API_KEY) шлют ключ в заголовке Authorization: Bearer, а не в X-Api-Key, и CLI ant делает то же. Исключения: AnthropicFoundry по-прежнему шлёт ключ как x-api-key, а AnthropicBedrockMantle и раньше слал bearer-токен. Для остальных языков руководство перечисляет те же случаи, с тем же исключением для клиентов Foundry. API принимает ключ в любом из двух заголовков, так что ломается не запрос, а прокси или middleware, которые читают только X-Api-Key.
Ещё одна правка касается кода, а не запросов: Text Completions API убран из SDK на TypeScript, Go, Java и Ruby и из CLI. В Python его удалили раньше, в v1.0 от 20 августа 2026 года. Вместо него нужен Messages API.
Как выглядит ошибка
Документация говорит коротко: запрос возвращает 400. Текста сообщения для этого случая нет ни на странице миграции, ни на странице ошибок, поэтому дословную строку мы не приводим и не выдумываем. Свои запросы с этой версией через шлюз мы не гоняли.
Форма ответа при ошибках у Claude API одна. По таблице кодов на странице ошибок 400 соответствует типу invalid_request_error, а тело ответа выглядит так:
{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "..."
},
"request_id": "req_..."
}
В Python SDK статус 400 превращается в anthropic.BadRequestError. В логах ищите статус 400 и request_id: он понадобится, если придётся писать в поддержку Anthropic. Если в message названо другое поле, а не sampling-параметр, сверьтесь с таблицей выше: документ в сообщении assistant и citations у пользователя дают тот же статус.
Кого это касается
Под удар попадают четыре случая.
- Прямые вызовы через curl,
requestsилиfetchс заголовкомanthropic-version: 2026-10-21. - Проекты, где SDK обновили до Python 2.0.0, TypeScript 1.0.0, C# 13.0.0, Go 2.0.0, Java 3.0.0, PHP 1.0.0 или Ruby 2.0.0: эти версии по умолчанию шлют 2026-10-21.
- Message Batches: параметры лежат внутри
paramsкаждого запроса. В Python type checker помечает такой ключ, но SDK, судя по руководству по миграции на v1, всё равно отправляет его, так что 400 вернёт уже API. - Код, который подставляет
temperatureвсегда: конфиги, обёртки, прокси. Документ прямо пишет, что ошибка приходит и со значением по умолчанию.
Не затронуты запросы без этих трёх полей. Они сэмплируют со значениями по умолчанию, включая temperature 1.0, ровно как запрос на 2023-06-01 без параметров. Не затронуты и те, кто остался на SDK прежней мажорной версии: по умолчанию она шлёт 2023-06-01. На Amazon Bedrock версия 2026-10-21 доступна только для моделей Claude 4.7 и новее, а для моделей 4.6 и ниже документ советует оставить версию, которую вы используете сейчас.
Как починить
Везде одно действие: убрать temperature, top_p и top_k из тела запроса. В последних мажорных версиях SDK и CLI этих параметров в типах уже нет. Для Python руководство по миграции на v1 (20 августа 2026) пишет, что передача temperature= вызывает TypeError.
В примерах стоит claude-sonnet-5. У Claudexia эта модель есть только в канале Premium, поэтому для ключа только с Cheap возьмите модель из прайса этого канала, например claude-opus-5-5.
Python
from anthropic import Anthropic
client = Anthropic(
api_key="sk_cdx_...",
base_url="https://api.claudexia.tech",
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude"}],
)
for block in message.content:
if block.type == "text":
print(block.text)
Раньше между max_tokens и messages могла стоять строка temperature=0.2. Её нужно удалить.
TypeScript
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.CLAUDEXIA_API_KEY,
baseURL: "https://api.claudexia.tech",
});
const message = await client.messages.create({
model: "claude-sonnet-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello, Claude" }],
});
for (const block of message.content) {
if (block.type === "text") {
console.log(block.text);
}
}
curl
curl https://api.claudexia.tech/v1/messages \
-H "x-api-key: $CLAUDEXIA_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'
Это пример из документации Anthropic, где мы заменили адрес и модель. Через шлюз с версией 2026-10-21 мы его не запускали.
Адрес шлюза и ключ
Для Anthropic SDK и Claude Code адрес шлюза Claudexia https://api.claudexia.tech, без /v1. Ключ начинается с sk_cdx_. Шлюз принимает заголовки x-api-key и Authorization: Bearer, то есть оба способа, которыми SDK Anthropic шлют ключ: прежние версии и клиент Foundry через x-api-key, новые стандартные клиенты через Authorization: Bearer. Как шлюз ведёт себя с версией 2026-10-21, мы не проверяли.
Регистрация идёт на странице регистрации: логин и пароль с подтверждением либо вход через Google, GitHub или Telegram. Поля email нет. Минимальное пополнение 1 доллар, оплата рублями через СБП, картой РФ или криптовалютой. Список моделей и цены живут на странице моделей.
Если вы ходите в шлюз не по Anthropic-формату, а через /v1/chat/completions с OpenAI-клиентом, то в статьях про перенос с OpenAI и про OpenAI-совместимую миграцию разобрано, как менять адрес и ключ. Как шлюз переводит temperature из OpenAI-запроса в Anthropic-запрос, мы не проверяли, поэтому ничего по этому поводу не утверждаем.
Если temperature задавал разнообразие или стабильность
Документ Anthropic описывает это прямо. Модели Claude 4.7 и новее уже принимали только значения по умолчанию, и для них поведение не меняется. На моделях, которые принимали другие значения, например на Claude Sonnet 4.6, запрос с пониженной temperature теряет этот эффект. Замены документ не называет: другой настройки, которая бы её заменила, нет. Выход один из двух: перестать отправлять параметр или оставить этот запрос на 2023-06-01.
Это касается и свежих моделей. По примечаниям к релизам, на Claude Opus 4.7 и Opus 4.8, на Claude Sonnet 5 (30 июня 2026) и на Claude Haiku 5.5 (7 октября 2026) значения не по умолчанию уже давали 400. Версия 2026-10-21 добавила ещё одно: теперь 400 даёт и значение по умолчанию.
Если вам нужно несколько разных ответов на одно задание, можно слать отдельные запросы с разными формулировками. Это наше предположение, не рекомендация Anthropic и не результат замеров.
Как остаться на 2023-06-01
Версия API задаётся тем, кто отправляет запрос. Без SDK это заголовок:
curl https://api.claudexia.tech/v1/messages \
-H "x-api-key: $CLAUDEXIA_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'
С SDK версию по умолчанию определяет мажорная версия пакета: если заголовок не переопределён, запросы идут с той версией API, которая была текущей при её выходе. Чтобы не перейти на 2026-10-21, не поднимайте SDK до Python 2.0.0 или TypeScript 1.0.0.
pip install "anthropic<2"
npm install @anthropic-ai/sdk@0
Для Python есть нюанс. В ветке 1.x параметров temperature, top_p, top_k в методах уже нет, но руководство по миграции на v1 для старых моделей, которые их ещё учитывают, предлагает передавать их через extra_body. Это работает только пока вы шлёте 2023-06-01: на 2026-10-21 по правилу из документа такой запрос тоже вернёт 400.
Заголовок можно задать и в самом Python SDK через default_headers, но документация предупреждает, что переопределение заголовков по умолчанию может дать неверные типы и другое непредсказуемое поведение. Мы так не проверяли.
Оговорка про долгосрочность. Anthropic рекомендует использовать последнюю версию API, а на странице версий (на 17 ноября 2026) даты отключения 2023-06-01 нет. Но это не обещание: надёжнее заложить время на переход. Чеклист по аналогии с выводом моделей из эксплуатации есть в статье про миграцию с отключённых моделей.
Как найти параметры в большом проекте
Начните с поиска по исходникам. Флаг -i ловит и topP, и TOP_P, а -I пропускает бинарные файлы.
grep -rnEiI 'temperature|top_?p|top_?k' --exclude-dir={node_modules,.git,.venv} .
Что проверить среди результатов:
- Вызовы Claude. Параметры других провайдеров, например OpenAI, трогать не нужно: у них свои правила.
- Конфиги и переменные окружения вроде
LLM_TEMPERATURE, которые подставляются в запрос. - Обёртки, прокси и middleware, которые добавляют параметр ко всем запросам.
- Файлы и код для Message Batches: параметр лежит в
paramsкаждого запроса. - Тесты и фикстуры с готовыми телами запросов.
Поле temperature внутри схемы инструмента или в тексте промпта параметром запроса не считается. Это просто совпадение по слову.
Заодно найдите места, где версия задана вручную:
grep -rnEiI 'anthropic-version|anthropic_version' --exclude-dir={node_modules,.git,.venv} .
Если в проекте есть вызовы со structured outputs или tool use, посмотрите их отдельно. Подробности по этим форматам в статьях про JSON и structured outputs и про function calling.
Как проверить, какую версию вы шлёте
Установленная версия SDK подсказывает только значение по умолчанию. Заголовок можно переопределить для всего клиента (default_headers) или для отдельного запроса (extra_headers), поэтому после проверки версии поищите такие переопределения командой из предыдущего раздела. Версия пакета в Python:
python -c "import anthropic; print(anthropic.__version__)"
В Node.js:
npm ls @anthropic-ai/sdk
Документация называет первые версии с 2026-10-21: Python 2.0.0, TypeScript 1.0.0, C# 13.0.0, Go 2.0.0, Java 3.0.0, PHP 1.0.0, Ruby 2.0.0, ant CLI 2.0.0. Версия ниже значит, что по умолчанию идёт 2023-06-01.
Для прямых запросов смотрите заголовок anthropic-version в коде и в настройках HTTP-клиента. Если между вами и API стоит прокси, версию определяет заголовок, который до него дошёл, поэтому проверьте и его логи. Общий разбор других ответов API с кодами 4xx и 5xx лежит в статьях про ошибки Claude API и про расшифровку этих ошибок.
Частые вопросы
Почему 400, если я передал значение по умолчанию?
В версии 2026-10-21 проверка идёт по наличию параметра, а не по значению. Документ формулирует это прямо: 400 приходит даже при значении по умолчанию. Поэтому temperature=1 тоже нужно убрать.
Это та же ошибка, что «temperature and top_p cannot both be specified»?
Нет, это более старый случай. По примечаниям к релизам от 5 августа 2025, Claude Opus 4.1 не принимает одновременно temperature и top_p. В трекере проекта BrowserOS (issue 208, 26 ноября 2025) та же ситуация на Claude Sonnet 4.5 (снимок от 29 сентября 2025) описана строкой «temperature and top_p cannot both be specified for this model. Please use only one.» В документации Anthropic такой формулировки мы не нашли. В 2026-10-21 запрещён уже каждый из трёх параметров по отдельности.
Что будет с запросами, где этих параметров нет?
Ничего особенного: они сэмплируют со значениями по умолчанию, temperature равна 1.0. Так же было на 2023-06-01 без параметров.
Можно ли ничего не менять и остаться на старой версии?
Документ допускает оставить запрос на 2023-06-01, а страница версий не называет даты её отключения. При этом Anthropic рекомендует последнюю версию. Сколько запаса оставить, решаете вы.
Пропускает ли шлюз Claudexia эти параметры?
Мы не знаем. Запросы с версией 2026-10-21 через шлюз мы не прогоняли: не можем сказать ни что он пропускает параметры, ни что отклоняет, ни что удаляет. Самый надёжный путь не зависит от шлюза: уберите параметры из запроса.