動画生成ステータスを取得

動画ジョブをポーリングします。終端状態は 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
  }
}