API Claude Opus 5.5: готовые к запуску curl и Python для быстрого старта

Claude Opus 5.5 — новейшая модель Anthropic для агентного программирования и рассуждений с длинным контекстом; hiapi подключил её в тот же день, когда она появилась на платформе. В отличие от моделей hiapi для изображений, видео и аудио — которые используют асинхронный режим POST /v1/tasks → опрос — Claude Opus 5.5 является чисто текстовой диалоговой моделью, поэтому для вызова достаточно отправить один синхронный запрос к /v1/chat/completions. В этом руководстве приведены готовый к запуску вызов curl, версия того же вызова на Python, а также производственные детали, которые нужно знать перед запуском (интенсивность рассуждений, потоковый вывод, обработка ошибок).

Подготовка

• Аккаунт hiapi и API-ключ. Создать его можно на странице API Keys — все модели hiapi, включая Claude Opus 5.5, используют один и тот же ключ.
• SDK устанавливать не нужно. Claude Opus 5.5 использует совместимый с OpenAI формат Chat Completions от hiapi, поэтому любой HTTP-клиент (curl, requests, fetch) работает из коробки.

Минимальный рабочий запрос (curl)

curl -X POST "https://api.hiapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Give me three tips for reviewing a Python pull request." }
    ],
    "stream": false
  }'

Идентификатор модели передаётся напрямую — без суффикса маршрутизации и без префикса идентификатора провайдера. При успешном вызове возвращается стандартный объект чат-дополнения:

{
  "id": "msg_...",
  "object": "chat.completion",
  "model": "claude-opus-5-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 42,
    "total_tokens": 55,
    "usage_semantic": "openai",
    "usage_source": "anthropic"
  }
}

Ответ читается из choices[0].message.content — здесь нет output[0].url, который нужно опрашивать, и нет идентификатора задачи, за которым нужно следить.

Тот же процесс на Python

import requests

response = requests.post(
    "https://api.hiapi.ai/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5-5",
        "messages": [
            {"role": "user", "content": "Give me three tips for reviewing a Python pull request."}
        ],
        "stream": False,
    },
)
response.raise_for_status()
data = response.json()
print(data["choices"][0]["message"]["content"])

Поскольку эта конечная точка использует транспортный формат OpenAI Chat Completions, ту же структуру тела запроса можно дословно использовать в любом HTTP-клиенте на любом языке — кроме базового URL и Bearer-ключа, изучать ничего специфичного для hiapi не нужно.

Интенсивность рассуждений, обдумывание и потоковый вывод

Расширенное обдумывание Claude Opus 5.5 всегда включено — отключить его или вручную указать бюджет токенов нельзя. Вы можете управлять тем, сколько модель рассуждает, с помощью output_config.effort:

{
  "model": "claude-opus-5-5",
  "messages": [{ "role": "user", "content": "..." }],
  "output_config": { "effort": "medium" }
}

effort принимает значения low, medium (значение по умолчанию при отсутствии этого поля), high, xhigh или max — от быстрых и недорогих ответов до глубоких и вдумчивых. В ответе поле message содержит массив reasoning_details, в котором хранится внутренний ход рассуждений модели; для простых одноразовых вызовов его можно безопасно игнорировать и читать только message.content.

Для длинных ответов установите "stream": true, чтобы получать инкрементальный вывод, а не ждать полного ответа:

curl -N https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","messages":[{"role":"user","content":"..."}],"stream":true}'

Каждый блок данных — это строка data: {...} в формате chat.completion.chunk, а инкрементальный текст находится в choices[0].delta.content. Продолжайте читать блоки, пока не получите блок с непустым finish_reason (обычно "stop") — это и есть конец ответа.

Claude Opus 5.5 также поддерживает вызов инструментов/функций, имеет контекстное окно на 1 миллион токенов и вывод до 128 тысяч токенов, поэтому подходит для больших кодовых баз и задач с длинными документами, а не только для коротких вопросов и ответов.

Производственные замечания

• Ошибка аутентификации возвращает 401, а не 400. При отсутствии или недействительности ключа возвращается:

  { "error": { "code": "permission_denied", "message": "This API key is invalid...", "type": "hiapi_error", "request_id": "..." } }
  

  Проверяйте именно HTTP 401 и указывайте request_id, если потребуется обратиться в поддержку — о других причинах этой ошибки см. полное руководство по устранению недействительного API-ключа.

• Здесь нет опции обратного вызова/Webhook. Этот режим применяется к моделям hiapi на основе асинхронных задач (изображения, видео, аудио); Chat Completions поддерживает только запрос/ответ, поэтому stream: true — единственная альтернатива одному блокирующему вызову.

• Этот вызов по своей природе идемпотентен — идентификатор задачи не может быть случайно создан повторно, поэтому повтор при тайм-ауте безопасен, если вы готовы заново выполнить тот же запрос.

• Следите за ограничениями скорости, особенно при высоких конкурентных нагрузках; о стратегии повторных попыток см. как обрабатывать ошибки ограничения скорости 429.

• Цены за токены (входные, выходные и кэшированные токены тарифицируются отдельно) постоянно обновляются на странице модели Claude Opus 5.5 и на странице тарифов — не хардкодьте числа в логике биллинга, читайте их с этих страниц.

Дополнительное чтение

• Страница модели Claude Opus 5.5 — полная таблица характеристик и актуальные цены
• Руководство по API Claude Sonnet 4.6 — более лёгкий и быстрый вариант Claude в том же формате Chat Completions
• Создание прокси, совместимого с OpenAI, на Python — пригодится, если вы хотите проксировать несколько чат-моделей через единый внутренний API
• Управление вашими API-ключами

Часто задаваемые вопросы

Поддерживает ли API Claude Opus 5.5 потоковый вывод? Да — установите "stream": true и читайте блоки data: {...}, как описано выше.

Нужен ли API-ключ для вызова Claude Opus 5.5 в производственной среде? Да. Каждый запрос должен содержать Authorization: Bearer sk-<your key>; производственный API не предоставляет доступа без ключа или анонимного доступа.

Можно ли отключить обдумывание Claude Opus 5.5, чтобы сэкономить токены? Нет. Обдумывание этой модели всегда включено; единственное, чем вы можете управлять, — это уровень output_config.effort (от low до max), который балансирует между скоростью/стоимостью и глубиной.

Вызывается ли Claude Opus 5.5 через /v1/tasks, как модели изображений hiapi? Нет. Только модели hiapi для изображений, видео и аудио используют асинхронные задачи с опросом. Claude Opus 5.5 — текстовая модель, использующая /v1/chat/completions и возвращающая ответ в том же ответе.

Каковы контекстное окно и максимальная длина вывода? Контекст 1 миллион токенов, вывод до 128 тысяч токенов — достаточно для запросов по целому репозиторию или длинным документам.

Поддерживает ли Claude Opus 5.5 вызов инструментов/функций? Да, а также потоковый вывод и совместимый с OpenAI формат сообщений.