はじめに
Seedance 2.0 Fast には編集専用のスイッチがありません。渡したクリップを 1 本目の参照動画として読み込み、指示の書き方から「真似る」のではなく「作り変える」べき素材だと判断します。変える点と残す点を書けば、結果は元動画と同じ長さ・同じ画面比率で戻ります。
| 項目 | 値 |
|---|---|
| 入力 | 動画 |
| 出力 | 動画 |
| 必須入力 | prompt、 |
| 元クリップ | 2〜15 秒 · MP4 · 1 フレーム 409,600〜2,086,876 px · 縦横比 0.4〜2.5 |
| 出力の長さ | 元動画と同じ。4 秒未満のクリップは約 4 秒で返却 |
| 解像度 | 480p、720p(既定)。画面比率は元動画に合わせる |
| 参考素材 | 画像 9 枚・音声 3 本まで(任意) |
| 音声 |
|
| 課金 | 元動画の秒数、切り上げ、最低 4 秒 |
主な機能とハイライト
手元にあるものに合う経路を選ぶ
文だけなら text-to-video。承認済みの先頭フレームがあるなら image-to-video——同じ内容を文章で書くより、フレームのほうがはるかに忠実に従われます。顔・衣装・部屋など固定したい素材があるなら reference-to-video。手元にあるもので選ぶことが、リクエストがフィールドの半分を黙って無視するのを防ぎます。
形は素材に合わせる
aspect_ratio の既定は adaptive です。image-to-video は最初の画像の縦横比を保ち、reference-to-video は主となる参照素材に合わせるので、縦長の静止画が横長の枠に切り抜かれることはありません。掲載先で形が決まっている場合に備えて、16:9、9:16、4:3、3:4、1:1、21:9 の 6 つの固定比率も引き続き使えます。
参照 9 枚、クリップ 3 本、トラック 3 本
reference-to-video は 1 回のリクエストで画像 9 点・動画 3 本・音声 3 本までをまとめます。同じ顔の 3 方向のほうが、無関係な 9 枚よりずっとキャラクターを保ちます。1 つの素材に 1 つの役割を与え、すべてに同一性・スタイル・動きを同時に背負わせないでください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | まず変更点を書き、次に動かしてはいけないもの(顔、手、小物、一つひとつの仕草のタイミング、カメラの動き)を並べます。元クリップは @Video1、追加の静止画はアップロード順に @Image1、@Image2、音声ファイルは @Audio1 です。 1 文字以上 |
video_url | はい | MP4、2〜15 秒、24〜60 fps、50 MB まで。各フレームは 409,600〜2,086,876 ピクセル、縦横比 0.4〜2.5 に収まる必要があるため、360p の映像や 1080p を超える映像は受け付けられません。 1 文字以上 |
reference_image_urls | いいえ | 任意。目標の見た目を固める静止画を最大 9 枚(ジャケット、小物、顔、カラーボードなど)。 1 件以上 · 9 件以内 |
reference_audio_urls | いいえ | 任意。新しいサウンドトラックを声や雰囲気に寄せるための 2〜15 秒のファイルを最大 3 本、合計 15 秒まで。 1 件以上 · 3 件以内 |
resolution | いいえ | 480p または 720p(既定)。画面比率は元動画に合わせます。 |
generate_audio | いいえ | 既定はオンで、編集後の映像に合わせて Fast が新しいサウンドトラックを作ります。オフにすると無音で納品されます。 デフォルト値: |
seed | いいえ | 任意の整数(0〜2147483647)。固定すると同じ編集の 2 つのバージョンを比べやすくなりますが、同じフレームになる保証はありません。 |
return_last_frame | いいえ | 編集したクリップの最終フレームも、単独の画像として受け取れます。続きのショットの最初の静止画に使えます。 デフォルト値: |
bitrate_mode | いいえ | standard(既定)または high。high は納品ファイルを高いビットレートでエンコードし、細部がくっきりする代わりにファイルが大きくなります。 |
watermark | いいえ | 既定はオフ。オンにすると、モデルの「AI generated」表示を編集後のクリップに焼き込みます。 デフォルト値: |
料金
元クリップの秒数で課金します。端数は切り上げ、最低 4 秒で、選んだ解像度が 1 秒あたりの単価を決めます。参考画像・参考音声・音声スイッチは料金に影響せず、失敗したタスクは無料です。
| 仕様 | 料金 |
|---|---|
| $0.045078 / 秒 |
| $0.096942 / 秒 |
ユースケース
SNS フィード向けの縦位置カット
Seedance 2.0 Fast の text-to-video は、文章から 4〜15 秒の映像を作ります。カメラの動きと音を具体的に決めてから、次のテイクを生成します。
カップルも含む検閲なしのショート
SpicyAPI は Fast に独自審査を加えません。ただし、以前の SpicyAPI の試験ではモデル側による文章の拒否があり、無制限の分類でも成人向け NSFW の全リクエストが成功する保証はありません。
最後のフレームからショットを延長する
SpicyAPI の Seedance 2.0 Fast video-extend は、元動画の最終フレームから続きを生成し、元の映像と結合して返します。
480p で下書き、720p で納品
Fast の解像度は 480p と 720p で、初期値は 720p です。480p で動きを検討した後、納品するサイズでも細部を確認してください。Fast は 0〜2147483647 の整数 seed を受け付けます。同じ乱数源で変更点を比較できますが、フレーム単位での一致は保証されません。
プロンプトガイドと実践のヒント
Seedance 2.0 Fast 用に元動画を切り出す
変えたい部分を 2〜15 秒に切り出し、480p〜1080p に収まっていることを確認してから
video_urlとして送ります。Fast 向けに編集指示を書く
「Edit @Video1:」で書き始め、変更点をひとつ挙げてから、顔、仕草とそのタイミング、小物、カメラの動きなど残すものを並べます。
Fast の編集結果を元動画と見比べる
2 本を並べて再生し、手、顔、細かな質感をコマ送りで確認します。480p で問題がなければ、同じプロンプトを 720p で実行し直します。
Seedance 2.0 Fast の動画編集でできること
Seedance 2.0 Fast は、ByteDance の動画モデル Seedance 2.0 のうち、速さと低価格を重視した版で、テイクを素早く回すために作られています。このエンドポイントでは、手元の映像の作り変えに使います。元クリップを video_url で渡すとモデルはそれを @Video1 として読み込み、プロンプトで何を変えるかを伝えます。誰が映っているか、どう動くか、カメラがどこを通るかは元動画から、衣装、照明、天気、セットの飾りつけ、全体の雰囲気は指示文から決まります。
Seedance 2.0 には編集専用のスイッチがありません。参照クリップをゆるく参考にするのか、コマ単位で作り変えるのかを指示文から判断するため、このリクエストでは長さと画面比率を元動画に固定し、残りをプロンプトに任せています。「Edit @Video1: …」のように編集として書き、残すべきものをはっきり書いてください。
リクエスト例
テストで実行した居酒屋の編集です。タスク API ガイドのとおり、Authorization: Bearer YOUR_SPICY_API_KEY を付けて POST https://api.spicyapi.ai/api/v1/jobs/createTask に送ります。
{
"model": "bytedance/seedance-2.0-fast/video-edit",
"input": {
"prompt": "Edit @Video1: change her white button-down shirt into a black silk camisole with thin straps, and turn the warm kitchen light into a deep red neon glow that reflects on the steel grill and in the rising smoke. Keep both faces, their long look across the grill, the steam, every movement and its timing, and the camera exactly as in @Video1.",
"video_url": "https://example.com/izakaya.mp4",
"resolution": "480p",
"generate_audio": true
}
}
呼び出すとすぐにタスク ID が返ります。ポーリングするか callBackUrl を渡せば、完了したタスクに編集済みの MP4 が載り、return_last_frame がオンなら最後のフレームも付きます。
元クリップの条件
- 長さは 2〜15 秒。範囲外のクリップは課金前に拒否されます。
- MP4、24〜60 fps、50 MB まで。
- 1 フレームあたり 409,600〜2,086,876 ピクセル、縦横比 0.4〜2.5。実際には 480p・720p・1080p の映像が使え、360p のクリップや 1080p を超える映像は課金なしで拒否されます。
- 顔や手は画面のある程度の面積を占めているほうがきれいに残ります。元動画にない細部を編集で作り出すことはできません。
編集指示の書き方
まず変更点を具体的に書きます(「白いシャツを黒いシルクのトップスに」「午後を赤い光の夜に」)。続けて、顔、髪、仕草とそのタイミング、小物、セット、カメラの軌道など、変えてはいけないものを挙げます。1 回の実行で変えるのは関連する 1〜2 点にとどめたほうが安定します。さらに変えたいときは、結果に対してもう一度編集をかけてください。
言葉で見た目を決めきれないときは参考の静止画が役立ちます。reference_image_urls に最大 9 枚添えて、プロンプトで指してください(「彼のジャケットを @Image1 のものに替える」)。参考音声は最大 3 本・合計 15 秒で、新しいサウンドトラックの方向を決めます。効くのは generate_audio がオンのときだけです。
音声、解像度、長さ
generate_audio は最初からオンで、編集後の映像に合う新しいサウンドトラックを作ります。例では、鉄板の焼ける音、店のざわめき、ベースラインが元の音と入れ替わりました。オフにすると、元動画の音声は引き継がれないため無音になります。
resolution は 480p と 720p から選べ、画面比率は元動画に合わせます。テストでは 16:9 の元動画が 480p で 864×496、正方形の元動画が 640×640 で返りました。長さも元動画に合わせ、1 フレームだけ長くなります(4.00 秒が 4.04 秒、5.00 秒が 5.09 秒)。Fast は 4 秒未満の動画を出力しないため、2 秒のクリップは 2 秒分を編集したあと、約 4 秒まで続きが描かれます。
料金の仕組み
料金は元クリップの秒数で決まり、端数は秒単位で切り上げ、最低 4 秒、単価は選んだ解像度のものです。5 秒のクリップは 5 秒、4.2 秒は 5 秒、2 秒は 4 秒として計算します。参考画像、参考音声、音声スイッチは料金に影響しません。SpicyAPI にアップロードしたクリップなら送信前の見積もりがそのまま請求額になり、外部リンクの場合は 15 秒分を一時的に確保して、編集完了時に差額を戻します。失敗したタスクや拒否されたタスクには料金がかかりません。
テストでわかったこと
公開前に 480p の編集を 5 回実行し、それぞれを元動画とコマ単位で比べました。5 回とも、変わったのはプロンプトで指定した部分(衣装の差し替え、セットの照明、新しい背景)だけで、人物、動き、カメラは元動画と一致しました。Moderate と Strong の内容レベルの編集は指示どおりに描かれ、拒否は 1 件もありませんでした。2 秒の元動画は 4.04 秒で返り、最初の 2 秒は元動画どおり、残りはショットの続きでした。
編集できるのは、自分で撮影したか改変の権利を持つ映像で、出演に同意した成人が映っているものに限ります。Seedance 2.0 Fast を使って実在の人物を誤解を招く場面や本人の同意のない場面に置くことは禁止です。
編集できるのは、自分で撮影したか改変の権利を持つ映像で、出演に同意した成人が映っているものに限ります。Seedance 2.0 Fast を使って実在の人物を誤解を招く場面や本人の同意のない場面に置くことは禁止です。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.0-fast/video-edit",
"input": {
"bitrate_mode": "standard",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。










