Подключение к Sybila
Выберите опубликованную модель, создайте ключ в кабинете и отправьте запрос в поддерживаемом формате API.
Адрес и ключ
Базовый адрес: https://api.sybila.sh/v1
Ключ создаётся в разделе «Ключи» клиентского кабинета. Он имеет вид sk-sybila-…. Храните ключ на стороне своего приложения и не включайте его в публичный код страницы.
- Найдите модель в каталоге и скопируйте её ID.
- Выберите родной формат: Anthropic для Claude, OpenAI для GPT. У остальных моделей проверьте формат в каталоге.
- Укажите адрес Sybila, ключ и ID модели в своём клиенте.
Доступ вашего ключа может быть ограничен отдельными моделями, форматами, частотой или числом одновременных запросов.
Формат OpenAI
Для Chat Completions используйте POST /v1/chat/completions. Ключ передаётся в заголовке Authorization: Bearer.
curl https://api.sybila.sh/v1/chat/completions \
-H "Authorization: Bearer $SYBILA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "Привет!"}],
"max_tokens": 256,
"stream": true
}'Для Responses используйте POST /v1/responses, если в возможностях модели указан Responses. Изображения, видео, аудио и эмбеддинги доступны только у моделей с соответствующей задачей. Подробные примеры для вашего доступа есть в разделе документации кабинета.
Формат Anthropic
Для Claude используйте Anthropic провайдер в клиенте. Тело запроса и поток ответа передаются в родном формате, включая инструменты и подписанные thinking блоки.
Для Messages используйте POST /v1/messages. Передайте ключ в x-api-key, версию API в anthropic-version и явный предел ответа в max_tokens.
curl https://api.sybila.sh/v1/messages \
-H "x-api-key: $SYBILA_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Привет!"}]
}'Замените MODEL_ID ID модели из каталога. Claude принимает только Anthropic Messages API, GPT — OpenAI API. Запрос в другом формате получает 422 model_format_not_allowed до отправки источнику.
Для новых Claude используйте thinking: {"type":"adaptive"} и output_config.effort. Режим enabled поддерживается не всеми моделями. Инструменты объявляются через input_schema, вызовы приходят как tool_use, результаты возвращаются как tool_result. Сохраняйте предыдущий ответ ассистента целиком, вместе с thinking блоками и подписями.
Бесплатные модели
Выберите категорию «Бесплатные» в каталоге. У этих моделей нулевая цена для клиента и отдельный ID с окончанием :free.
- В клиентском вебкабинете откройте «Аккаунт → Привязать через Mini App».
- Подтвердите привязку и войдите в кабинет Telegram.
- Используйте обычный API-ключ Sybila и бесплатный ID модели, например
zai-org/GLM-5.3-Flash:free.
Пополнение для бесплатной модели не требуется. Лимиты запросов, токенов и параллельности аккаунта сохраняются. Без подтверждённой привязки API вернёт 403 telegram_mini_app_required. Доступность зависит от оставшегося ресурса источника; бесплатный маршрут не переключается на платную версию модели.
Цены и баланс
В каталоге указаны окончательные цены в USD. Подписок и тарифных планов нет. Вход, выход и чтение кеша учитываются отдельно; для медиа используется единица, указанная у модели.
Если модель стоит $0.06 за 1 млн входных токенов и $0.02 за 1 млн токенов чтения кеша, запрос с 10 000 входных токенов, из которых 1 000 прочитаны из кеша, стоит $0.00056 за вход: 9 000 × $0.06 / 1 000 000 + 1 000 × $0.02 / 1 000 000. Выход оплачивается отдельно. Запись кеша отличается от его чтения и учитывается по отдельной цене, если она опубликована.
Перед платным запросом резервируется сумма в пределах его максимальной стоимости. После завершения резерв закрывается по фактическому использованию. Поэтому доступный баланс может быть меньше общего, пока запросы выполняются.
Для пополнения откройте раздел «Баланс» кабинета и создайте счёт. Оплата проходит через 2328. Комиссию оплачивает клиент; итоговая сумма и сеть показаны перед переводом. Баланс пополняется после подтверждения платежа. Не отправляйте платёж повторно только из-за ожидания подтверждения.
Фото, видео и аудио
Выберите модель по задаче в каталоге. Фото создаются через POST /v1/images/generations, видео через POST /v1/videos, речь через POST /v1/audio/speech, распознавание через POST /v1/audio/transcriptions. Генерация музыки использует расширение POST /v1/audio/generations. Дополнительные параметры конкретной модели передаются в объекте provider_options.
Для моделей с нативной очередью доступен POST /v1/media/generations: передайте публичный model и объект input. Ответ 202 содержит ID задания и адреса проверки, получения результата и отмены. При повторе этого запроса используйте тот же Idempotency-Key и тот же вход: очередь вернёт существующее задание. Изменённый вход с тем же ключом вернёт 409. Не повторяйте другие платные генерации вслепую после сетевой ошибки.
До выполнения резервируется предельная сумма, после выполнения списывается фактическая стоимость. Если расход нельзя подтвердить, резерв остаётся на сверке. Отмена ожидающего задания может освободить резерв; отмена уже выполняемого запроса не гарантирует возврат.
Готовое видео доступно через GET /v1/videos/{id}/content. Отдельный POST /v1/videos/{id}/delivery выдаёт временную ссылку через Cloudflare, когда такая выдача настроена. Загружать файл нужно по полученной ссылке, без API ключа Sybila. В кабинете ссылки доступны в разделе «Медиа».
Задания очереди видны семь дней. Это не срок хранения файлов: источник может удалить результат раньше. Sybila сохраняет сведения о задании и расчёте, а не копию файла или текст распознавания. Сохранение файлов по отдельному запросу пока недоступно; соответствующая кнопка выключена. Для моделей, требующих проверяемой длительности аудио, используйте указанный в каталоге формат загрузки.
Ошибки и лимиты
| Код | Причина и действие |
|---|---|
| 401 | Ключ недействителен или истёк. Проверьте ключ или создайте новый. |
| 402 | Не хватает доступного баланса. Пополните его с учётом активных резервов. |
| 403 | Модель или формат недоступны ключу. Проверьте его разрешения в кабинете. |
| 422 | Не удалось определить предельную стоимость. Проверьте параметры и укажите предел токенов или единиц медиа. |
| 429 | Достигнут лимит частоты, токенов или одновременных запросов. Уменьшите нагрузку и учитывайте заголовок Retry-After, если он передан. |
| 503 | Сервис временно недоступен. Повторите попытку позже; перед повтором платной генерации проверьте статус исходного запроса. |
Лимиты аккаунта отображаются в кабинете. Ответы поставщиков моделей могут содержать дополнительные ошибки в формате выбранного API.
Конфиденциальность
Для обработки запроса его содержимое передаётся поставщику выбранной модели. У поставщика действуют собственные правила обработки данных. Не передавайте данные, для которых такая обработка вам не разрешена.
В кабинете используются учётная запись, ключи, сведения об использовании и финансовые операции. При входе и проверках безопасности могут использоваться Cloudflare Turnstile и технические признаки риска. Письма сервиса отправляются через Brevo, платежи обрабатываются через 2328.
Публичный каталог не требует входа. Переписка, сохранённая через функции истории диалога, отличается от обычного одиночного запроса; учитывайте выбранный режим, когда передаёте данные.
Условия использования
Используйте опубликованные ID моделей и разрешённые вашему ключу форматы. Не передавайте ключи другим лицам и отзывайте их в кабинете, если они раскрыты.
Стоимость определяется ценой модели и фактическим использованием. Доступность модели, предел контекста, допустимые параметры и правила использования зависят также от её поставщика. Автоматический повтор запроса может создать ещё одну оплачиваемую генерацию.
Эта страница описывает работу API и оплаты. Уточнения по своему аккаунту и спорным операциям запрашивайте у администратора, выдавшего доступ.