비디오 조회

CometAPI Veo3 Retrieve API (GET /v1/videos/)를 사용해 video_id로 상태를 가져오고, 메타데이터를 조회하거나, Veo3 비디오 생성 결과를 다운로드하세요.

GET /v1/videos/{video_id}

Retrieve a Veo video job

cURL

curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "size": "16x9",
  "model": "veo_3_1-4K",
  "object": "video",
  "status": "queued",
  "task_id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "progress": 0,
  "created_at": 1773297229
}

이 엔드포인트를 사용해 Veo 작업을 폴링할 수 있습니다. 현재 작업 상태와 확인된 백엔드 model 정보를 반환합니다.

​

폴링 루프

1. 먼저 작업 생성

   Veo3 Async Generation으로 시작하고 반환된 id를 저장하세요.

2. 작업이 종료 상태가 될 때까지 폴링

   작업이 queued 또는 in_progress 상태를 벗어나 완료된 상태에 도달할 때까지 이 엔드포인트를 계속 호출하세요.

3. 결과 저장

   출력이 준비되면 애플리케이션에서 영구 보관용 사본이 필요할 경우 자체 스토리지로 옮기세요.

​

model ID가 변경될 수 있는 이유

응답에는 제출한 별칭 대신 확인된 백엔드 model id가 표시될 수 있습니다. 이는 정상적인 동작입니다.

인증

Authorization · string · header · 필수

Bearer token authentication. Use your CometAPI key.

경로 매개변수

video_id · string · 필수

Task id returned by the create endpoint.

응답

200 - application/json

Current job state.

id · string · 필수

size · string · 필수

model · string · 필수

object · string · 필수

status · string · 필수

progress · integer · 필수

created_at · integer · 필수

task_id · string