Seedance 2.0

Seedance 2.0 は、テキスト、開始・終了フレーム、画像・動画・音声の参照素材に対応し、480p、720p、1080p、4K で出力できます。1 回のリクエストで最長 15 秒の動画を生成します。モデルの詳細と Playground。

Wan API に接続する見出しのリンクをコピー

API のベース URL は https://api.wanapi.app です。API キー設定で Seedance モデルファミリーのキーを作成し、Authorization: Bearer YOUR_API_KEY ヘッダーで送信してください。キーはサーバー側で保管します。Playground はウェブサイトのログインセッションを使い、同じアカウントの残高から課金します。ブラウザーにキーを貼り付ける必要はありません。

利用には、有効なアカウントと十分な残高が必要です。GET /v1/models で、そのキーから利用できるモデルを取得できます。Seedance モデルには POST /v1/videos を使い、JSON 本文でモデルを指定してください。

13 個すべてのトップレベルフィールドをリクエストフィールドに記載しています。aspectRatio と generateAudio を含め、ここに示したフィールド名を使ってください。

Seedance 2.0 のタスクを送信する見出しのリンクをコピー

この例では、テキストから 720p の 4 秒動画を生成します。サーバー側で WAN_API_KEY に Seedance のキーを設定してください。一度だけ送信し、返された id を保存します。

curl https://api.wanapi.app/v1/videos \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0",
  "prompt": "A paper boat floats through a sunlit stream. Slow tracking shot.",
  "resolution": "720p",
  "aspectRatio": "16:9",
  "duration": 4,
  "generateAudio": true
}'

Seedance 2.0 のタスクを確認する見出しのリンクをコピー

返された id を TASK_ID として保存し、同じキーで状態を確認します。送信時のレスポンスはタスクの受付結果です。動画は完了後に利用できます。最初は 5 秒間隔で状態を確認してください。タスクの状態とダウンロードも参照してください。

curl "https://api.wanapi.app/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"

Seedance 2.0 の料金見出しのリンクをコピー

単価は動画 100 万トークンあたりの USD 建てで表示しています。最終費用は入力・出力の動画トークン数で決まります。解像度、長さ、参照動画の入力によって使用量が変わるため、参照動画の有無に対応する単価を使ってください。音声に別の料金区分はありません。

Seedance 2.0 の料金と見積もりを見る。送信前に Playground で見積もりをご確認ください。

リクエストフィールド見出しのリンクをコピー

JSON オブジェクトを送信します。model に加え、空でないプロンプトまたは一つ以上のメディア入力が必要です。その他のフィールドは任意です。未定義のフィールドは受け付けません。

入力の組み合わせとメディアの制限見出しのリンクをコピー

• 開始フレームには image、開始フレームと任意の終了フレームには frameImages を使います。終了フレームだけの指定と、同じフレーム種別の重複は受け付けません。

• フレームは inputReferences または providerOptions.bytedance.referenceAudio と併用できません。

• 参照モードでは、画像 9 枚、動画 3 本、音声 3 本まで、合計 15 個までの参照素材を指定できます。

• メディア入力には公開 HTTP(S) URL が必要です。ファイルのバイト列のアップロードと、認証情報を含む URL は受け付けません。

• 画像：JPEG、PNG、WebP、BMP、TIFF、GIF。30 MB 未満、各辺 300–6000 ピクセル、アスペクト比 0.4–2.5。

• 動画：MP4 または MOV。1 ファイル 50 MB 以下。各動画は 2–15 秒、合計 15 秒以内。各辺 300–6000 ピクセル、アスペクト比 0.4–2.5、24–60 fps。

• 音声：MP3 または WAV。1 ファイル 15 MB 以下。各音声は 2–15 秒、合計 15 秒以内。少なくとも一つの参照画像または参照動画が必要です。

• URL 先のメディアのサイズ、エンコード、長さは処理中に検証します。URL の検証だけでは、ファイルを使用できることは保証できません。

• このエンドポイントでは、過去のドラフトタスクからの最終レンダリングや、任意のネイティブタスクオプションは提供していません。

フレームと参照素材のリクエスト例見出しのリンクをコピー

以下の本文を、同じ POST /v1/videos エンドポイントに送信します。送信前に、すべての example.com の URL を、ご自身の直接アクセス可能なメディア URL に置き換えてください。タスクが完了するまで、入力 URL にアクセスできる状態を保ってください。

開始・終了フレーム見出しのリンクをコピー

