동영상

동영상 생성 상태 조회

비디오 작업이 completed 또는 failed가 될 때까지 폴링하세요. 진행 중 상태는 pending 또는 processing입니다. 완료 시 unsigned_urls에 다운로드 경로가 포함되며 usage.cost는 실제 전달된 초를 기준으로 고객에게 청구된 USD 금액입니다. 최소 5초 간격으로 폴링하세요.

GET/v1/videos/:id

인증

Authorization필수

string · header

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

경로 파라미터

id필수

string

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

Example: "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"

심층 가이드 →

GET /v1/videos/:id

1
2
curl https://api.bazaarlink.ai/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": "/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "unsigned_urls": [
    "/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk/content?index=0"
  ],
  "usage": {
    "cost": 0.5,
    "is_byok": false
  }
}