Hopp til hovedinnhold
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
}
Bruk dette endepunktet for å lese tilstanden til en oppgave opprettet gjennom Create a Seedance video. id i stien er verdien som returneres av opprettelseskallet, uavhengig av hvilken Seedance-modell som produserte oppgaven.

​
Statusmaskin

Oppgaven går gjennom én av tilstandene nedenfor. SUBMITTED og IN_PROGRESS er ikke-terminale; SUCCESS, FAILED og ERROR er terminale, og oppgaven vil ikke endre seg videre.
StatusBetydningTerminal
SUBMITTEDGodtatt og satt i kø for rendering.nei
IN_PROGRESSRendering pågår.nei
SUCCESSFerdig. video_url finnes i responsen.ja
FAILEDLeverandøren avviste oppgaven.ja
ERROREn intern feil hindret fullføring.ja

​
Poll-frekvens

Poll hvert 10. til 20. sekund. De fleste jobber fullføres innen 1 til 3 minutter, avhengig av modell, varighet og oppløsning. 
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)

​
Felter å følge med på

  • status — styrer stoppbetingelsen for polling-løkken din.
  • progress — heltall fra 0 til 100 som du kan vise i et UI.
  • video_url — signert nedlastings-URL, finnes bare ved SUCCESS. Signaturen er tidsbegrenset; last ned eller host filen på nytt før signaturen utløper.
  • completed_at — Unix-tidsstempel som fylles inn når oppgaven når en terminal status.
  • model — gjenspeiler Seedance model ID-en som ble brukt da oppgaven ble opprettet.

​
Vanlige feil

  • HTTP 400 med message: "task_not_exist" betyr at id er ukjent. Bekreft at du fanget opp id fra en vellykket POST /v1/videos-respons, og at du bruker den ordrett.
  • HTTP 401 betyr at bearer-token mangler eller er ugyldig. Sjekk at request-headeren er Authorization: Bearer <COMETAPI_KEY>.

Autorisasjoner

​
Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Stien-parametere

​
id
string
påkrevd

Task id returned by POST /v1/videos.

Svar

Current task state.

​
id
string
påkrevd

Task id.

​
object
string
påkrevd

Object type, always video.

​
model
string
påkrevd

Model id that generated the task.

​
status
enum<string>
påkrevd

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

Tilgjengelige alternativer:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
FAILED,
ERROR
​
progress
integer
påkrevd

Completion percentage.

Nødvendig område: 0 <= x <= 100
​
created_at
integer
påkrevd

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.