開始フレームだけを指定する場合は、image: "https://example.com/first-frame.jpg" を使い、frameImages を省略します。動画の始点と終点を指定する場合は、次のようにします。

{
  "model": "bytedance/seedance-2.0",
  "prompt": "The camera slowly moves from the opening scene to the closing scene.",
  "frameImages": [
    {
      "frameType": "first_frame",
      "image": "https://example.com/first-frame.jpg"
    },
    {
      "frameType": "last_frame",
      "image": "https://example.com/last-frame.jpg"
    }
  ],
  "aspectRatio": "adaptive",
  "resolution": "720p",
  "duration": 4
}

画像・動画・音声の参照素材見出しのリンクをコピー

画像と動画は、MIME タイプを明示して inputReferences に指定します。音声 URL は providerOptions.bytedance.referenceAudio に指定してください。このリクエストにフレーム入力を加えることはできません。

{
  "model": "bytedance/seedance-2.0",
  "prompt": "Use the character from the image and the camera movement from the video.",
  "inputReferences": [
    {
      "type": "url",
      "url": "https://example.com/character.jpg",
      "mediaType": "image/jpeg"
    },
    {
      "type": "url",
      "url": "https://example.com/motion.mp4",
      "mediaType": "video/mp4"
    }
  ],
  "providerOptions": {
    "bytedance": {
      "referenceAudio": [
        "https://example.com/sound.wav"
      ]
    }
  },
  "resolution": "720p",
  "duration": 4
}

状態を確認して動画をダウンロードする見出しのリンクをコピー

受け付けたタスクには、次のようなオブジェクトを返します。ID とタイムスタンプは例示です。

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1792022400
}

API キーを使って GET /v1/videos/{task_id} をポーリングします。確認時には、同じ公開タスク ID とモデルが返されます。ポーリングを終了するタイミングは status で判断してください。progress は残り時間の見積もりではありません。

完了したタスクの確認結果には、url と mediaType を持つオブジェクトの配列 videos が含まれます。タイムスタンプは Unix 秒です。完了が記録されると completed_at が含まれます。

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1792022400,
  "completed_at": 1792022460,
  "videos": [
    {
      "url": "/v1/tasks/task_EXAMPLE/artifacts/video/content",
      "mediaType": "video/mp4"
    }
  ]
}

返された URL が相対パスの場合は、https://api.wanapi.app を基準に解決し、API キーで認証してください。上の例では、次のように取得します。

curl "https://api.wanapi.app/v1/tasks/$TASK_ID/artifacts/video/content" \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -o video.mp4

署名付き HTTPS メディア URL が返された場合は、そのホストに API キーを送らず、URL を直接使用してください。結果の URL には有効期限がある場合があります。残したい動画は、ご自身のストレージに保存してください。既存の結果の状態確認やダウンロードで、新たな生成が作成されることはありません。

失敗したタスクには、code と message を持つ error オブジェクトが含まれます。例：

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.0",
  "status": "failed",
  "error": {
    "code": "generation_failed",
    "message": "Video generation failed"
  }
}

課金とエラー処理見出しのリンクをコピー

最終費用は、実際の動画トークン使用量とモデルの現在の単価に基づきます。Playground の見積もりは上限の見積もりであり、固定料金ではありません。動画が長い場合や出力解像度が高い場合、トークン使用量が増えることがあります。失敗したリクエストには課金されません。

• 無効なパラメーター： 再送信する前に、フィールドや入力の組み合わせを修正してください。URL の構文に加え、メディア形式と制限も確認します。
• 認証またはモデルへのアクセス： 指定したモデルを利用できる、有効な Seedance のキーを使ってください。
• 残高不足： 新しい有料リクエストの前にチャージしてください。キーの利用上限を設定しても、アカウントの残高は増えません。
• 一時的な状態確認の失敗： 再試行間隔を延ばし、待機時間の上限を設けて GET を再試行してください。状態確認の失敗は、生成の失敗を意味しません。
• 送信のタイムアウトやタスク ID の欠落： 結果が不明な場合があります。二つ目の有料タスクが作成される可能性があるため、POST を自動で繰り返さないでください。
• ダウンロードの失敗： 新しい生成を始める前に、既存の結果の取得を再試行してください。

送信結果が不明で調査が必要な場合は、タスク ID を保管し、サポートにお問い合わせください。

Seedance 2.0 の OpenAPI スキーマをダウンロード。