Отримати відео Seedance
Опитуйте завдання відео Seedance за id у CometAPI через GET /v1/videos/. Працює для завдань Seedance 1.0 Pro, 1.5 Pro і 2.0. Повертає поточний status, progress і підписаний video_url після того, як завдання досягає completed.
id у шляху — це значення, повернене викликом створення, незалежно від того, яка модель Seedance створила завдання.
Тіло відповіді — це безпосередньо сам об’єкт завдання відео. Читайте status, progress і video_url на верхньому рівні.
Машина status
API повертає рядки status у нижньому регістрі.queued і in_progress є нетермінальними; completed, failed і error є термінальними, і завдання більше не змінюватиметься.
Частота опитування
Опитуйте кожні 10–20 секунд. Більшість завдань завершуються за 1–3 хвилини залежно від моделі, тривалості та розміру.Поля, за якими варто стежити
status— визначає умову зупинки для вашого циклу опитування.progress— ціле число від 0 до 100, яке можна відображати в UI.video_url— підписаний URL для завантаження, присутній у відповідяхcompleted. Завантаження Seedance напряму використовують цей URL замість окремого маршруту/v1/videos/{id}/content. Підпис має обмежений строк дії; завантажте файл або розмістіть його у себе до завершення строку дії підпису.completed_at— необов’язкова Unix-мітка часу, яку повертає платформа. Не використовуйте її для зупинки опитування; натомість використовуйтеstatus.model— повторює model ID Seedance, який використовувався під час створення завдання.
Поширені помилки
- HTTP
400зmessage: "task_not_exist"означає, щоidневідомий. Переконайтеся, що ви збереглиidз успішної відповіді POST/v1/videosі використовуєте його без змін. - HTTP
401означає, що bearer token відсутній або недійсний. Перевірте, що заголовок запиту має виглядAuthorization: Bearer $COMETAPI_KEY.
Авторизації
Bearer token authentication. Use your CometAPI key.
Параметри шляху
Task id returned by POST /v1/videos.
Відповідь
Current Seedance video task state.
Task id.
Object type, always video.
Model id that generated the task.
Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.
queued, in_progress, completed, failed, error Completion percentage.
0 <= x <= 100Task creation time as a Unix timestamp in seconds.
Signed download URL for the finished video. Present on completed responses. Seedance downloads use this URL directly instead of a separate /v1/videos/{id}/content route. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.
Optional Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.