保存済み動画でアニメーション書き出しを再開
POST /animations/{animation_id}/retry-exportの認証、フィールド、応答、エラー、安全な運用をソースから生成した参考資料です。
このページの目次
操作
POST /animations/{animation_id}/retry-export
operationId: retry_one_click_animation_export_v1_animations__animation_id__retry_export_post
生成動画は保存済みで、保存容量の上限により書き出しを開始できなかった所有アニメーションを再開します。先に容量を空けるかプランを変更し、error.details.recoveryの案内に従ってください。元動画と同じ書き出しIDを再利用し、動画の再生成や追加クレジット請求は行いません。繰り返し呼び出しても同じ書き出しを返します。リクエスト本文とIdempotency-Keyは不要です。HTTP 202なら元のアニメーションIDで状態確認を続けます。中止・返還済みのタスク、削除済み元動画、その他の失敗には利用できません。
認証と副作用
サーバー側のBearer APIキーを使います。必要な権限:animations:write
有料生成は始めません。ほかの状態変更は上記を確認してください。
パラメータ
| パラメータ | 位置 | 型 | 必須 | 制約/既定値 | 説明 |
|---|---|---|---|---|---|
animation_id |
path |
string |
はい | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
応答
| HTTP | 本文 | 説明 |
|---|---|---|
200 |
TaskResponse | Current terminal animation result; inspect status and error. |
202 |
TaskResponse | Export resumed; poll the original animation ID. No additional generation or charge. |
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. |
409 |
APIErrorEnvelope | This animation cannot resume its export. |
413 |
APIErrorEnvelope | Request or decoded image exceeds the configured limit. |
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 | ヘッダー | 型 | 説明 |
|---|---|---|---|
200 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
202 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
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. |
応答例
{
"created_at": "2026-08-30T00:00:00Z",
"credits": {
"charged": 1,
"held": 0,
"quoted": 1
},
"error": null,
"finished_at": "2026-08-30T00:00:00Z",
"id": "00000000-0000-4000-8000-000000000002",
"metadata": {},
"normalized_input": {},
"object": "animation",
"outputs": [
{
"byte_size": 1024,
"created_at": "2026-08-30T00:00:00Z",
"download_expires_at": "2026-08-30T01:00:00Z",
"download_url": "https://downloads.example.invalid/illustrative-asset",
"format": "clip_video",
"id": "00000000-0000-4000-8000-000000000003",
"media": {
"duration_seconds": 5.04,
"fps": 25,
"frame_count": 126,
"height": 512,
"width": 512
},
"mime_type": "video/mp4",
"object": "asset"
},
{
"byte_size": 1024,
"created_at": "2026-08-30T00:00:00Z",
"download_expires_at": "2026-08-30T01:00:00Z",
"download_url": "https://downloads.example.invalid/illustrative-export",
"format": "frames_zip",
"id": "00000000-0000-4000-8000-000000000006",
"mime_type": "application/zip",
"object": "asset"
}
],
"progress": 1,
"stage": "completed",
"started_at": null,
"status": "succeeded"
}
関連ガイド
この記事は役に立ちましたか?
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー