動画生成タスクの取得

H3 動画タスク API · /api/v3

エンドポイント

GEThttps://fablun.com/api/v3/contents/generations/tasks/{id}

作成時に返された元の ID を使用します： cgt-… 。取得の上限はアカウントで共有する 20 QPS です。

リクエストとレスポンス

cURL

curl 'https://fablun.com/api/v3/contents/generations/tasks/cgt-0123456789abcdef0123456789abcdef' \
  -H "Authorization: Bearer $ARK_API_KEY"

JSON · 成功レスポンス例

{
  "id": "cgt-0123456789abcdef0123456789abcdef",
  "model": "h3-pro",
  "status": "succeeded",
  "created_at": 1793600000,
  "updated_at": 1793600030,
  "content": {
    "video_url": "https://YOUR_RESULT_HOST/video.mp4?SIGNED_QUERY"
  },
  "seed": 42,
  "resolution": "480p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24,
  "generate_audio": true,
  "service_tier": "default",
  "error": null
}

フィールド	型	説明
`status`	string	タスクの状態。下の表を参照してください。
`content.video_url`	string \| null	再生・ダウンロード URL。完了後 1 時間有効で、再取得しても延長されません。
`seed`	integer	実際のシード値。ランダム指定でも確定した値が返されます。
`created_at / updated_at`	integer	秒単位の Unix タイムスタンプ。
`error`	object \| null	失敗時は code / message を確認します。成功時は null です。

タスクの状態

status	意味	対応
`queued`	待機中	同じタスクの状態確認を続けます。
`running`	処理中	入力準備、動画生成または配信処理中です。状態確認を続けます。
`succeeded`	成功	content.video_url を取得します。リンクの期限切れ後は null の場合があります。
`failed`	失敗	error.code と error.message を確認します。
`expired`	期限切れ	待機時間を含むタスクの有効期間が終了しました。
`cancelled`	キャンセル済み	状態確認を終了します。

約 2 秒おきに状態を確認してください。クライアントのタイムアウトではタスクはキャンセルされません。ID を保存して確認を続けます。通常のタスク記録は作成から 7 日間、キャンセル済み記録は 24 時間保持されます。動画 URL は 1 時間のみ有効です。