Для разработчиков

Документация API

Подключите свой сервис к Vostorg.ai через HTTPS API. Ключ выдаёт владелец или администратор рабочего пространства в кабинете, раздел «Использование → Ключи API».

Доступ и безопасность

Секрет ключа показывается один раз при создании. Передавайте его в заголовке Authorization: Bearer по HTTPS. При потере отзовите ключ и создайте новый.

У ключа могут быть лимит запросов и бюджет в кредитах. Выдавайте только нужные права. Платежи, управление ключами, администрирование, согласия и подключение аккаунтов через OAuth по API-ключу недоступны.

Права ключа

text:generateТексты и сценарии
image:generateИзображения и карточки
voice:generateОзвучка
video:generateВидео и монтаж
jobs:readСтатусы задач
usage:readРасход и тарифы
publish:writeПубликации
ozon:review:draftЧерновики ответов Ozon

api:full открывает продуктовые API, кроме запрещённых контуров выше. Используйте его только для доверенных собственных интеграций.

Первый запрос

Пример генерации текста. Для платного POST задайте уникальный Idempotency-Key, чтобы повтор запроса не создал второй расход.

curl -X POST https://vostorg.ai/api/v1/texts/generate \
  -H 'Authorization: Bearer <your-api-key>' \
  -H 'Idempotency-Key: <unique-request-id>' \
  -H 'Content-Type: application/json' \
  -d '{"topic":"Пример темы","platform":"telegram","style":"informative","tone":"friendly","length":"short"}'

Асинхронную задачу проверяйте через GET /api/v1/jobs/<id> с тем же заголовком авторизации. Публичный статус: queued, running, succeeded, failed или cancelled.

Ошибки и повторы

Ответ об ошибке содержит error.code, error.message, error.retryable и error.retry_after_ms. Для 429 дождитесь указанной задержки. При 409 с кодом IDEMPOTENCY_IN_FLIGHT первый запрос ещё выполняется. При IDEMPOTENCY_KEY_REUSED тот же ключ был использован с другим телом — исправьте запрос.