Video
Seedance 2.5 Flash
テキスト、最初/最後のフレーム、マルチモーダル参照から480pまたは720pの4–30秒の動画を生成するか、1本の元動画を編集します。
Seedance 2.5 Flashは、テキストからの動画生成、最初/最後のフレームからの生成、参照を使った生成、動画編集に対応しています。Defaultのティアでdreamina-seedance-2-5-flashを使用してください。メディアは認証情報を含まない公開HTTPまたはHTTPS URLで送信します。返されたタスクIDを保存し、そのIDで完成した動画を照会してください。
プレイグラウンドと最新料金、OpenAPI仕様、料金ガイドをご覧ください。
簡単な例
このリクエストは4秒の動画を作成します。送信前に現在の料金を確認してください。送信した生成が成功すると料金が発生します。
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-5-flash",
"content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
"resolution": "480p",
"duration": 4,
"ratio": "16:9",
"generate_audio": false
}'パラメータ
modelとcontentは必須です。その他のフィールドはすべて任意です。明示的なnull値と不明なフィールドは拒否されます。
| フィールド | 型 | デフォルト | 制約 |
|---|---|---|---|
model | 文字列 | 必須 | dreamina-seedance-2-5-flash |
content | 配列 | 必須 | 空でないテキスト項目が少なくとも1つ必要です。メディア項目にはロールが必要です。 |
resolution | 文字列 | 720p | 480pまたは720pです。 |
duration | 整数 | 5、編集時は-1 | 生成：4–30秒です。編集：省略するか-1を指定します。出力は元動画に従います。 |
ratio | 文字列 | 16:9、フレーム指定/編集時はadaptive | テキスト/参照による生成：16:9、9:16、1:1、4:3、3:4、21:9です。最初/最後のフレーム指定と編集：adaptiveのみです。 |
generate_audio | 真偽値 | true | 音声生成を有効または無効にします。単価は変わりません。 |
omni_reference_task_type | 文字列 | generate | generateまたはeditです。編集には動画がちょうど1本必要です。 |
content_filter | 真偽値 | true | trueのみ受け付けます。プレイグラウンドに操作項目は不要です。 |
ドキュメントでは、プロンプトの上限は10,000トークンとされています。公開トークナイザーは指定されていないため、文字数を正確なトークン数として扱ってはいけません。
コンテンツとモード
テキストには{"type":"text","text":"Describe the shot"}を使用します。画像、動画、音声には、ネストされたURLと明示的なロールを使用します。
{
"type": "image_url",
"image_url": {"url": "https://example.com/reference.jpg"},
"role": "reference_image"
}| モード | コンテンツ | 画面比率と長さ |
|---|---|---|
| テキストから動画生成 | テキストのみ | 固定比率、4–30秒です。 |
| 最初/最後のフレーム | テキストと1枚のfirst_frame画像、任意で1枚のlast_frame画像 | adaptive、4–30秒です。最後のフレームには最初のフレームが必要です。 |
| 参照を使った生成 | テキストとreference_image、reference_videoまたはreference_audio項目 | 固定比率、4–30秒です。画像は最大10枚、動画は最大5本、音声は最大5件です。 |
| 動画編集 | テキスト、ちょうど1本のreference_video、任意の参照画像/音声。タスクタイプはeditです | adaptive、長さは省略するか-1です。 |
動画項目にはtype: "video_url"、video_url: {"url": "..."}、role: "reference_video"を使用します。音声項目には同じ構造でaudio_urlとreference_audioを使用します。最初/最後のフレームは参照メディアと併用できません。この連携では、Draft、Extend、1080p、透かし、シード、最終フレーム出力の設定は利用できません。コールバックは提供していません。
メディアの制約
| メディア | 形式 | サイズと長さ |
|---|---|---|
| 画像 | JPEG, PNG, WebP | 最大30 MB、各辺300–6,000 px、幅/高さの比率0.4–2.5です。 |
| 動画 | MP4, MOV | 最大200 MB、24–60 FPS、各辺300–6,000 px、比率0.4–2.5、409,600–8,295,044ピクセルです。参照動画：各2–30秒、合計最大30秒です。編集元動画：4–30秒です。 |
| 音声 | WAV, MP3 | 最大15 MB、各2–30秒、合計最大30秒です。 |
送信前にファイルを読み取れる状態にする必要があります。料金計算のため、メディアから動画の長さを測定します。安定した公開URLを使用してください。
タスクのレスポンスとポーリング
作成時にはid、model、status、created_atが返されます。完了するまで同じタスクを照会してください。
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"ステータスはprocessing、completed、failedのいずれかです。成功時は、保存された動画を取得するためにoutput.video_urlを読み取ります。失敗時はerror.codeとerror.messageを読み取ります。公開レスポンスに費用は含まれません。ポーリングのタイムアウトは生成の失敗を証明するものではありません。別の生成を送信するのではなく、タスクIDを保持して再度照会してください。
課金
最新の単価は解像度と動画の有無によって異なります。動画入力がない場合、課金秒数は出力の長さと同じです。参照動画がある場合、課金秒数は、出力の長さに、出力の長さと切り上げた入力の合計の長さのうち大きい方を加えた値になります。編集では、切り上げた元動画の長さの2倍が課金されます。音声は料金に含まれます。失敗したリクエストには課金されません。
たとえば、3秒の参照動画を使った5秒の出力では、10秒分が課金されます。10秒の元動画の編集では、20秒分が課金されます。課金秒数に適用される最新の単価を掛けてください。
一般的なレスポンスと再試行のガイダンスについては、タスクのライフサイクルとエラーコードをご覧ください。