Запросы и статусы

Создание запроса, статусы, опрос и результат.

Генерация асинхронная: запрос создаётся мгновенно, ролик готовится от десятков секунд до нескольких минут.

Создание

bash

curl https://api.outsee.io/v1/bytedance/seedance-2.5/text-to-video \
  -H "Authorization: Bearer $OUTSEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f2b7c9e-order-1842" \
  -d '{ "prompt": "Проезд камеры вдоль моря на закате", "duration": 5, "resolution": "720p" }'

Ответ 201:

json

{
  "id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "object": "request",
  "status": "queued",
  "price": { "rub": "184.23", "usd": "2.0700", "refunded": false },
  "urls": { "status": "https://api.outsee.io/v1/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff" }
}

Цена списывается в момент создания. Если запрос завершится ошибкой, деньги вернутся автоматически.

Ответы на создание

HTTP	Что значит
`201`	Запрос создан и передан в работу.
`202`	Запрос создан и оплачен, но подтверждение запуска не успело прийти. Узнавайте статус по `urls.status` как обычно: запрос либо пойдёт в работу, либо завершится с возвратом денег.
`4xx` / `5xx` без `request_id`	Запрос не создан, деньги не списывались.
`4xx` / `5xx` с `request_id`	Запрос был создан, но модель отказалась его запускать. Он сразу завершён со статусом `failed`, деньги вернулись на баланс; если был указан `webhook_url`, придёт `request.failed`.

Статусы

Статус	Итоговый	Что значит
`queued`	нет	Запрос принят и ждёт начала работы.
`in_progress`	нет	Ролик генерируется.
`completed`	да	Готово, ссылка на файл — в `output.video.url`.
`failed`	да	Не удалось. Причина — в `error`, деньги возвращены.
`nsfw`	да	Отклонено модерацией. Деньги возвращены.

Опрос

bash

curl https://api.outsee.io/v1/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff \
  -H "Authorization: Bearer $OUTSEE_API_KEY"

Опрашивайте раз в 5–10 секунд до итогового статуса. Вместо опроса можно передать webhook_url.

Результат

json

{
  "status": "completed",
  "output": {
    "video": {
      "url": "https://outsee.io/f/…",
      "download_url": "https://outsee.io/f/…?download=1",
      "thumbnail_url": "https://outsee.io/f/…?thumb=1",
      "content_type": "video/mp4",
      "duration_seconds": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  },
  "expires_at": "2026-10-26T10:01:12.000Z"
}

Ссылка постоянная в пределах срока хранения (30 дней). Храните файл у себя, если он нужен дольше.

Список запросов

GET https://api.outsee.io/v1/requests?limit=20&status=completed — новые сверху. Для следующей страницы передайте before = next_before из ответа.

Оценка цены

POST https://api.outsee.io/v1/estimate/{модель}/{режим} с тем же телом, что и запрос, проверяет его целиком (включая файлы по ссылкам) и называет цену — без списания.

Черновик Seedance 2.5

С "resolution": "draft" Seedance 2.5 делает черновик в 480p по цене 480p. В течение 24 часов его можно довести до 1080p с тем же содержанием: POST https://api.outsee.io/v1/bytedance/seedance-2.5/draft-to-1080p с { "request_id": "<id черновика>" }. Доводка стоит как тот же ролик сразу в 1080p. В ответе на готовый черновик есть поле draft со сроком.