Skip to main content
要約：テキストから動画への変換は影響を受けず、約1秒でタスク ID が返されます。リクエストに画像または動画が含まれる場合は、そのメディアをまずアセットライブラリに取り込み、asset:// アセット ID を取得して、動画生成リクエストでそれを参照してください。 リクエスト本文はメガバイト単位から数十バイト程度まで小さくなり、タスク作成エンドポイントは直ちに応答し、メディアのコンテンツチェックは代わりに取り込み時に実行されます。このページでは、送信の速度と信頼性について説明します。アセットライブラリのエンドポイントごとのドキュメントについては、アセットライブラリを参照してください。エンドツーエンドで実行できるコードについては、アセット参照ガイドを参照してください。

​
まず、遅いのは送信ですか、それとも生成ですか？

Seedance は非同期のタスクベース API です。1つのクリップには2つの独立したフェーズがあり、それぞれのレイテンシーの原因はまったく異なります。 この2つのフェーズは独立しています。「送信に60秒かかった」と「生成に5分かかった」は別々の問題です。そのため、何かを変更する前に、どちらが遅いのかを特定してください。コンソールログの所要時間の列は最初のバイトまでの時間であり、フェーズ1に対応します。クリップの生成が完了するまでの合計時間ではありません。コンソールの所要時間とクライアントの待機時間を参照してください。
よくある誤診: 画像を含むリクエストに60秒の読み取りタイムアウトを設定し、そのタイムアウトを「サービスが停止している」と判断して、すぐに再送信してしまうことです。実際には、メディアはまだ転送中でした。再送信すると同じペイロードをもう一度アップロードすることになり、同じ上り帯域幅を奪い合い、重複したタスクが作成されて課金される可能性があります。

​
メディアの渡し方3通りの比較

同じ画像でも、送信時の挙動は3つの方法で大きく異なります。 最初の2つは、モデルや推論によって決まるものではありません。両端の帯域幅とファイルサイズに左右されるため、どちらも遅く、予測しにくくなります — 同じコードでも、今日は8秒で完了するのに、明日は90秒かかることがあります。asset:// 参照では、このコストを事前に1回だけ取り込み手順へ移せます。その後の生成では、短い文字列だけを送信します。

​
アセットファーストは速いだけではありません

ファイルサイズに左右されない送信時間

リクエストボディはプロンプトとアセット IDだけなので、タスク作成のレイテンシーはテキストから動画への変換と同等の水準に戻り、クライアントのタイムアウトは30～60秒あれば十分です。

リトライのコストはほぼゼロ

異なるプロンプト、アスペクト比、または再生時間で再実行する場合も、数メガバイトのメディアを再送信する代わりに、数十バイトを再送信するだけです。

コンテンツチェックを早い段階で実行

メディアは取り込み時に検証され、Activeまでポーリングされるため、準拠していないコンテンツは生成タスクの途中で失敗するのではなく、その場で検出されます。

アセットを再利用可能

一度取り込めば無期限に再利用できます。同じアセット IDをショットやエピソード間で参照することで、キャラクターの一貫性も向上します。
最適化ではなく必須要件となるケースが1つあります。フォトリアルな人間の顔を含むメディアは、直接参照画像として渡すことができないため（ディープフェイク対策）、取り込んだうえでasset://として参照する必要があります。アセットライブラリを参照してください。

​
3つのステップで移行

1

メディアを取り込み、アセット ID を取得する

コード不要でウェブ UI からアップロードすることも、API 経由で一括取り込みすることもできます。どちらの方法でも同じライブラリを使用します。アセットライブラリを参照してください。ステータスが Active になるまでポーリングします（単一画像の場合は約 13 秒）。その後、アセットを使用できるようになります。アセットライブラリは Seedance API で無料です — 年額料金はかかりません。
2

生成リクエスト内のインラインデータを asset:// に置き換える

content の構造、role の値、その他すべてのパラメータは変わりません。変わるのは image_url.url の値だけで、データ URL から asset://<Id> になります。プロンプト内では、渡した順序に従ってメディアを「image 1」「image 2」として参照してください — アセット ID をプロンプトテキストに記述しないでください。
3

アセット ID を独自のデータベースに保存する

アセット ID は長期間有効なので、同じファイルを二度アップロードしないでください。ローカルメディアとそのアセット ID の対応関係を保持し、それ以降の生成では毎回そこから読み取ってください。
変更前と変更後の違いは、フィールド値が正確に 1 つだけです。
変更前: 画像全体をインラインで指定し、リクエストボディは数 MB
変更後: リクエストボディは数百バイトで、タスク ID がすぐに返される
実行可能な完全なスクリプト（アップロード、取り込み、生成、ダウンロード）については、アセットリファレンスガイドを参照してください。

​
最初/最後のフレームジョブについて

最初/最後のフレーム（role: "first_frame" / "last_frame"）とマルチモーダル参照（role: "reference_image"）は、意味の異なる相互排他的な入力モードです。一方をもう一方に無造作に置き換えないでください。
  • 正確な開始フレームと終了フレームが本当に必要な場合 — たとえば、前のクリップと継ぎ目なく連結する場合 — 最初/最後のフレームモードを維持し、インライン data URL を公開 URLに置き換えてください。リクエストボディは直ちに数メガバイトから数百バイト程度まで小さくなり、残りの取得コストは上流側に移ります。画像は、高速で、認証不要かつ十分なリソースを備えた場所でホストしてください。
  • 実際に必要なのが一貫したキャラクターやシーンであり、境界フレームをピクセル単位で一致させる必要がない場合は、asset:// アセット ID を使用したマルチモーダル参照生成に切り替えてください。これが最も信頼性の高い方法であり、本ページで推奨している方法です。
