Перейти к содержанию

Справочник API

Здесь собраны общие правила вызова API методов хаба и ссылки на справочники отдельных API.

Авторизация​

Для запросов с ключом хаба используйте заголовок:

Authorization: Bearer sk-ci2-...

Один ключ подходит для разных API. В примерах ключ берется из переменной COREINFRA_API_KEY.

Anthropic Messages также принимает x-api-key, Google API — x-goog-api-key. Если такой заголовок присутствует, он имеет приоритет над Authorization. Исключения для вызовов без ключа указаны на страницах соответствующих API методов, например у каталога OpenAI.

На fal-совместимом API ключ хаба передается в Authorization: Key sk-ci2-... или Authorization: Bearer sk-ci2-..., а скачивание готового видео по подписанной ссылке /content?t=... не требует заголовка авторизации.

При подключении подписок ключ хаба передается отдельно, в x-coreinfra-api-key, а токен подписки — в Authorization: Bearer ….

Адреса и версии​

Основной хост — https://hub.coreinfra.ai. Большинство API методов используют префикс api/v1. Google Interactions принимает api/v1beta и api/v1; оба пути вызывают одни и те же API методы. У fal-совместимого API (/fal/api/...) и у проверки соединения Claude Code сегмент версии в пути отсутствует.

Используйте HTTP-метод и путь из справочника выбранного API. Незарегистрированное сочетание метода и пути возвращает статус-код 404. Путь /openai/api/v1/realtime без WebSocket Upgrade (как и попытка открыть WebSocket по неподдерживаемому пути) возвращает статус-код 426.

Общие ограничения​

На hub.coreinfra.ai HTTP-тело запроса ограничено 104 857 600 байтами (100 МиБ; на /fal/api — 64 МиБ). Для сжатого тела проверяются оба размера: до и после распаковки. Размер стартовой строки и заголовков HTTP/1-запроса ограничен 65 536 байтами (64 КиБ); на их чтение отводится 30 секунд.

Для POST-запросов к API методам поддерживается Content-Encoding: gzip, deflate, br или zstd (identity означает отсутствие сжатия). Несколько кодировок одновременно не принимаются. При неподдерживаемом сжатии возвращается ответ со статус-кодом 415 и заголовком Accept-Encoding: gzip, deflate, br, zstd.

Входные изображения и файлы передаются непосредственно в запросе: в кодировке base64 либо через multipart/form-data там, где API метод это поддерживает. Ссылки на внешние ресурсы и идентификаторы ранее загруженных файлов (file_id) отклоняются. Дополнительные ограничения описаны на странице «Лимиты и ограничения».

Общие ошибки​

Формат тела ошибки зависит от вида ошибки: проверяйте статус-код, Content-Type и заголовки ответа. Ошибки валидации параметров запроса возвращаются в JSON-формате выбранного API (примеры приведены в справочнике каждого API). Ошибки недействительного ключа sk-ci2-..., недостатка средств, исчерпания недельного лимита расходов и блокировки модели возвращаются со статус-кодом 400 и типом text/plain; charset=utf-8 (на fal API и веб-API недействительный ключ возвращает статус-код 401). Если заголовок авторизации отсутствует, пуст или имеет неверную схему, а также при неразбираемом теле на некоторых методах возвращается статус-код 400 с пустым телом.

Статус-кодПричинаЧто сделать
400Отсутствует заголовок с ключом, неверна схема авторизации или ключ недействителенПередайте действующий ключ sk-ci2-... в заголовке выбранного API
400Некорректное тело запроса, неподдерживаемая модель, параметр или вложениеПроверьте страницу API метода и каталог моделей
400Доступный остаток равен нулю или отрицателен (x-coreinfra-status: payment-required)Пополните баланс
400Исчерпан недельный лимит расходов хаба, участника или ключа (x-coreinfra-status: cost-limit-reached)Проверьте лимиты и настройки команды
400Модель заблокирована белым списком хаба, участника или ключаВыберите разрешенную модель или обновите список моделей
401Недействительный ключ (на fal API и веб-API) или отсутствует токен подпискиПроверьте переданный ключ или токен подписки
403Запрос отклонен провайдером модели по правилам контента или доступаИзмените запрос или выберите другую модель
404Сочетание HTTP-метода и пути не поддерживается либо ресурс не найденСверьте полный адрес, HTTP-метод и идентификатор ресурса
413Тело запроса превышает допустимый размерУменьшите размер запроса (включая размер после распаковки)
415Неподдерживаемое сжатие тела запросаИспользуйте алгоритм из Accept-Encoding либо отправьте несжатое тело
422Ошибка валидации входных параметров на fal APIПроверьте поля detail[].loc и detail[].msg в ответе
426Некорректный заголовок WebSocket Upgrade или путь без поддержки WebSocketИспользуйте API метод с поддержкой WebSocket и корректный Upgrade
429Превышен лимит частоты запросов у провайдера моделиПовторите запрос позже с учетом заголовков retry-after / retry-after-ms
499Передача тела запроса прерваласьПроверьте соединение и таймаут клиента
500Внутренняя ошибка обработки запросаПовторите запрос позже
502Ошибка на стороне провайдера модели при выполнении запросаПовторите запрос позже либо выберите другую модель
503Провайдер модели временно недоступенПовторите запрос позже либо выберите другую модель

API​

Бэкенды агентов описаны отдельно: Codex и Claude Code.