gensta DOCS
api-platform.gensta.ai/v1 Портал разработчика
ДокументацияСтатус и результат

Статус и результат

Получайте актуальный статус и результат генерации по её ID.

Получение генерации

GET/v1/generations/{id}Bearer key · generations:read
bash
curl --silent --show-error --fail-with-body \
  "https://api-platform.gensta.ai/v1/generations/$GENERATION_ID" \
  -H "Authorization: Bearer $GENSTA_API_KEY"

Статусы

СтатусЗначениеФинальный
queuedОжидает обработкиНет
submittingЗапрос отправляетсяНет
provider_processingГенерация выполняетсяНет
saving_resultРезультат сохраняетсяНет
submission_unknownСтатус отправки уточняется; обратитесь в поддержкуНет
billing_reconciliationСтоимость уточняется; обратитесь в поддержкуНет
succeededРезультат готовДа
failedГенерация завершилась с ошибкойДа
canceledГенерация отмененаДа

Интервалы проверки

  1. Подождите около 5 секунд после создания.
  2. Проверяйте статус раз в 10–15 секунд; при сетевых ошибках постепенно увеличивайте интервал.
  3. Остановитесь на succeeded, failed или canceled.
  4. При submission_unknown или billing_reconciliation сохраните ID и обратитесь в поддержку. Не создавайте повторную генерацию.

Скачивание результата

При успехе artifacts содержит одно или несколько видео или изображений. У каждого артефакта есть id, kind, artifact_index, role, content_type, size_bytes и временный download_url. У изображений также есть размеры, а у разложенных слоёв — metadata слоя. Seedance может дополнительно вернуть изображение с role: last_frame, если оно запрошено. Повторный GET выдаст новые подписанные ссылки на те же файлы.

При успехе billing.status равен captured, а billing.charged_amount содержит итоговое списание в USD. При ошибке или отмене статус будет released, списание — нулевым, а резерв вернётся в кошелёк. reconciliation_required означает, что Gensta ещё уточняет финальную сумму.