Naar hoofdinhoud gaan
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
}
Gebruik dit endpoint om de status te lezen van een taak die is aangemaakt via Een Seedance-video maken. De id in het pad is de waarde die door de create-aanroep wordt teruggegeven, ongeacht welk Seedance-model de taak heeft geproduceerd.

​
Statusmachine

De taak doorloopt een van de onderstaande statussen. SUBMITTED en IN_PROGRESS zijn niet-terminaal; SUCCESS, FAILED en ERROR zijn terminaal en de taak verandert daarna niet meer.
StatusBetekenisTerminaal
SUBMITTEDGeaccepteerd en in de wachtrij voor rendering.nee
IN_PROGRESSRendering wordt uitgevoerd.nee
SUCCESSVoltooid. video_url is aanwezig in de response.ja
FAILEDDe provider heeft de taak afgewezen.ja
ERROREen interne fout verhinderde voltooiing.ja

​
Pollfrequentie

Poll elke 10 tot 20 seconden. De meeste taken zijn binnen 1 tot 3 minuten voltooid, afhankelijk van model, duur en resolutie. 
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)

​
Velden om in de gaten te houden

  • status — bepaalt de stopvoorwaarde voor je pollinglus.
  • progress — geheel getal van 0 tot 100 dat je in een UI kunt tonen.
  • video_url — ondertekende download-URL, alleen aanwezig bij SUCCESS. De handtekening is beperkt geldig in de tijd; download of host het bestand opnieuw voordat de handtekening verloopt.
  • completed_at — Unix-timestamp die wordt ingevuld zodra de taak een terminale status bereikt.
  • model — geeft de Seedance model ID terug die is gebruikt toen de taak werd aangemaakt.

​
Veelvoorkomende fouten

  • HTTP 400 met message: "task_not_exist" betekent dat de id onbekend is. Controleer of je de id hebt vastgelegd uit een succesvolle POST /v1/videos-response en dat je die letterlijk gebruikt.
  • HTTP 401 betekent dat de bearer token ontbreekt of ongeldig is. Controleer of de request-header Authorization: Bearer <COMETAPI_KEY> is.

Autorisaties

​
Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Padparameters

​
id
string
vereist

Task id returned by POST /v1/videos.

Respons

Current task state.

​
id
string
vereist

Task id.

​
object
string
vereist

Object type, always video.

​
model
string
vereist

Model id that generated the task.

​
status
enum<string>
vereist

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

Beschikbare opties:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
FAILED,
ERROR
​
progress
integer
vereist

Completion percentage.

Vereist bereik: 0 <= x <= 100
​
created_at
integer
vereist

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.