Как вызвать 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. Затем передайте идентификатор модели в вызов:
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 нет. Отметка говорит, что заявлено в каталоге, а не как модель решает вашу задачу.
| Задача | С чего начать | Когда повысить модель |
|---|---|---|
| Ежедневный код, ревью pull request, текстовые процессы | claude-sonnet-5 | Ошибки остаются на вашем наборе даже при хорошем контексте |
| Разбор незнакомого репозитория, решение на несколько сервисов | claude-sonnet-5, затем claude-opus-5-5 на тех же примерах | Когда цена ошибки выше разницы в цене запроса |
| Промпт, который уже стабильно работает | Тот ID, что работает сейчас | После отдельного прогона на вашем наборе |
Правило короткое: начинайте с Sonnet 5, а Opus 5.5 включайте на шагах, где один и тот же набор показывает ошибки Sonnet. Если рассчитываете на кэш промпта, сравните строки про кэш в карточках до расчёта бюджета.
Первое сравнение займёт несколько строк. Тот же запрос уходит двум моделям, а в выводе рядом лежат расход и текст:
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, настройки ключа или выберите другую модель.