動画生成（非同期）

動画生成には時間がかかります（数十秒から数分）。4ALL API は提出 + ポーリングの非同期プロトコルを採用しています: まずタスクを提出して task_id を取得し、その後ポーリングして結果を照会します。

1. タスクを提出

POST https://api.4allapi.com/v1/video/generations

curl https://api.4allapi.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -d '{
    "model": "veo-3.1",
    "prompt": "ドローン視点で夜明けの海岸線をなめるように移動する、映画的、自然光",
    "size": "1280x720",
    "seconds": "8"
  }'

応答:

{ "task_id": "video-task-xxx", "status": "submitted" }

パラメータ	説明
`model`	動画モデル。例: `veo-3.1`、`sora-2`、`kling-v3`、`omni-flash` の動画モデル
`prompt`	画面とカメラワークの説明
`size`	解像度（横/縦画面）、モデルの対応範囲に準拠
`seconds`	長さ（秒）、モデルの対応範囲に準拠
`image`	画像から動画への最初のフレーム参照画像（対応モデル、URL または base64）

2. 結果を照会

GET https://api.4allapi.com/v1/video/generations/{task_id}

curl https://api.4allapi.com/v1/video/generations/video-task-xxx \
  -H "Authorization: Bearer $AIPROXY_KEY"

status は submitted → processing → succeeded / failed の経過をたどります; 成功時には動画のダウンロード URL が返されます:

{
  "task_id": "video-task-xxx",
  "status": "succeeded",
  "video_url": "https://.../result.mp4"
}

ポーリングの推奨事項

5〜10 秒間隔でポーリングし、総タイムアウトはモデルの長さに応じて余裕を持たせる（例: 10 分）;
failed 状態には失敗理由が付随します。内容違反による失敗は、プロンプトを調整して再提出してください;
動画リンクの有効期限は限られています。生成成功後はできるだけ早く自分のストレージへ保存してください。