動画を作成(Seedance)
このシリーズはOpenAIの動画生成形式をサポートしています(詳細はリンク 動画生成Sora互換形式 を参照してください)。
動画生成タスクを作成し、タスクIDを使用してステータスと結果を照会するために使用します。
タスク作成の主要フィールド:
model:必須、モデル名。prompt:必須、動画生成のメイン説明文。content:任意。Volcano Ark の content 配列で、テキスト、画像、動画、音声素材を混在して配置できます。function_mode:任意、通常、万能リファレンスなどのアドバンスドモードで使用されます。
互換性のある入力パラメータ:
mode:t2v / i2v / i2v_first_last / reference_images / reference_materialimage_url / image_urls / input_referenceend_image_url / last_image_urlvideo_urls / audio_urlsseconds / durationaspect_ratio / ratio / sizequality / resolutionfpsgenerate_audio / watermark
呼び出しの詳細:
mode=reference_materialまたはfunction_mode=omni_referenceの場合、contentを介してテキストとリファレンス素材を渡すことを推奨します。contentテキスト項目の記述形式は{ "type": "text", "text": "测试文字" }です。content画像、動画、音声素材項目はそれぞれimage_url、video_url、audio_urlのオブジェクト形式を使用します。例:{ "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }。roleで素材の用途を識別でき、nameはプロンプト内で名前指定による参照に使用できます。ratio、duration、resolution、fpsは、最終的な生成設定に影響します。
Gemini Omni の呼び出し:
gemini-omniは、本 Seedance タスク API からも呼び出せます。mode=t2vはテキストから動画の生成に使用し、mode=r2vは参照画像/参照素材を用いた生成に使用し、mode=editは動画編集に使用します。- テキストは
promptまたはcontentのtext項目に配置できます。画像はimage_url / image_urls / reference_images / input_reference / contentに、動画はvideo_urls / contentに配置できます。 - 再生時間フィールドは
durationまたはsecondsを使用でき、4 / 6 / 8 / 10 秒のいずれかに自動でマッチします。
照会結果の注目フィールド:
items[].statusitems[].content.video_urlまたはitems[].video_urlitems[].erroritems[].progress
Error fields: error.code, error.message.
{
"error": {
"code": "invalid_request_error",
"message": "requires at least one image in `images`"
}
}
承認
Bearer Token を使用して認証します。
形式: Authorization: Bearer sk-xxxxxx
ボディ
必須。モデル名。Seedance の公開モデルを指定することも、gemini-omni を指定することもできます。
doubao-seedance-1-0-lite-i2v-250428, doubao-seedance-1-0-lite-t2v-250428, doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015, doubao-seedance-1-5-pro-251215, doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, gemini-omni "doubao-seedance-2-0-260128"
必須。動画生成のメイン説明です。空にすることはできません。
"参考素材生成一段剧情短视频"
任意指定。火山方舟の content 配列で、テキスト項目と素材項目を順番に混在させます。テキスト項目には { "type": "text", "text": "..." } を使用します。画像、動画、音声項目にはそれぞれ image_url、video_url、audio_url オブジェクトを使用し、その中に url を設定します。必要に応じて role(例: reference_image、reference_video、reference_audio)と name を組み合わせて、テキストから参照できます。
任意。高度な機能モードです。全般的なリファレンス用の omni_reference などがあります。
任意。互換モードのフィールド。t2v、i2v、i2v_first_last、reference_images、reference_material など。gemini-omni は t2v、r2v、edit をサポートします。
任意。単一の参照画像URL。
任意。複数の参照画像URLのリスト。
任意。互換性のためのリファレンス入力フィールドです。
任意。最終フレームの参照画像の URL。
オプション。最終フレームの参照画像URLのエイリアス。
任意。参照用動画URLのリスト。
任意。参照オーディオURLのリスト。
オプション。動画の長さ(秒)。duration と互換性があります。
オプション。動画の長さ(秒)。seconds と互換性があります。
任意。アスペクト比(例:16:9)。
任意。アスペクト比のエイリアス(例:16:9)。
任意。解像度またはサイズ互換フィールド。
任意。生成品質の設定。
任意。出力解像度。
任意。フレームレート。
任意。オーディオを生成するかどうか。
任意。ウォーターマークを追加するかどうか。
