動画生成タスク一覧
GET /video-generationsの認証、フィールド、応答、エラー、安全な運用をソースから生成した参考資料です。
このページの目次
操作
GET /video-generations
operationId: list_video_generations_v1_video_generations_get
認証中のアカウントが所有するタスクを一覧表示します。次ページの取得にはnext_cursorを変更せず渡し、nullなら最後です。上限とレート予算はキーごとではなくアカウント全体に適用されます。
認証と副作用
サーバー側のBearer APIキーを使います。必要な権限：animations:read
有料生成は始めません。ほかの状態変更は上記を確認してください。
パラメータ
| パラメータ | 位置 | 型 | 必須 | 制約／既定値 | 説明 |
|---|---|---|---|---|---|
limit |
query |
integer |
いいえ | minimum: 1; maximum: 100; default: 20 |
Maximum records in this page, not an account concurrency limit. |
cursor |
query |
string / null |
いいえ | — | Opaque next_cursor from the prior page; pass unchanged. |
応答
| HTTP | 本文 | 説明 |
|---|---|---|
200 |
TaskListResponse | Successful public response. Example values are illustrative. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
403 |
APIErrorEnvelope | Account eligibility, account status, or key scope does not allow this operation. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
429 |
APIErrorEnvelope | Account-wide rate or queue limit; wait for Retry-After. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
応答ヘッダー
| HTTP | ヘッダー | 型 | 説明 |
|---|---|---|---|
429 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
503 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
応答例
{
"data": [
{
"created_at": "2026-08-30T00:00:00Z",
"credits": {
"charged": 0,
"held": 1,
"quoted": 1
},
"error": null,
"finished_at": null,
"id": "00000000-0000-4000-8000-000000000002",
"metadata": {},
"normalized_input": {},
"object": "video_generation",
"outputs": [],
"progress": 0,
"stage": "queued",
"started_at": null,
"status": "queued"
}
],
"next_cursor": null,
"object": "list"
}
関連ガイド
この記事は役に立ちましたか？
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー