К содержимому
Блог

Claude Opus 5 через API: когда флагман оправдан

Claude Opus 5 через API: когда флагман оправдан

Claude Opus 5 вызывается через Relay по идентификатору claude-opus-5, в протоколах Anthropic Messages и OpenAI Chat Completions. Он оправдан там, где модели нужно удержать много связей сразу, а ошибка дорого стоит. Для разметки, переписывания текста и однотипного кода по образцу хватает уровня ниже.

Коротко

  • Opus 5 вышел 24 июля 2026. Сейчас Anthropic относит его к legacy, актуальна Opus 5.5, обе модели есть в каталоге Relay.

  • Берите Opus 5 для задач, которые держатся на связях между частями системы, при дорогой ошибке.

  • Откат на Opus 4.8 при срабатывании защитного классификатора на API Anthropic включается отдельно. Не рассчитывайте на молчаливую подмену модели: обрабатывайте отказ в своём коде.

  • Дешевле всего экономить ролью модели, длиной ответа и лимитом ключа.

Где Opus 5 стоит в линейке на 14 октября 2026?

Anthropic выпустил Opus 5 24 июля 2026. По его заявлению, модель по интеллекту близка к Fable 5 при половинной цене; бенчмарки в анонсе вендор запускал сам, это его результаты. Через два месяца, 22 сентября, вышла Opus 5.5, и на страницах Anthropic Opus 5 теперь помечена legacy: работает, по текущему плану её не отключат раньше 24 июля 2027, но переходить рекомендуют на 5.5.

В каталоге Relay активны обе. Зачем тогда Opus 5? Затем, что 5.5 ломает четыре вещи в уже работающем коде. Нельзя отключить thinking. Принудительный tool_choice с типом any или tool даёт 400. Блоки thinking привязаны к модели и диалогу. Инструмент computer_20251124 не принимается. Плюс effort по умолчанию на 5.5 равен medium, а на Opus 5 запрос без него шёл на high. Если ваш код живёт на 5, а переписывать его пока рано, остаться на claude-opus-5 разумно. Подробнее о разнице ревизий в статье про выбор версии Opus.

Каталог моделей

Claude Opus 5.50,86 $ за 1 млн входных токенов

Контекст у обеих миллион токенов, ответ до 128 тысяч, протоколы openai_chat, anthropic_messages и openai_responses. Цену и статус смотрите в карточках и в каталоге.

Для каких задач нужен именно Opus 5?

Три признака задачи, при которых мы взяли бы Opus, а не уровень ниже:

  1. Первый шаг неочевиден. Вы не можете расписать план заранее, модели придётся его найти.

  2. Части системы связаны. Правка в одном месте обязана согласоваться с десятком других.

  3. Ошибку заметят поздно или дорого. Сломанная миграция, неверная формулировка в договоре, плавающий дефект, который тесты ловят раз из десяти.

Подходящие примеры: рефакторинг, который проходит через десяток файлов и общие интерфейсы; поиск причины гонки без гипотезы; планирование агента, которому предстоит несколько часов решать, что делать дальше; вычитка длинной спецификации, где противоречие между первым и последним разделами и есть искомое.

Совпал один признак, начните с Sonnet и посмотрите, как он справится. Совпали все три, берите Opus сразу, а не после двух неудачных попыток.

Где Opus 5 избыточен?

Когда задачу можно описать формулой «возьми это и преврати в то». Разбор логов, конвертация форматов, правка текста, разметка обращений, ответы по документации с готовой цитатой. Здесь дорогая модель вряд ли даст больше, а счёт выше. Для таких шагов ставьте Sonnet или недорогую модель, а Opus оставьте на планирование и итоговую проверку.

Как отправить первый запрос к Opus 5?

Нужны ключ из кабинета и идентификатор из каталога. Messages API принимает адрес без /v1: Anthropic SDK достроит путь сам.

bash
curl https://relay-llm.ru/v1/messages \
  -H "x-api-key: $RELAY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Опиши план рефакторинга модуля оплаты по списку файлов ниже"}]
  }'

Тот же вызов в формате Chat Completions: другой путь, другая шапка авторизации, тот же ключ.

bash
curl https://relay-llm.ru/v1/chat/completions \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Опиши план рефакторинга модуля оплаты по списку файлов ниже"}]
  }'

Python-клиент Anthropic настраивается так:

python
import os

import anthropic

client = anthropic.Anthropic(
    base_url="https://relay-llm.ru",
    api_key=os.environ["RELAY_API_KEY"],
)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Найди противоречия в спецификации ниже"}],
)
print(message.content[0].text)

Формат полей, ответа и ошибок описан в документации Messages API и Chat Completions. Первый запрос лучше делать с небольшим max_tokens: он влияет на сумму, которую шлюз удерживает на балансе до ответа.

Есть тонкость, на которой спотыкаются при сравнении ревизий. Поле model в ответе Relay возвращает то значение, которое вы отправили, поэтому по нему ответившую ревизию не определить. x-request-id из заголовка найдёт запись в журнале запросов: в ней модель из вашего запроса, ключ, токены, стоимость и пометка «резервный», если запрос ушёл на запасной маршрут. Журнал фиксирует, что вы просили и что списано, но не заменяет контрольных запросов.

Что на самом деле происходит с откатом на Opus 4.8?

Про откат легко понять неверно: будто Opus 5 сам тихо уходит на 4.8, когда срабатывает защитный классификатор. У Anthropic по умолчанию так работают Claude, Claude Code и Claude Cowork: помеченные запросы уходят на Opus 4.8. На API отказ приходит обычным ответом с кодом 200, полем stop_reason: "refusal" и категорией в stop_details. Серверный откат на другую модель включается отдельно, это бета со своим заголовком.

Как всё это выглядит через Relay, документация Relay не описывает. Автоматического переключения на другую модель в ней тоже нет: резервные маршруты там описаны как маршруты одной модели, у каждого своя цена. Практический вывод для кода: считайте отказ нормальным исходом. Проверяйте stop_reason, а повтор на claude-opus-4-8 делайте явно, своим кодом, и записывайте в журнал, что ответ пришёл от запасной ревизии.

Возможности Anthropic, которых нет в документации Relay

Три вещи описаны у Anthropic, но в документации Relay о них ничего нет:

  • смена набора инструментов посреди диалога без сброса кэша промпта (бета);

  • быстрый режим, до 2,5 раза быстрее по скорости вывода (исследовательский просмотр, по повышенной цене);

  • серверный откат на другую модель при отказе.

Пока не проверите их запросом со своим ключом, не закладывайте в архитектуру. Доступность параметра зависит от модели, и шлюз её не гарантирует.

Как не переплатить за Opus?

  1. Сузьте роль. Пусть Opus составляет план и проверяет итог, а правки идут на модели ниже. Это одна из схем, которые мы разобрали в статье про выбор уровня, там же её пределы.

  2. Ограничьте ответ. max_tokens по делу, а в промпте прямая просьба отвечать кодом без пояснений, если пояснения не нужны. Заодно меньше сумма, которую шлюз резервирует на балансе до ответа.

  3. Поставьте потолок ключу. Лимит в деньгах на весь срок, день или месяц задаётся в параметрах ключа. Запрос сверх лимита получит key_limit_exceeded, и деньги не спишутся.

  4. Сдвиньте effort. Это самый дешёвый эксперимент: поле output_config.effort уходит модели как есть, а Anthropic называет перебор уровней самым дешёвым способом сравнить качество и цену.

Вопросы про Opus 5

Что даёт Opus 5 по сравнению с 4.8?

По публичным таблицам Anthropic совпадают контекст, лимит ответа и режим thinking. Различается отсечка знаний: январь 2026 у 4.8 и май 2026 у Opus 5. Остальное, включая заявленный Anthropic рост качества, проверяется только вашим набором задач.

Нужно ли сразу переходить на Opus 5.5?

Нет, если ваш код отключает thinking или форсирует инструмент через tool_choice: на 5.5 оба приёма дают 400. Для нового проекта начинайте с 5.5. Сначала прогоните задачи на обеих ревизиях, карточки обеих есть в каталоге.

Какой контекст и какой максимум ответа у Opus 5?

По каталогу на 14 октября 2026: миллион токенов контекста и до 128 тысяч токенов ответа. Те же значения лежат в полях context_length и max_output_tokens ответа GET https://relay-llm.ru/v1/models/claude-opus-5 и в карточке модели.

Можно ли использовать Opus 5 в Claude Code?

Claude Code работает по протоколу Anthropic Messages. Relay замерял этот протокол на claude-sonnet-5, для остальных моделей Claude он проверяется перед выпуском, поэтому для Opus 5 сделайте контрольный запрос. Адрес, ключ и модель задаются переменными, шаги описаны на странице подключения Claude Code в документации.

Источники

Страницы Anthropic проверены 14 октября 2026.

Открыть Opus 5 в каталоге

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.