Seedance 비디오 조회

​

상태 머신

​

폴링 주기

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)

​

확인해야 할 필드

• status — 폴링 루프를 중단할지 결정하는 기준입니다.
• progress — UI에 표시할 수 있는 0~100 범위의 정수입니다.
• video_url — 서명된 다운로드 URL이며, SUCCESS일 때만 존재합니다. 서명에는 시간 제한이 있으므로 만료되기 전에 파일을 다운로드하거나 다시 호스팅하세요.
• completed_at — 작업이 종료 상태에 도달하면 채워지는 Unix 타임스탬프입니다.
• model — 작업 생성 시 사용된 Seedance model id를 그대로 반환합니다.

​

일반적인 오류

• HTTP 400에서 message: "task_not_exist"는 id를 알 수 없다는 의미입니다. POST /v1/videos의 성공적인 응답에서 id를 올바르게 가져왔는지, 그리고 그대로 사용하고 있는지 확인하세요.
• HTTP 401는 bearer token이 없거나 유효하지 않다는 의미입니다. 요청 헤더가 Authorization: Bearer <COMETAPI_KEY>인지 확인하세요.