Skip to main content
GET
/
v1
/
videos
/
{id}
cURL
curl https://api.cometapi.com/v1/videos/<TASK_ID> \
  -H "Authorization: Bearer $COMETAPI_KEY"
{
  "id": "task_abc123",
  "object": "video",
  "model": "doubao-seedance-2-0",
  "status": "in_progress",
  "progress": 30,
  "created_at": 1777385418,
  "completed_at": 1777385485
}
Use this endpoint to read the state of a task created through Create a Seedance video. The id in the path is the value returned by the create call, regardless of which Seedance model produced the task. The response body is the video task object itself. Read status, progress, and video_url at the top level.

​
Status machine

The API returns lowercase status strings. queued and in_progress are non-terminal; completed, failed, and error are terminal and the task will not move again.
StatusMeaningTerminal
queuedAccepted and queued for rendering.no
in_progressRendering in progress.no
completedFinished. video_url is present in the response.yes
failedThe provider rejected the task.yes
errorAn internal error prevented completion.yes

​
Poll cadence

Poll every 10 to 20 seconds. Most jobs finish within 1 to 3 minutes depending on model, duration, and size. 
import os
import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}
TERMINAL = {"completed", "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)

​
Fields to watch

  • status — drives the stop condition for your polling loop.
  • progress — integer 0 to 100 that you can surface in a UI.
  • video_url — signed download URL, present on completed responses. Seedance downloads use this URL directly instead of a separate /v1/videos/{id}/content route. The signature is time-limited; download or re-host the file before the signature expires.
  • completed_at — optional Unix timestamp returned by the platform. Do not use it to stop polling; use status instead.
  • model — echoes the Seedance model id used when the task was created.

​
Common errors

  • HTTP 400 with message: "task_not_exist" means the id is unknown. Confirm that you captured the id from a successful POST /v1/videos response and that you use it verbatim.
  • HTTP 401 means the bearer token is missing or invalid. Check that the request header is Authorization: Bearer $COMETAPI_KEY.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Path Parameters

​
id
string
required

Task id returned by POST /v1/videos.

Response

Current Seedance video task state.

​
id
string
required

Task id.

​
object
string
required

Object type, always video.

​
model
string
required

Model id that generated the task.

​
status
enum<string>
required

Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.

Available options:
queued,
in_progress,
completed,
failed,
error
​
progress
integer
required

Completion percentage.

Required range: 0 <= x <= 100
​
created_at
integer
required

Task creation time as a Unix timestamp in seconds.

​
video_url
string | null

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.

​
completed_at
integer | null

Optional Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.