API

動画生成

POST /v1/videos

非同期ジョブ:POST /v1/videos は HTTP 202 でジョブを返します。GET /v1/jobs/{id} をポーリングし、status が succeeded になったら url を取得し、取得後に POST /v1/jobs/{id}/ack を呼んで確認します。

課金されるリクエストには Idempotency-Key ヘッダーが必須です(ないと 400)。リクエストごとに新しい値を使ってください。

パラメータ値説明
modelwaffo.seedance-1-0-pro-fast-251015モデル
promptテキスト説明。画像から動画の場合は image と併用
imageURL または base64任意、最初のフレーム
duration5 / 10秒
resolution480p / 720p / 1080p解像度。秒単価は解像度で変わります
fps24フレームレート
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"