メインコンテンツへスキップ
POST
POST /v1/videos/generations で送信し、data[0].task_id を取得して GET /v1/tasks/{task_id} で結果を確認します。
string
必須
Authorization: Bearer <token> を使用します。<token> は APIMart API キーです。

リクエストパラメータ

string
必須
seedance-2-5-flash を使用します。別名 doubao-seedance-2-5-flash も利用できます。ドットを含む seedance-2.5-flash は非対応です。
boolean
デフォルト:"false"
動画タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • true:omni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
検出時は HTTP 400(nsfw_content_detected)となり、タスク作成や生成料金の課金は行いません。参照動画と音声は審査対象外です。審査サービスの異常時は送信が続行される場合があります。
string
必須
必須のプロンプト。参照素材は @图片1 / @视频1 / @音频1 で指定します。番号は1から始まり、各素材配列の順序に対応します。
string
デフォルト:"720p"
480p / 720p のみ。既定値は 720p。1080p、2k、4k などは送信時に HTTP 400 になります。
string
デフォルト:"adaptive"
16:9、4:3、1:1、3:4、9:16、21:9、adaptive(既定値)に対応。別名は aspect_ratio。開始・終了フレーム、編集、延長では adaptive のみ使用できます。
integer
整数の秒数 4–30。通常は省略時 5、-1 は自動です。明示的な edit は -1 または省略のみで、省略は -1 として扱い、出力時間は元動画に従います。自動時間では30秒分を仮引き落としし、実際のトークン使用量で精算します。
boolean
デフォルト:"true"
音声を生成するかどうか。既定値は true、別名は audio。入力の参照音声 audio_urls とは別の設定です。
boolean
デフォルト:"false"
AI生成の透かしを付けるかどうか。既定値は false。
integer
任意の乱数シード。同じ値でも完全に同一の結果は保証されません。
string
デフォルト:"mp4"
出力形式は mp4(既定値)または mov。
string
デフォルト:"auto"
auto(既定値)、reference、edit、extend に対応。参照素材があるタスクのみで使用します。種類を明示すると送信時に下表の制約を検証します。
string[]
参照画像配列。すべて reference_image として扱います。image_with_roles と合計で最大10枚。開始・終了フレームには image_with_roles を使用します。
object[]
各要素は url と role を含みます。役割は reference_image、first_frame(最大1枚)、last_frame(最大1枚、開始フレームと併用)。image_urls と合計で最大10枚。矛盾する役割を混在させないでください。video_urls / audio_urls がある場合、開始・終了フレームは参照画像として扱われます。
string[]
最大5本、各2–30秒、合計30秒以内。編集元の動画は4–30秒である必要があります。
string[]
最大5件、各2–30秒、合計30秒以内。音声のみの参照に対応し、画像や動画は必須ではありません。
boolean
デフォルト:"false"
true の場合、成功後に終了フレーム画像を data.result.videos[].last_frame_url で返します。
モデルが必要に応じてウェブ検索することを許可します。既定値は false。
object[]
任意のツール一覧。例:ウェブ検索用の [{"type":"web_search"}]。
draft / draft_task_id は非対応です。リクエストから削除してください。送信すると HTTP 400 になります。ドラフト機能には Seedance 2.5 を使用します。

素材の要件

公開アクセス可能な http(s) URL、または承認済みの asset:// ID を使用します。出力解像度と入力動画の画素制限は別々に検証されます。

タスクの種類と制約

明示した種類や制約が不正な場合、タスク作成・課金前に HTTP 400 を返します。auto では素材とプロンプトから種類を判断するため、生成中に制約違反で失敗する場合があります。明示した種類とプロンプトの意図が異なる場合も InvalidParameter.TaskTypeMismatch が発生し得ます。

リクエスト例

マルチモーダル参照

開始・終了フレーム

動画編集

動画延長

非公開素材の利用

実在人物の顔を含む画像・動画は、素材ライブラリで承認後に asset:// を使用します。アップロード時の model も seedance-2-5-flash にします。素材ライブラリ API を参照し、以下の Flash モデル名を使用してください。
統一タスク API で素材の審査を確認します。承認後、素材一覧から asset:// ID を取得し、image_urls、image_with_roles[].url、video_urls、audio_urls に指定します。

タスク状態と結果

タスク状態 API をポーリングします。pending / processing は処理中、completed は成功、failed は失敗。動画は data.result.videos[0].url[0] から取得します。url は配列です。

料金の計算

  • 送信時は解像度別の秒単価で仮引き落としします。参照動画がある場合は入力ありの料金区分を使用し、出力時間と参照動画の合計時間を加算します。
  • 通常の duration 省略時は出力5秒分、duration: -1 または edit で時間を省略した場合は出力30秒分です。
  • 成功後は data.usage.completion_tokens ÷ 1,000,000 × 該当する100万トークン単価にアカウント割引を適用し、差額を返金または追加請求します。参照動画の有無で token / token-input を選択します。最終額は data.cost を確認してください。
  • 送信拒否には生成料金がかからず、生成失敗時は仮引き落とし分を返金します。単価と割引は料金ページを参照してください。

よくあるエラー