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

Как вызвать Claude Opus 5.5 через API Relay

Как вызвать Claude Opus 5.5 через API Relay

Публичный идентификатор модели в Relay: claude-opus-5-5. Перед каждым новым запуском откройте каталог моделей и убедитесь, что карточка с этим идентификатором доступна. Каталог остаётся источником текущего статуса, ограничений и цены.

Коротко

  • Используйте точный model: claude-opus-5-5.

  • Проверяйте карточку в каталоге и ответ GET https://relay-llm.ru/v1/models.

  • Для Anthropic SDK укажите базовый адрес https://relay-llm.ru без /v1.

Сначала проверьте каталог

Откройте карточку модели: Claude Opus 5.5. Второй способ проверки подходит для автоматизации: запросите https://relay-llm.ru/v1/models и найдите объект с id claude-opus-5-5.

Не подменяйте идентификатор строкой из чужой конфигурации. Клиентский API принимает публичный id Relay, а доступность в конкретный момент показывает каталог.

Запрос через Messages API

Создайте ключ в кабинете, сохраните его в серверном окружении и передайте claude-opus-5-5 как model.

Создайте Anthropic-клиент в серверном модуле с base_url="https://relay-llm.ru" и ключом из RELAY_API_KEY. Затем передайте идентификатор модели в вызов:

python
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Опиши структуру JSON одним абзацем."}],
)

print(message.content[0].text)

Anthropic SDK добавляет /v1/messages сам. Поэтому базовый адрес в примере не заканчивается на /v1. Поля, заголовки и формат ошибок описаны в документации Messages API.

Что проверить при первом вызове

Начните с короткого текста и ограниченного max_tokens. При ошибке сохраните код, HTTP-статус и request_id. Ошибка model_not_found или model_not_allowed не исправляется повтором того же запроса: сначала вернитесь к каталогу и настройкам ключа.

Текущие цены не копируйте в статью, код или переменную окружения. Их показывает карточка модели и документация списка моделей. Для потоковой передачи прочитайте руководство streaming до того, как добавлять stream: true.

Opus 5.5 или Sonnet 5: с чего начать?

В каталоге на 18 октября 2026 года у claude-opus-5-5 и claude-sonnet-5 совпадают окно контекста (1 000 000 токенов), предел ответа (128 000) и протоколы: Chat Completions, Messages и Responses. Различаются отметки возможностей и цена. У Sonnet 5 отмечено рассуждение, у Opus 5.5 нет. Отметка говорит, что заявлено в каталоге, а не как модель решает вашу задачу.

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

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

ЗадачаС чего начатьКогда повысить модель
Ежедневный код, ревью pull request, текстовые процессыclaude-sonnet-5Ошибки остаются на вашем наборе даже при хорошем контексте
Разбор незнакомого репозитория, решение на несколько сервисовclaude-sonnet-5, затем claude-opus-5-5 на тех же примерахКогда цена ошибки выше разницы в цене запроса
Промпт, который уже стабильно работаетТот ID, что работает сейчасПосле отдельного прогона на вашем наборе

Правило короткое: начинайте с Sonnet 5, а Opus 5.5 включайте на шагах, где один и тот же набор показывает ошибки Sonnet. Если рассчитываете на кэш промпта, сравните строки про кэш в карточках до расчёта бюджета.

Первое сравнение займёт несколько строк. Тот же запрос уходит двум моделям, а в выводе рядом лежат расход и текст:

python
for model in ("claude-sonnet-5", "claude-opus-5-5"):
    message = client.messages.create(
        model=model,
        max_tokens=512,
        messages=[{"role": "user", "content": "Опиши структуру JSON одним абзацем."}],
    )
    print(model, message.usage.input_tokens, message.usage.output_tokens)
    print(message.content[0].text)

Протокол Messages Relay замерил на claude-sonnet-5, для остальных моделей Claude проверка идёт перед выпуском. Если вызов Opus 5.5 по Messages вернул ошибку, повторите тот же запрос через Chat Completions: у модели в каталоге отмечены оба протокола. Для сравнения на двадцати своих примерах возьмите готовый скрипт.

Какой ID указывать в model?

claude-opus-5-5 - точный публичный идентификатор модели. Копируйте его из карточки в каталоге без изменений: версия записана через дефисы. Написание версии через точки запросит несуществующую модель и получит 404 с кодом model_not_found.

Почему нельзя всегда использовать сохранённый ID без проверки?

Каталог публикует текущий статус и параметры. Перед запуском на новой среде сверяйте карточку или GET /v1/models: если модель уйдёт из каталога или встанет на паузу, запрос по сохранённому ID завершится ошибкой, а не подменой.

Чем Opus 5.5 отличается от Sonnet 5 в каталоге?

Окно контекста, предел ответа и протоколы совпадают. Различаются отметки возможностей и цена в карточках. Сравнение качества каталог не публикует, поэтому проверяйте обе модели на своём наборе примеров и выбирайте дешевле из тех, что проходят порог.

Что делать, если вызов по Messages вернул ошибку?

Сохраните код, HTTP-статус и request_id. Если ошибка говорит о несовместимости формата, например 400 с названием поля в param, повторите тот же запрос через Chat Completions: у модели в каталоге отмечены оба протокола. Для model_not_found, model_not_allowed и model_unavailable смена протокола не поможет: исправьте ID, настройки ключа или выберите другую модель.

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

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