seedance-2.0 API

正確なモデル ID seedance-2.0 を使用します。モデル フィールドはこのページと正確に一致する必要があります。

サンプル出力seedance-2.0POST /v1/videos5.1s

パラメータ: duration=5resolution=1080pratio=16:9

プロンプト： One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.

このサンプルを作成したリクエスト

{
  "model": "seedance-2.0",
  "prompt": "One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

認証とエンドポイント

https://modelflare.dev/v1 で Modelflare API キーを使用します。ゲートウェイのエントリ ポイントは POST /v1/videos です。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

タスクの作成

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

ポーリングとダウンロード

タスクIDを保存します。 GET /v1/videos/{task_id} をポーリングし、GET /v1/videos/{task_id}/content でダウンロードします。結果 URL は有効期限が切れている可能性があるため、速やかにファイルを転送してください。

bash

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

リクエストメモ

Seedance はテキスト、フレーム、参照メディアに content[] を使用します。別個の Seedance 資産管理 契約は、独立して文書化されています。

ノート

仮想人物の画像をまず Seedance アセットライブラリにアップロードしてください。状態が Active になったら、content[] で asset://<ID> を参照します。Modelflare は実在人物の認証を提供していません。

リクエストパラメータ

Seedance は 1 つの非同期マルチモーダル エンベロープを使用します。 content[]にテキストとメディアを入れます。メディアの役割は、最初/最後のフレームまたは参照ワークフローを選択します。

フィールド	必須	注意事項
model	はい	seedance-2.0
content[]	はい	text``image_url``video_url``audio_url role を使用してメディアの目的を特定する
resolution	いいえ	480p / 720p / 1080p / 4k (デフォルトは720p)
ratio	いいえ	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	いいえ	4～15秒
generate_audio	いいえ	同期したダイアログ、エフェクト、バックグラウンドオーディオを生成
tools	いいえ	web_search は公式モデルページでサポートされている場合にのみ使用してください
watermark	いいえ	ウォーターマークを入れるかどうか

入出力制限

このモデルは、4 ～ 15 秒の持続時間の 480p、720p、1080p、および 4k 出力をサポートします。マルチモーダル参照では、最大 9 つの画像、3 つのビデオ、および 3 つのオーディオ クリップが許可されます。音声のみでは使用できません。 content[] の role 値でメディアをマークします。最初のフレーム、編集、拡張、および Web 検索のワークフローには、それぞれ独自の制約があります。仮想人物の画像は、まずアセットライブラリにアップロードする必要があります。Modelflare は実在人物の認証を提供していません。

文書化されたワークフローの例

Seedance 2.0 シリーズは、テキストからビデオへの変換、最初/最初と最後のフレーム、マルチモーダル参照、編集、拡張、およびテキストからビデオへの Web 検索をサポートしています。メディアをテキスト、画像、ビデオ、オーディオの順に注文します。

マルチモーダルリファレンス

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "content": [
      {"type": "text", "text": "@image1 performs the movement from @video1, paced to @audio1"},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.jpg"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/music.mp3"}, "role": "reference_audio"}
    ],
    "generate_audio": true, "ratio": "16:9", "duration": 11
  }'

ビデオ編集と Web 検索

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0", "content": [{"type": "text", "text": "Macro shot of cherry blossoms in spring"}],
    "generate_audio": true, "ratio": "16:9", "duration": 11,
    "tools": [{"type": "web_search"}]
  }'

エラーと失敗したタスク

無効なモデル パラメーターは、リクエスト ID を含む 4xx を返します。非同期タスクは、作成が成功した後に失敗することもあります。ポーリング応答からの error_code と error_message を最終タスク理由として使用します。異なる JSON 形式で同じリクエストを再試行しないでください。

サポート範囲

このページでは、Modelflare モデルの生成と編集呼び出しについて説明します。検索またはマップのエンリッチメント、音声管理、および要素ライブラリ管理は、このパブリック モデル呼び出しサーフェスの外部にあるリソース API であり、必須のリクエスト フィールドではありません。

価格設定と請求

このモデルはトークンベースの課金を使用します。現在の顧客価格、参考定価、完全な仕様については、モデル価格ページを参照してください。

ノート

このページでは、Modelflare のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。

バリアント

モデルID	違い
seedance-2.0	このページに記載されているモデル。