動画タスクを照会

単一の動画（および Kling、Midjourney の画像生成）タスクのステータスと結果のアドレスをポーリングします。

GET/v1/video/tasks/{task_id}

送信時に返されたタスク ID でポーリングします。5 秒に 1 回を推奨します。ポーリングは同時実行数を消費せず、課金もされません。Seedance / Grok のレスポンスは task でラップされ、MiniMax / Kling はトップレベルのフィールドです。読み取る階層を間違えないでください。

Seedance のタスクは作成から 24 時間を超えても終了しない場合、自動的に失敗と判定され（課金なし）、task.error.message は The task did not finish within 24 hours and was terminated automatically になります。結果のアドレスは api.hop-base.com 配下の署名付きアドレスで、再照会しても同じアドレスが返り、有効期限は延長されません：Seedance と Grok は 30 日、Kling と MiniMax は 6 時間です。有効期限内にダウンロードして保存してください。未完了のタスクは 24 時間（Seedance）または 2 時間（Kling、MiniMax）後に失敗と判定されます。

動画タスクを照会

curl https://api.hop-base.com/v1/video/tasks/vtEXAMPLE \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

200application/json

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "completed",
    "duration_seconds": 5,
    "outputs": [
      "https://api.hop-base.com/example-signed-video.mp4"
    ],
    "last_frame_url": "https://api.hop-base.com/example-signed-last-frame.jpg",
    "usage": {
      "completion_tokens": 1000,
      "total_tokens": 1000
    },
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": "2026-09-23T08:03:10Z"
  },
  "usage": {
    "cost": 3.4,
    "currency": "CNY",
    "cost_cny": 3.4,
    "cost_usd": 0.5
  }
}

ヘッダー

Authorization:必須string

Bearer sk-…：コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

パスパラメーター

task_id:必須string

送信時に返されたタスク ID：vt…（Seedance / Grok）、mmt…（MiniMax）、kt…（Kling）

レスポンス

200タスクオブジェクト（失敗したタスクを含む）

シリーズ

task:任意object

タスク

usage:任意object

タスク終了後にのみ含まれ、タスクを作成したキーにのみ返されます。0 は失敗して課金されなかったことを示します

エラー

401キー未指定、キーが無効または期限切れ（missing_api_key / invalid_api_key / api_key_expired）

404タスクが存在しない、またはこのキーのものではない

ヘッダー

パスパラメーター

レスポンス

エラー

関連ページ