Seedance Video API

Seedance の動画生成は非同期 Video API を使用します。最初にタスクを送信し、返されたタスク ID で状態を確認します。この API は Chat Completions とは別です。

準備

Modelflare API Key を作成し、Base URL に https://modelflare.dev/v1 を使用します。公開モデル名は seedance-2.0 と seedance-2.5 です。

利用可能な長さと解像度の組み合わせはモデルごとに異なる場合があります。リクエスト前にモデルと料金を確認してください。対応している場合、解像度は 480p、720p、1080p、4k のいずれかです。

テキストから動画を生成

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "雨のネオン街を白い猫がカメラに向かって走る、映画的な追跡ショット",
    "duration": 4,
    "resolution": "720p"
  }'

画像から動画を生成

公開アクセス可能な HTTPS 画像 URL を image に追加します。その他のフィールドはテキストからの生成と同じです。

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "被写体がゆっくりカメラを向き、カメラが少し前進する",
    "image": "https://example.com/reference.png",
    "duration": 4,
    "resolution": "720p"
  }'

送信レスポンス

送信に成功すると公開タスク ID が返ります。id と task_id は同じタスクを示すため、どちらかを保存してください。

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued"
}

タスク状態を確認

数秒おきに状態を確認します。待機中は queued、pending、processing、in_progress などになり、completed または failed になったらポーリングを終了します。

curl https://modelflare.dev/v1/videos/task_example_123 \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

完了時のレスポンス例：

{
  "id": "task_example_123",
  "task_id": "task_example_123",
  "object": "video",
  "model": "seedance-2.5",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

動画をダウンロード

完了後、content エンドポイントから動画をダウンロードします。

curl -L https://modelflare.dev/v1/videos/task_example_123/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -o seedance.mp4

主な入力フィールド

• model：必須。seedance-2.0 または seedance-2.5。
• prompt：必須。生成する動画の説明。
• duration：必須。秒単位の整数で、現在の最短は 4 秒です。互換用に seconds も利用できます。
• resolution：必須。選択したモデルが対応する出力解像度。
• image：任意。公開 HTTPS 画像 URL。指定すると画像から動画を生成します。

HTTP 400 は通常パラメータ不正、401 は API Key 不正、429 は一時的な制限を示します。5xx は待機時間を延ばしながら再試行できます。