동영상

동영상 생성 상태 조회

동영상 작업을 폴링합니다. 종료 상태는 completed / failed뿐입니다. 실행 중에는 보통 pending / processing이지만 업스트림의 진행 중 라벨(예: in_progress)이 그대로 전달될 수 있습니다 — 중간 상태를 열거하지 말고 "completed 또는 failed까지"로 루프를 작성하세요. 업스트림 취소/만료(cancelled / expired)는 failed로 나타나며 예약 크레딧은 환불됩니다. completed 시 unsigned_urls에 다운로드 가능한 콘텐츠 경로가, usage.cost에 최종 청구 금액(실제 전달 초 기준)이 들어갑니다. failed 시 error에 원인이 있습니다. 서버는 업스트림 조회를 8초당 1회로 제한하므로 5초 이상 간격으로 폴링하세요.

GET/api/v1/videos/:id

인증

Authorization필수

string · header

Authorization 헤더에 Bearer 토큰으로 API 키를 전달합니다.

경로 파라미터

id필수

string

제출 시 반환된 작업 id(vjob_ 접두사). 같은 계정의 작업만 조회할 수 있습니다.

Example: "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"

심층 가이드 →

GET /api/v1/videos/:id

1
2
curl https://bazaarlink.ai/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

응답 예시

성공. 예시는 completed 작업입니다. pending / processing 응답에는 unsigned_urls와 usage가 없고, failed에는 error 필드가 추가됩니다. unsigned_urls는 상대 경로이며 같은 API 키로 GET하면 다운로드됩니다.

1
2
3
4
5
6
7
8
9
10
11
12
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "completed",
  "polling_url": "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "unsigned_urls": [
    "/api/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk/content?index=0"
  ],
  "usage": {
    "cost": 0.5,
    "is_byok": false
  }
}