影片

查詢影片生成狀態

輪詢影片任務狀態。終態只有 completed / failed;進行中通常是 pending / processing,也可能透傳上游的進行中字樣(如 in_progress)——請以「等到 completed 或 failed」寫輪詢邏輯,不要窮舉中間態。上游端的取消/逾期(cancelled / expired)一律以 failed 呈現並已退還預留額度。completed 時 unsigned_urls 列出可下載的內容路徑、usage.cost 為最終計費金額(按實際交付秒數);failed 時 error 說明原因。伺服器端對上游的查詢有 8 秒節流,客戶端建議以 ≥5 秒間隔輪詢。

GET/api/v1/videos/:id

驗證

Authorization必填

string · header

在 Authorization 標頭以 Bearer token 傳入 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 是相對路徑,帶同一把金鑰去 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
  }
}