Langsung ke konten utama
GET
/
v1
/
videos
/
{id}
cURL
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer <COMETAPI_KEY>"
{
  "id": "task_abc123",
  "model": "doubao-seedance-2-0-fast",
  "object": "video",
  "status": "IN_PROGRESS",
  "progress": 45,
  "created_at": 1776567610,
  "completed_at": null
}
Gunakan endpoint ini untuk membaca status task yang dibuat melalui Membuat video Seedance. id di path adalah nilai yang dikembalikan oleh panggilan create, terlepas dari model Seedance mana yang menghasilkan task tersebut.

​
Mesin status

Task akan melalui salah satu status di bawah ini. SUBMITTED dan IN_PROGRESS bersifat non-terminal; SUCCESS, FAILED, dan ERROR bersifat terminal dan task tidak akan berubah lagi.
StatusArtiTerminal
SUBMITTEDDiterima dan dimasukkan ke antrean untuk rendering.tidak
IN_PROGRESSRendering sedang berlangsung.tidak
SUCCESSSelesai. video_url ada di dalam respons.ya
FAILEDPenyedia menolak task tersebut.ya
ERRORError internal mencegah penyelesaian.ya

​
Interval polling

Lakukan poll setiap 10 hingga 20 detik. Sebagian besar job selesai dalam 1 hingga 3 menit tergantung pada model, durasi, dan resolusi. 
import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer <COMETAPI_KEY>"}
TERMINAL = {"SUCCESS", "FAILED", "ERROR"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=15,
    )
    response.raise_for_status()
    data = response.json()
    if data["status"] in TERMINAL:
        print(data.get("video_url"))
        break
    time.sleep(10)

​
Field yang perlu diperhatikan

  • status — menentukan kondisi berhenti untuk loop polling Anda.
  • progress — bilangan bulat 0 hingga 100 yang dapat Anda tampilkan di UI.
  • video_url — URL unduhan bertanda tangan, hanya ada pada SUCCESS. Tanda tangan ini dibatasi waktu; unduh atau host ulang file sebelum tanda tangannya kedaluwarsa.
  • completed_at — timestamp Unix yang diisi setelah task mencapai status terminal.
  • model — mengembalikan model id Seedance yang digunakan saat task dibuat.

​
Error umum

  • HTTP 400 dengan message: "task_not_exist" berarti id tidak dikenal. Pastikan Anda mengambil id dari respons POST /v1/videos yang berhasil dan menggunakannya apa adanya.
  • HTTP 401 berarti bearer token tidak ada atau tidak valid. Periksa bahwa header request adalah Authorization: Bearer <COMETAPI_KEY>.

Otorisasi

​
Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Parameter Path

​
id
string
wajib

Task id returned by POST /v1/videos.

Respons

Current task state.

​
id
string
wajib

Task id.

​
object
string
wajib

Object type, always video.

​
model
string
wajib

Model id that generated the task.

​
status
enum<string>
wajib

Task status. SUBMITTED and IN_PROGRESS are non-terminal. SUCCESS, FAILED, and ERROR are terminal.

Opsi yang tersedia:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
FAILED,
ERROR
​
progress
integer
wajib

Completion percentage.

Rentang yang diperlukan: 0 <= x <= 100
​
created_at
integer
wajib

Task creation time as a Unix timestamp in seconds.

​
video_url
string | null

Signed download URL for the finished video. Present only when status is SUCCESS. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.

​
completed_at
integer | null

Task completion time as a Unix timestamp in seconds. null while the task is non-terminal.