タスク一覧

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

エンドポイント

GEThttps://fablun.com/api/v3/contents/generations/tasks

現在のアカウントのタスクを作成日時の新しい順に取得します。一覧取得の上限はアカウントで共有する 1 QPS です。

クエリパラメータ	型	既定値・範囲	説明
`page_num`	integer	1 / 1～500	ページ番号。
`page_size`	integer	20 / 1～500	1 ページあたりの件数。
`filter.status`	string	任意	6 種類のタスク状態のいずれか。
`filter.model`	string	任意	モデル ID。
`filter.task_ids`	string[]	任意・最大 500 件	同じパラメータ名を値ごとに繰り返して指定します。
`filter.service_tier`	string	任意	default のみ対応します。他の値では空の一覧が返されます。

リクエストとレスポンス

cURL

curl --get 'https://fablun.com/api/v3/contents/generations/tasks' \
  -H "Authorization: Bearer $ARK_API_KEY" \
  --data-urlencode 'page_num=1' \
  --data-urlencode 'page_size=20' \
  --data-urlencode 'filter.status=succeeded'

JSON · レスポンス例

{
  "total": 1,
  "items": [
    {
      "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
    }
  ]
}

レスポンスフィールド

total は条件に一致する総件数です。items は現在のページで、各項目は単一タスク取得と同じ構造です。