seedance-2.0-mini API

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

認証とエンドポイント

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

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

入出力制限

480p、720pに対応したモデルです。自動タイミングには -1 を使用するか、4 ～ 15 秒を選択します。フレームレートは24fpsに固定されています。マルチモーダル参照では、最大 9 つの画像、3 つのビデオ、および 3 つのオーディオ クリップが許可されます。オーディオを単独で使用することはできないため、リクエストには少なくとも 1 つの参照画像またはビデオが必要です。 content[] の role 値でメディアをマークします。最初のフレーム、編集、および拡張のワークフローは相互に排他的です。このモデルではframes、camera_fixed、output_format、omni_reference_task_typeは使用できません。

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

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-mini",
    "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-mini", "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 のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。