ByteDance: Seedance 2.0
ByteDance Seedance 2.0 は、ネイティブな音声・映像生成と画像、動画、音の参照を組み合わせます。新しいシーンの演出、既存映像の編集、シーケンスの延長ができ、標準版には文書化された 1080p と 10 ビット 4K 出力があります。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Seedance 2.0 は、マルチモーダルな音声・映像制作のための ByteDance Seed の標準モデルです。文字、画像、動画、音声を同時生成アーキテクチャで組み合わせ、参照主体のシーン、動画編集、動画延長をそれぞれ別の制作ワークフローとして提供します。一貫した演技と、準備した素材からの特定の視覚・音情報の両方が必要な制作指示に役立ちます。
マルチモーダル参照と演出制御
画像は被写体の外観、視覚スタイル、構図を定義できます。動画参照は行動、カメラ移動、効果を、音声は声質、音楽、台詞を導けます。各素材の役割を定義してから、完成すべきシーンを説明してください。メーカーは演技、照明、影、カメラ表現の制御を重視しています。
製品ストーリーでは、製品写真、カメラ移動の参照、音声の手掛かりを準備します。例えば、「Image 1 の青いガラスの花瓶を保ってください。Video 1 のゆっくりした横移動のトラッキングを使います。花瓶は日差しの当たる棚にあり、Audio 1 を基にした柔らかな器楽曲が流れます」という指示です。意図する出力は、選択した参照情報を組み合わせて新たに演出したシーンです。
参照入力は、画像と音声、画像と動画、動画と音声、3 種すべてを組み合わせられます。音声だけ、または画像・動画なしの文字と音声には対応しません。従来の文字から動画、最初のフレーム生成、最初と最後のフレーム生成も文書化されています。固定した冒頭・結末の構図が重要なら、専用の終点ワークフローを使ってください。omni-reference プロンプト内で参照画像を終点と名付ける方法は、間接的な誘導にすぎません。
映像を編集する
モデルは、被写体の置換、物体の追加・削除、要素の変更、動画の部分的な描き直しや修復ができます。具体的な変更と元映像を指定してください。追加には登場時刻と位置を含め、削除・置換では物体を正確に示し、残す内容を名指しします。
例えば、「Video 1 のデスクランプを Image 1 の真鍮のランプに置き換えてください。カメラ移動、机の配置、照明の方向を保ってください」という指示です。求める結果は、意図した置換を加えたシーンの編集版です。特に遮蔽、移動、ショット変更の途中で、新しい物体と変更しない領域の両方を確認してください。
シーケンスを延長・接続する
Seedance 2.0 は、動画の前方・後方への延長と、入力クリップ最大 3 本を生成トランジションで接続できます。時間的な方向と新しい出来事を指定してください。橋渡しではクリップを順序付け、あるショットでカメラが戸口に入り、次の環境に到着するなど、各組の間の移行を説明します。
単純な延長は通常、元映像の周辺に展開する継続部分を返します。最終結果で元区間も繰り返すなら、明確な指示を加えてください。2 本または 3 本のクリップ間の接続を完成させる場合、文書化されたワークフローは元素材と新たな移行内容の両方を含められます。これは、冒頭や結末の展開、つなぎの行動を未指定のままにせず準備済みシーンを接続する作業に役立ちます。
標準版の出力と 4K
標準版は 24 fps の MP4、4～15 秒の時間を文書化しています。出力は 8 ビット色深度の 480p、720p、1080p に加え、10 ビット色深度の 4K です。対応比率は 21:9、16:9、4:3、1:1、3:4、9:16 です。適応型フレーミングと時間の自動選択も文書化されています。Fast 版には、より限定された独自の 480p/720p 出力仕様があります。
4K 出力は H.265/HEVC エンコードを使います。10 ビットはより多くの階調と滑らかな色の移行を保ち、繊細な光や色のグラデーションを持つ素材で重要です。目的の再生・編集環境がデコードできるか確認してください。一部のブラウザーや機器は直接再生できません。対応するコンテナだけでは、動画デコードの互換性までは保証しません。
モデルは同期した音か無音動画を生成でき、次のシーン向けに最後に生成したフレームを返せます。生成音声はモノラルです。2.0 系列は独立した 2 段階 Draft プレビューモードに非対応なので、別の Seedance 版からそのプレビュー機能を推定しないでください。
参照の準備と実質的な制限
文書化された参照枠は、画像 9 枚、動画 3 本、音声クリップ 3 本です。このメーカー仕様では、実在する人間の顔を含む参照画像・動画の直接アップロードは受け付けず、人物制作には対応する人物アセットのワークフローを使います。動画・音声の各クリップは 2～15 秒です。動画参照すべての合計は 15 秒以内で、音声参照すべてにも独立した合計 15 秒の枠があります。動画は MP4 または MOV、24～60 fps、各最大 200 MB、音声は WAV または MP3、各最大 15 MB です。画像形式は JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF です。各画像は 30 MB 未満、リクエストボディは 64 MB 以下です。文書化された参照入力仕様では、画像の幅と高さはそれぞれ 300 ピクセルより大きく 6,000 ピクセル未満、幅と高さの比は 0.4 より大きく 2.5 未満です。参照動画は各辺 300～6,000 ピクセル、比率 0.4～2.5 で、境界値を含み、総画素数は 407,696～8,295,044 です。MP4 または MOV 動画は H.264/AVC または H.265/HEVC 映像、AAC または MP3 音声を使います。
ファイルを意図して並べ、Image 1、Video 1、Audio 1 のようにメディア種別と番号で参照します。番号はその種別内のファイル順に従います。引き継ぐ特性と、新シーンを定義すべきではない元内容を説明してください。文書化されたプロンプト言語には英語、スペイン語、インドネシア語、ポルトガル語、日本語があります。対話の発話言語を統一します。ガイドは固有名詞を除く言語混在を避けるよう勧めています。音声で誘導する作品では、話者、正確な台詞、話し方の指示を分けてください。
最初と最後の画像は、互換性のあるフレーミングで準備します。入力画像と出力寸法の不一致は、切り抜きや唐突な見た目の変更を起こす場合があります。寸法の一致と適応型フレーミングが対策として文書化されています。説明は出来事と参照の役割に集中させてください。メーカーは、長いプロンプトが情報を分散させ、細部を無視させる場合があると注意しています。生成された動き、参照の連続性、音声演技、シーン間のつなぎを、制作結果の別々の要素として確認します。
ショット計画と文字の指示
複雑なシーンでは、指示を Shot 1、Shot 2、Shot 3 に整理し、カメラ、被写体の行動、位置、音を順に指定してください。ガイドはショットごとのカメラ移動を 1 つとし、ゆっくりしたつながりのある行動を優先するよう推奨しています。正確なショット別タイムスタンプは不安定なので、複数の厳密な時間枠を強制するより出来事の順序で制御します。
モデルはスローガン、字幕、吹き出しなど一般的な文字も生成します。色、視覚表現、位置、登場方法を指示できます。珍しい文字や特殊記号ではなく一般的な文字を使い、動きの中の言葉を確認してください。被写体参照では、各素材を目的のキャラクターや物体に明確に結び付けます。製品の各視点は異なる視覚情報を提供できますが、キャラクターのターンアラウンドコラージュは顔の同一性を混乱させる場合があります。明瞭な顔写真と全身画像を別々に使うことが、文書化されたキャラクター参照の推奨です。
編集前に確認する挙動
ガイドには、不要な字幕、ロゴ、キャラクターの重複、スタイルの変化が記載されています。明瞭な元素材、一貫したラベル、明示的な制約はリスクを減らしますが、不要な文字や重複人物の消失を保証しません。参照人物が 4 人を超えることは安定性のリスクと報告され、モデルが受け付けるファイル数とは別です。
動画延長ではつなぎ目が飛んだり巻き戻ったりし、継続を繰り返すと画質低下が累積する場合があります。境界フレームを確認し、延長を重ね過ぎないでください。参照した声が元の声質と異なる場合があり、ナレーションはクリック音や急な途切れで終わることがあります。その対策として音声フェードが文書化されています。中国語の多音字、珍しい文字、似た形の文字は発音を誤る場合があります。カウントダウンなど正確なアニメーション効果では、言葉だけの要求より動きの参照が有益です。これらは、クリップを選ぶ際に同一性、文字、動き、音を別々に確認する具体的な理由です。
Ailoot Ultra · 動画 POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0はじめに
ByteDance Seedance 2.0 は、ネイティブな音声・映像生成と画像、動画、音の参照を組み合わせます。新しいシーンの演出、既存映像の編集、シーケンスの延長ができ、標準版には文書化された 1080p と 10 ビット 4K 出力があります。
- 対応する入力
- テキスト · 画像 · 音声
- 結果
- 動画
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 動画 POST /v1/videos
- 入力の種類
text,image,audio- 出力の種類
video- 出力形式
- 元のMP4バイト列（正規化・トランスコードなし）
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 bytedance/seedance-2.0 | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドduration | 種類integer | 要件必須 | 値と制限 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 最小値: 1 最大値: 600 | デフォルト— |
フィールドresolution | 種類string | 要件任意 | 値と制限 480p, 720p, 1080p, 4K | デフォルト— |
フィールドaspect_ratio | 種類string | 要件任意 | 値と制限 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | デフォルト— |
フィールドgenerate_audio | 種類boolean | 要件任意 | 値と制限 false, true 条件: 480pと720pでは、generate_audioを省略すると音声ありの料金、falseにすると音声なしの料金が選択されます。1080pと4Kでは、どちらの設定でも解像度に応じた料金が適用されます。返された音声トラックについては、結果のhas_audioを確認してください。 | デフォルト— |
フィールドframe_images | 種類array | 要件任意 | 値と制限 最小項目数: 1 最大項目数: 2 入力コンテンツ: フレームオブジェクトの配列。各オブジェクトにはtype=image_url、urlを含むimage_url、およびframe_type=first_frameまたはlast_frameを指定します。各役割はそれぞれ最大一回まで指定できます。公開HTTPS URLを使用してください。 正確なキー: type, image_url, frame_type 条件: これらのキーは各フレームオブジェクトに適用されます。テキストのみのリクエストではframe_imagesを省略してください。 | デフォルト— |
フィールドinput_references | 種類array | 要件任意 | 値と制限 入力コンテンツ: 画像または音声の参照オブジェクトの配列。typeをimage_urlまたはaudio_urlに設定し、urlを含む対応するURLオブジェクトを指定してください。動画の参照素材については、引き続き料金を算出できません。 条件: 参照モードを使用する場合はframe_imagesを省略してください。公開HTTPS URLを使用します。 | デフォルト— |
フィールドsize | 種類string | 要件任意 | 値と制限 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 パターン: ^[1-9][0-9]*x[1-9][0-9]*$ | デフォルト— |
フィールドseed | 種類integer | 要件任意 | 値と制限 最小値: -9,223,372,036,854,775,808 最大値: 9,223,372,036,854,775,807 | デフォルト— |
フィールドcallback_url | 種類string | 要件任意 | 値と制限 パターン: ^https:// | デフォルト— |
フィールドsession_id | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドtrace | 種類object | 要件任意 | 値と制限 | デフォルト— |
フィールドuser | 種類string | 要件任意 | 値と制限 | デフォルト— |
入力素材の組み合わせ
テキストから動画へ · テキストのプロンプト。 · 必須: model, prompt, duration
テキストのプロンプトと、サポートされている整数の秒数を指定してください。一覧にある正確なサイズ、または一覧の寸法に対応する解像度とアスペクト比を使用します。
model: 種類: string · bytedance/seedance-2.0
prompt: 種類: string · 最大UTF-8バイト数: 10,000 · 空白以外の文字が必須: はい
画像から動画へ · テキストのプロンプトとフレーム画像。 · 必須: model, prompt, duration, frame_images
frame_imagesはオブジェクトの配列で、各オブジェクトにはtype=image_url、urlを含むimage_url、およびframe_typeを指定します。公開HTTPS画像URLを使用してください。first_frameとlast_frameはそれぞれ一度だけ指定できます。一覧にある出力サイズ、または互換性のある寸法を使用してください。動画の参照素材は追加しないでください。
正確なキー: type, image_url, frame_type
model: 種類: string · bytedance/seedance-2.0
prompt: 種類: string · 最大UTF-8バイト数: 10,000 · 空白以外の文字が必須: はい
Reference to video · テキストのプロンプトと、画像または音声の参照素材。 · 必須: model, prompt, duration, input_references
input_referencesは配列です。各オブジェクトにはtype=image_urlまたはtype=audio_urlと、urlを含む対応するURLオブジェクトを指定します。公開HTTPSリンクを使用してください。参照モードを選ぶ場合はframe_imagesを省略します。動画の参照素材の料金は算出できません。
model: 種類: string · bytedance/seedance-2.0
prompt: 種類: string · 最大UTF-8バイト数: 10,000 · 空白以外の文字が必須: はい
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, prompt, duration |
パラメータmaterial_types | 仕様text, image, audio |
パラメータadditional_properties | 仕様false |
パラメータoptional_controls | 仕様resolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
ライフサイクル: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
料金
最終料金の計算方法
表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値（default）を使用する場合
比較用の推定料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 予測数量 | 課金単位 | 課金条件 | 料金 |
|---|---|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 予測数量— | 課金単位— | 課金条件— | 料金 入力 · 入力トークン · 比較専用の見積もり — / 1K トークン 出力 · 出力トークン · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン 入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン |
| 設定動画トークン料金 | 料金表— | 予測数量— | 課金単位1K動画トークンあたり | 課金条件この価格キーには追加条件が定義されていません。 | 料金 出力 · 動画トークン料金 · 比較専用の見積もり $0.014 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 料金表— | 予測数量— | 課金単位1K動画トークンあたり | 課金条件resolution: 1080p | 料金 出力 · 動画トークン料金 · 比較専用の見積もり $0.0154 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 料金表— | 予測数量— | 課金単位1K動画トークンあたり | 課金条件入力：with_video_input；解像度：1080p | 料金 reference · 動画トークン料金 · 比較専用の見積もり $0.0094 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 料金表— | 予測数量— | 課金単位1K動画トークンあたり | 課金条件resolution: 4k | 料金 出力 · 動画トークン料金 · 比較専用の見積もり $0.008 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 料金表— | 予測数量— | 課金単位1K動画トークンあたり | 課金条件入力：with_video_input；解像度：4k | 料金 reference · 動画トークン料金 · 比較専用の見積もり $0.0048 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 料金表— | 予測数量— | 課金単位1K動画トークンあたり | 課金条件入力：with_video_input | 料金 reference · 動画トークン料金 · 比較専用の見積もり $0.0086 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 料金表— | 予測数量— | 課金単位1K動画トークンあたり | 課金条件音声：without_audio | 料金 出力 · 動画トークン料金 · 比較専用の見積もり $0.014 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定生成費用の見積もり | 料金表— | 予測数量生成1回分の概算 | 課金単位— | 課金条件— | 料金 出力 · 推定生成コスト · 比較専用の見積もり $0.3024 生成前の見積もり この見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。 |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
参考料金の詳細
モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。
動画設定の料金参照情報
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 課金条件 | 料金 |
|---|---|---|
| 設定動画トークン料金 | 課金条件この価格キーには追加条件が定義されていません。 | 料金 出力 · 動画トークン料金 $0.014 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 課金条件resolution: 4k | 料金 出力 · 動画トークン料金 $0.008 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 課金条件resolution: 1080p | 料金 出力 · 動画トークン料金 $0.0154 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 課金条件音声：without_audio | 料金 出力 · 動画トークン料金 $0.014 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 課金条件入力：with_video_input | 料金 reference · 動画トークン料金 $0.0086 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 課金条件入力：with_video_input；解像度：4k | 料金 reference · 動画トークン料金 $0.0048 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
| 設定動画トークン料金 | 課金条件入力：with_video_input；解像度：1080p | 料金 reference · 動画トークン料金 $0.0094 1K動画トークンあたり 動画トークン単価が主な価格参照値です。見出しに表示される秒単位の概算料金は別の参照値であり、追加料金ではありません。 |
リクエスト例
Ailoot Ultra · 動画
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
結果を受け取って保存
Ailoot Ultra · 動画
所有コンテンツの署名付きURL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
ジョブのステータスを確認
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
その他のコンテンツ取得
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
完了した結果をすべて保存
完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。
実際に得られた所有出力と、返された実測メタデータをすべて保持してください。
元のレスポンスを確認する場合
503 result_pending_check + 元のid + X-Should-Retry:false；元のリクエストを決して再実行しないでください
レスポンスのフィールド
| フィールド | 種類 | 意味 |
|---|---|---|
フィールドindex | 種類integer | 意味出力リスト内での、この動画のゼロ始まりの位置。 |
フィールドcontent_url | 種類string | 意味この完了済み動画の署名付きHTTPSダウンロードURL。 |
フィールドsha256 | 種類string | null | 意味元の動画バイト列のSHA-256ダイジェスト。取得できない場合はnullです。 |
フィールドsize_bytes | 種類integer | null | 意味元の動画ファイルのサイズ（バイト）。取得できない場合はnullです。 |
フィールドduration_ms | 種類integer | null | 意味実測された動画の長さ（ミリ秒）。取得できない場合はnullです。 |
フィールドwidth | 種類integer | null | 意味動画の幅（ピクセル）。取得できない場合はnullです。 |
フィールドheight | 種類integer | null | 意味動画の高さ（ピクセル）。取得できない場合はnullです。 |
フィールドvideo_codec | 種類string | null | 意味動画コーデックの識別子。記録されていない場合はnullです。 |
フィールドhas_audio | 種類boolean | null | 意味動画に音声トラックが含まれるかどうか。未測定の場合はnullです。 |
フィールドaudio_codec | 種類string | null | 意味音声コーデックの識別子。識別子が記録されていない場合はnullです。 |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス404 · not_found_error | 条件動画へのアクセスが利用できないか、この動画IDが見つかりません。 | 次の手順動画へのアクセス権を確認してください。既存の動画には、元の公開IDと同じAPIキーを使用してください。 |
レスポンス401 · authentication_error | 条件APIキーが認証済みアカウントと一致しません。 | 次の手順送信する前に、APIキーとアカウントのアクセス権を確認してください。 |
レスポンス400 · invalid_request_error | 条件リクエストを読み取れないか、ダウンロードのインデックスが無効です。 | 次の手順リクエスト本文を修正してください。ダウンロードする場合は、元のタスクから返された出力インデックスを選択してください。 |
レスポンス422 · price_unavailable | 条件選択された動画設定の料金を算出できません。 | 次の手順サポートされている動画設定を選び、必須オプションをすべて指定してから、修正したリクエストを送信してください。 |
レスポンス422 · invalid_request_error | 条件動画入力、または元の継続タスクが無効です。 | 次の手順有効なHTTPS入力を使用してください。継続する場合は、完了した元の動画の公開IDと、同じAPIキーを使用してください。 |
レスポンス402 · billing_error | 条件利用可能な残高または上限の制約により、料金を仮押さえできません。 | 次の手順新しいリクエストを送る前に、利用可能な残高と上限を確認してください。 |
レスポンス503 · server_error | 条件動画の検証、保存領域、またはサービスへのアクセスを一時的に利用できません。 | 次の手順サービスが利用可能になるまでお待ちください。すでに動画IDがある場合は、別の生成を作成せず、その元のタスクを確認してください。 |
レスポンス503 · result_pending_check | 条件元の動画の結果と請求額を確認する必要があります。 | 次の手順返された動画IDを保持し、そのタスクを確認してください。確認中に、代わりの生成リクエストを送信しないでください。 |
レスポンス503 · owned_result_unavailable | 条件既存の動画のダウンロードを一時的に利用できません。 | 次の手順後で同じ動画タスクを確認し、その既存の出力をダウンロードしてください。新しい生成を行うと、別の操作が作成されます。 |
レスポンス409 · video_not_ready | 条件動画コンテンツは公開されていません。 | 次の手順元のタスクのステータスを確認してください。completedと報告されたらダウンロードします。failedと報告された場合は、その料金確認の通知に従ってください。 |
エイリアス
モデルのエイリアス
Ailoot Ultra bytedance/seedance-2.0
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · ByteDance: Seedance 2.0
- 利用できる入力と結果は何ですか？
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- リクエストはどの項目を使用しますか？
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- どの制限が適用されますか？
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807