API
動画生成
POST /v1/videos
非同期ジョブ:POST /v1/videos は HTTP 202 でジョブを返します。GET /v1/jobs/{id} をポーリングし、status が succeeded になったら url を取得し、取得後に POST /v1/jobs/{id}/ack を呼んで確認します。
課金されるリクエストには Idempotency-Key ヘッダーが必須です(ないと 400)。リクエストごとに新しい値を使ってください。
| パラメータ | 値 | 説明 |
|---|---|---|
| model | waffo.seedance-1-0-pro-fast-251015 | モデル |
| prompt | テキスト | 説明。画像から動画の場合は image と併用 |
| image | URL または base64 | 任意、最初のフレーム |
| duration | 5 / 10 | 秒 |
| resolution | 480p / 720p / 1080p | 解像度。秒単価は解像度で変わります |
| fps | 24 | フレームレート |
| seed | 整数 | 任意、再現用 |
curl https://api.waffo.ai/v1/videos \
-H "Authorization: Bearer $WAFFO_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"model":"waffo.seedance-1-0-pro-fast-251015","prompt":"...",
"duration":5,"resolution":"480p","fps":24}'
# → HTTP 202 {"id":"vid_…","status":"queued"}
curl https://api.waffo.ai/v1/jobs/vid_… -H "Authorization: Bearer $WAFFO_API_KEY"
# → {"status":"succeeded","url":"https://…/vid_….mp4"}
curl -X POST https://api.waffo.ai/v1/jobs/vid_…/ack -H "Authorization: Bearer $WAFFO_API_KEY"