クリップをつないで長い動画にする場合、最後のフレームを自分で抽出する必要はありません。return_last_frame: true を渡すと、次のタスクの最初のフレームとして使用できるウォーターマークなしの最後のフレームの png が取得できます。

​
参照動画と音声

参照動画（role: "reference_video"）は画像より桁違いに大きいため、インライン Base64 が送信タイムアウトの最も可能性の高い原因です。使用は避けてください。
  • パブリック URL を優先してください。高速で、認証が不要で、十分なリソースを備えた場所でホストしてください。
  • 本人確認済みユーザーのアセットグループでは、アセットライブラリ の本人確認フローを通じて、動画と音声を取り込めます（動画：mp4 / mov、2～15秒、50MB未満、音声：mp3 / wav、2～15秒、15MB未満）。
  • 注目すべき点として、参照動画を使用するタスクは低い料金ティアが適用されます。動画入力ありの場合は100万 tokensあたり $7.56、なしの場合は $12.60です。概要のモデル料金を参照してください。

​
タイムアウト後の対応

create-task POST がタイムアウトした場合、クライアントはタスクが作成されたかどうかを判断できません。レスポンスヘッダーが到着していないため、照会するタスク ID が存在しないからです。次の順序で対応してください。
1

何かを再送信する前にレコードを確認する

APIYI コンソールのログまたは課金情報で、その時刻の記録を確認します。記録が存在する場合、タスクは作成され、課金されています。タスク ID は記録内にあるため、その ID を直接ポーリングしてください。記録がない場合に限り、リクエストが完了していなかったことを意味します。何も確認せずに再送信すると、タスクが重複して作成され、重複分も課金されます。
2

読み取りタイムアウトとメディア方式を同時に変更する

読み取りタイムアウトだけを延長しても、症状に対処しているにすぎません。asset:// を使用している場合、create リクエストのタイムアウトは 30～60 秒 あれば十分です。非同期エンドポイント自体は高速で、実際の処理はタスク側で行われるためです。大容量のメディアをインラインで送信し続ける必要がある場合は、接続タイムアウトと読み取りタイムアウトを別々に設定し、ファイルサイズとアップリンク帯域幅に基づいて読み取りタイムアウトを決めてください。
3

さらに調査する前に同時実行数を減らす

大容量のメディアを含む複数の同時 create リクエストは、同じアップリンクを競合して使用します。その結果、すべてのリクエストが設定したタイムアウト値ちょうどでタイムアウトすることがあります。まず単一のリクエストを成功させてから、同時実行数を徐々に増やしてください。
4

ベース URL を確認する

ベース URL が異なるとネットワーク経路も異なり、大容量のアップロードの挙動も変わる場合があります。利用可能な各エンドポイントに対する送信時間を自分のサーバーから測定し、最も高速なものを使用してください。エンドポイントの一覧と選び方については、ベース URL の設定 を参照してください。
一般的なタイムアウトのトラブルシューティング、つまりクライアントのタイムアウトをどの程度に設定すべきか、また問題のあるレイヤーを切り分ける方法については、API タイムアウトを回避する方法 を参照してください。

​
FAQ

いいえ。メディアを添付しない場合、リクエストボディは prompt だけになり、タスク作成エンドポイントは約1秒でタスクIDを返すため、ここで説明している内容は該当しません。
1枚の画像の前処理とActiveへの到達には約13秒かかります。すべて自動で行われ、手動レビューは必要ありません。重要なのは、これが一度だけ発生することです。同じアセットはその後、無期限に参照できます。一方、インラインアップロードでは、生成するたびに転送全体を毎回繰り返す必要があります。生成するクリップが増えるほど、その差は大きくなります。
いいえ。完成したクリップの URL とは異なり、アセットIDは長期間使用できます。アセットはお客様の icover.ai アカウントに紐付けられるため、ご自身のアセットだけを表示・使用できます。
いいえ。Seedance API に無料で含まれており、年間料金はかかりません。Volcengine 独自のプライベートアセットライブラリは、フレームワーク契約のないお客様向けに別途購入するアドオンで、年間契約額は CNY で6桁です。
content.video_urlは24時間有効な署名付き直接リンクです。タスクが成功したら、できるだけ早くファイルを自分のストレージにコピーし、その URL を永続的なアドレスとして他者に渡さないでください。
いいえ。2つのキーは混同しないでください。アセットライブラリの KEY は icover.ai で作成し、アセットのアップロード、取り込み、照会にのみ使用します。APIYI Seedance 動画 token は api.apiyi.com で作成し、SeeDance2グループを選択する必要があり、動画生成 API にのみ使用します。

​
関連ページ

アセットライブラリ

すべてのアセットライブラリエンドポイント、コード不要のWeb UI、本人確認

アセットリファレンスガイド

アップロードと取り込みからダウンロードまでのエンドツーエンドで実行可能なスクリプト

Seedance 2.0 / 2.5 概要

モデル選択、料金表、解像度表、よくある質問