メインコンテンツへスキップ
Seedance 2.0 は信頼できる参照素材から動画を生成します — 顔、衣装、商品、 音声など。生成の一貫性とコンプライアンスを保つため、これらの参照素材は、モデルが 推論時に信頼する非公開の素材ライブラリに保存されます。OrcaRouter はそのライブラリ を /v1/asset で公開しています。 このページではライブラリの仕組みと必要な要件を説明します。正確なエンドポイント、 パラメータ、お試しコンソールについては API Reference → Seedance Assets を参照してください。

​
ライブラリの構造

  • 資産グループ（Asset Group） — コンテナです。実在人物グループでは 1 つのグループが 1 人の実在人物に対応します。バーチャルグループでは論理的なグループ分け（例: 1 つの キャラクター）になります。
  • 資産（Asset） — グループ内の単一ファイル（画像、動画、音声）です。Active 状態に 達した資産だけが動画生成で参照できます。
準備済みの資産は、動画リクエストで asset://<asset_id> として参照します。

​
2 種類のグループ

アップロードと管理の操作は両方で同一です。違いはグループの作成方法だけです。
バーチャル（AIGC）実在人物（LivenessFace）
用途架空 / AI キャラクター、小道具、シーン実在人物の肖像
作成方法直接の作成呼び出し本人による一度きりの顔認証
理由保護すべき身元がない肖像権 — 同意は源泉で取得される
どちらのライブラリも Advanced Creation Rights が必要で、容量クォータは両者で共有 されます。実在人物ライブラリは招待されたアカウントで利用できます。

​
素材ファイルの要件

素材は一般公開でアクセス可能な URL として提供します（ファイルアップロードや base64 は不可）。制限:
種類形式制約
画像jpeg、png、webp、bmp、tiff、gif、heic/heifアスペクト比(W/H) 0.4–2.5 · 1 辺 300–6000 px · < 30 MB
動画mp4、mov480p/720p/1080p · 2–15 秒 · 比率 0.4–2.5 · 300–6000 px · 総ピクセル 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
音声wav、mp32–15 秒 · ≤ 15 MB
肖像素材のベストプラクティス（顔の一貫性のため）:
  • 全身参照: 縦長で、人物の全身正面ショット。
  • 顔のクローズアップ: 縦長、無表情、肩から上のフレーミングで、顔が画面の約 3 分の 2 を 占めるように。
同一人物の良質な参照を複数同じグループにアップロードすると、生成された動画がその人物の 顔や衣服をより忠実に再現できるようになります。

​
資産のライフサイクル（アップロードは非同期）

資産をアップロードすると asset_id を即座に返します。ファイルはその後バックグラウンドで 前処理されます。資産の Status が安定するまでポーリングしてください:
  • Processing — まだ前処理中。ポーリングを続けてください。
  • Active — 準備完了。動画生成で使用できます。
  • Failed — 前処理で拒否されました。Error を確認してください（例: 形式/サイズ、 コンテンツモデレーションによるブロック、または実在人物グループの場合は FaceMismatch）。
アップロード時間の SLA は保証されません。動画素材は画像よりも時間がかかります。 資産に対して返される署名付きダウンロード URL は一時的（約 12 時間）です。

​
実在人物の認証フロー

実在人物グループは、本人が一度自己認証することで作成されます。あなたのバックエンドは 本人の顔データを一切扱わず、フローを編成するだけです:
1

セッションを開始

バックエンドが OrcaRouter に認証セッションの開始を要求します。H5 リンク（ホスト された顔チェックページ）と session_id が返ってきます。
2

本人が認証

H5 リンクをエンドユーザーに渡します。ユーザーは自分のデバイスでそれを開き — OrcaRouter へのログインは不要 — 顔チェックを完了します。一度認可すれば、後から同じ人物の新しい ルックを再認証なしで同じグループに追加できます。
3

グループが作成される

成功すると、認証ページはエンドユーザーのブラウザを OrcaRouter のコールバック（自動で 処理されます）にリダイレクトし、新しいグループが登録されます。return_url を渡していれば、 ユーザーはあなたのページに戻ります。
4

結果をポーリング

バックエンドがセッションをポーリングし、status が success（新しい group_id を伴う） または failed になるまで待ちます。その後はバーチャルグループとまったく同じように資産を アップロードし、動画を生成できます。
顔の一貫性。 実在人物グループに画像をアップロードすると、認証済みの参照と比較されます。 別人（または 1 枚の画像に複数の顔）の場合は拒否され、資産は Failed / FaceMismatch に なります。グループの名前と説明は、作成後にグループ更新操作で設定できます。

​
クォータ

アカウントには資産数の上限があります（デフォルト 100、全グループ合計）。上限を超える アップロードは 403 で拒否されます。

​
動画生成で素材を参照する

資産が Active になったら、Seedance 動画リクエスト の metadata.content[] 内で asset://<asset_id> として参照し、プロンプト内では種類 + 位置 （[Image 1]、[Video 1]、[Audio 1]）で指し示してください — 生の asset id では指定しません: 
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "The girl in [Image 1] arranges items on the counter.",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

​
次のステップ

  • API Reference → Seedance Assets — すべてのエンドポイント、完全なパラメータ、 インタラクティブなプレイグラウンド（リクエスト/レスポンスのサンプルはここにあります）。
  • Seedance 動画 — これらの素材を消費する動画生成 エンドポイント。