アセットライブラリが必要な理由
キャラクターの一貫性を保った動画を生成する場合、Seedance 2.0 は人の顔を含む参照画像を直接受け付けません(ディープフェイク防止フィルタリング)。まず画像を信頼済みアセットとして取り込み、asset://xxx asset ID を取得してから、その ID を動画生成リクエストで参照する必要があります。
このサービスが取り込みを代行します。画像をアップロード → アセット ID を取得 → 動画を生成するだけです。使い方は 2 通りあり、データは両者で完全に共有されます:
方法1: Web UI(初心者におすすめ)
サインアップしてログイン
アップロードして取り込み
- アセットグループは任意です。システムが自動的にデフォルトグループを使用します。キャラクターごとにアセットを整理したい場合は、先にグループを作成してください。
- 画像要件: jpeg / png / webp / bmp / tiff / gif / heic; アスペクト比 0.4–2.5; 辺の長さ 300–6000px; 各30MB未満。
アセット ID をコピー
asset://xxxアセット ID をコピーします。動画を生成
asset:// IDs を取得できます。同じ演者が別のスタイリングでも同じグループを再利用でき、再認証は不要です。

The asset library web UI: the ingest tab for manual uploads, the asset list / archive tab for browsing assets and copying asset:// IDs, and the real-person verification tab for verifying and uploading real-face assets
方法 2: API(開発者向け)
ステップ 0: Asset Library KEY を作成する
icover.ai にログイン後、Settings → Asset Library KEY(icover.ai/en/settings/apikeys)に進み、sk-... 形式の KEY を作成してください。

Settings → Asset Library KEY: click the create button and copy the generated sk-... key (note this is separate from the APIYI Token entry in the sidebar)
ステップ 1: ファイルをアップロードして公開 URL を取得する
アセットファイル(画像。実在人物アセットでは動画 / 音声もサポートします)は、まず公開 URL からアクセスできる必要があります。どちらかの方法を選んでください: A. すでに公開 URL がある場合(ご自身の CDN / ファイルホスト)→ ステップ 2 に進みます。 B. 当社のストレージにアップロードする場合(2 回の呼び出し: 署名付きアップロード URL を要求 → ファイルを PUT する):ステップ 2: アセットを取り込む
groupIdは任意です。デフォルトのグループが自動的に使用 / 作成されます。キャラクターごとに整理するには、まずPOST /api/asset-library/groups {"name":"actor-A"}で group ID を取得し、ここに"groupId":"group-xxx"を含めてください。labelは任意です。Web UI でアセットを識別しやすくなります。
ステップ 3: Active になるまでポーリングする
Ingest は非同期です(画像 1 枚あたり約 13 秒、SLA なし)。返された Id でポーリングします:Active が 90 秒間ない場合は、タイムアウトとして調査してください。
ステップ 4: アセット ID を使って動画を生成する(APIYI 経由)
アセット ID はasset://<Id> として記載し、APIYI に ご自身の APIYI SeeDance2 token(asset library KEY ではありません)で呼び出してください:
エンドポイント一覧
[client] を前置したプレーンテキストです(400/401/403/404/502)。records、real-person/sessions の GET/PATCH/DELETE、そしてアセット PATCH は {code, message, data} JSON(code 0 = success)を返します。
実在人物アセット(完全自動 API)
実在人物のポートレートでは、撮影される本人(アクター)が一度だけ 生体認証 を完了し、ポートレート権利の所有をソースで固定する必要があります。全体のフローは現在すべて API 駆動で、web UI の「実在人物認証」タブは、インターフェースを備えた同じフローです。ステップ 1: 認証セッションを開始して H5 リンクを取得する
H5Linkをアクターに送って スマートフォンで開いてもらいます(または QR コードにしてスキャンしてもらいます)。アクターは個人の Volcengine アカウントにログインし、生体認証を完了します。照明やカメラアングルによって失敗することがあるため、その場合は再試行してください。BytedTokenは照会用資格情報です。セッションと一緒に保存されます。GET /api/asset-library/real-person/sessionsで、いつでもセッション一覧(id / status / h5Link を含む)を確認できます。
ステップ 2: アクターが完了したら結果を照会する
GroupId を取得すると、セッションの status は authorized に変わり、実在人物アセットグループは自動的にアカウントへアーカイブされます(web UI のアセットグループにも表示されます)。注: 保留中の認証は、期限切れの資格情報と同じ NotFound を返します。両者を見分けることはできません。長時間使用されなかったリンクは期限切れになることがあります。その場合は、新しいセッションを開始してください。
ステップ 3: 実在人物グループにアセットを送信する
仮想アバターと同じ ingest エンドポイントです。実在人物グループのgroupId を渡すだけです。画像、動画、音声に対応しています。
Active までポーリングし、asset://<Id> で動画を生成します(ステップ 4 は変更ありません)。
実在人物アセットのルールとフォーマット:
- 1 つの実在人物グループに含められるのは 1 人のみ です。同じアクターでスタイルが違っても同じグループを再利用でき、再認証は不要です。
- すべてのアップロードは 顔一致チェック を通ります(動画は 1 秒ごとにサンプリングされ、サンプリングされたすべてのフレームが通過する必要があります)。横顔、複数人、ぼやけた素材は失敗します。鮮明な正面素材を使用してください。
- 画像は 30MB 未満、動画は mp4 / mov、2〜15 秒、50MB 以下、アスペクト比 0.4〜2.5、音声は mp3 / wav、2〜15 秒、15MB 以下です。
Notes
- 画像 URL の有効期間: query / list エンドポイントが返すプレビュー URL は、約12時間有効な一時アドレスです。長期保存のためにキャッシュしないでください。アセット ID 自体は永続です。
- レート制限(Volcengine アカウントレベル): ステータス照会は 100 QPS、取り込みとその他の操作は約 10 QPS です。失敗時は同時実行数を制御し、再試行してください。
- Web UI の状態同期: API 経由で取り込み後、状態が一度も照会されていない場合、Web アーカイブには「processing」と表示されることがあります。実際の状態を同期するには、アセット一覧ページを開いて「Refresh List」をクリックしてください。
volcengine.com/docs/82379/2333565、実人物アセットのオンボーディング volcengine.com/docs/82379/2315856.
FAQ
アセットライブラリは、参照画像を直接渡す場合と何が違いますか?
アセットライブラリは、参照画像を直接渡す場合と何が違いますか?
asset:// ID は任意の数の生成タスクで再利用でき、エピソードやショットをまたいでキャラクターの顔と服装の一貫性を保てます。アニメドラマ、ショートドラマ、IP キャラクターのような連載型コンテンツに最適です。実在の人物もカメラに登場できます。その場合は、上で説明した実在人物の認証フローを完了してください。アセットライブラリはアカウントに紐づきますか、それとも KEY ですか?アセットの分離はどのように実装されていますか?
アセットライブラリはアカウントに紐づきますか、それとも KEY ですか?アセットの分離はどのように実装されていますか?
asset:// ID が漏れた場合、同じチャネル上の他の呼び出し元が生成リクエストで参照できてしまいます。アセット ID は秘密情報として扱ってください。アセットは APIYI / icover.ai の自社サーバーに保存されますか?
アセットは APIYI / icover.ai の自社サーバーに保存されますか?
asset:// ID だけです。生のアセットコンテンツをこちらで保存・ログ記録することはなく、保持しているのはその ID と、その ID に対応するアカウント所有権(上で説明したアカウント単位の分離に使用)だけです。実写顔アセットには追加の厳格な要件があります。撮影される本人が、ライブ顔認証 を自分自身の Volcengine アカウントにサインインしてその場で完了しなければなりません。これにより、ポートレート権の所有が発生源で確実に固定され、本人以外が代理でこの認証を完了することはできません。完全な流れは上記の「実写顔アセット」をご覧ください。会社内の複数の部門 / チームでアセットライブラリを共有または分離するにはどうすればよいですか?
会社内の複数の部門 / チームでアセットライブラリを共有または分離するにはどうすればよいですか?
asset:// ID を配布してください。動画生成リクエストで参照するには ID を持っているだけで十分です(動画生成では各部門独自の APIYI SeeDance2 token を使い、Asset Library KEY とは無関係です)。同じアカウント配下に複数の KEY を作成して、部門ごとに配布することもできます(認証情報のローテーション / 失効に便利です)。これらの KEY も同じライブラリにアクセスします。部門ごとに分離する: 部門ごとに別々の icover.ai アカウントを登録し、それぞれに独自の KEY を持たせます。分離が適用されるのは一覧表示 / 照会 / 削除までであり、漏れたアセット ID はそれでも参照できるため、部門内であっても ID の安易な共有は避けてください。これはフル機能版の SeeDance 2.0 ですか?
これはフル機能版の SeeDance 2.0 ですか?
doubao-seedance-2-0-260128 を実行しており、モデルパラメータ、解像度、長さは公式版と同一で、機能削減はありません。モデルの詳細と料金は Seedance 2.0 概要 をご覧ください。AI 生成の写実的なポートレートは実在人物として扱われますか?アップロードすると認可したことになりますか?
AI 生成の写実的なポートレートは実在人物として扱われますか?アップロードすると認可したことになりますか?

Virtual-avatar example: an AI-generated photorealistic portrait with no real-world counterpart. Put the frontal face close-up plus full-body front / side / back views into one asset group for the best character consistency
リアルなデジタルヒューマン(バーチャルアバター)には審査が必要ですか?
リアルなデジタルヒューマン(バーチャルアバター)には審査が必要ですか?
asset:// ID はすぐに動画生成に使えます。実写顔 アセットだけが、撮影される本人による生体認証の完了を必要とします(上記の実写顔セクションを参照してください)。他の提供元で既に取り込み / 認証済みのアセットは移行できますか?
他の提供元で既に取り込み / 認証済みのアセットは移行できますか?
asset:// ID はその提供元の Volcengine アカウントに属しており、APIYI チャネル経由で参照すると asset not found が返ります。アセットはこのサービスで再取り込みする必要があります。- バーチャルアバターのアセット: これらはプログラムで一括移行できます。元画像をこのページの API 経由で再アップロードするスクリプトを書き、その後、システム内の旧 ID を新しい
asset://ID に更新してください。自社システム内にアセット ID のマッピング層を持つことをおすすめします。業務データには内部 ID だけを保存すればよいため、将来プロバイダを切り替える際はマッピングを更新するだけで済みます。 - 実在人物認証済みアセット: 実在人物認証もアカウントに紐づいており、移行できません。再認証が必要です。撮影される本人が再度生体認証を完了する必要があります(上記の実写顔セクションを参照してください)。
- 一般向けプロダクトへのアドバイス: 既存アセットが大量にある場合は、バックエンドジョブでバーチャルアセットを静かに移行してください。利用者は気づきません。実在人物認証済みの部分については、システムアップグレードや新バージョン公開のタイミングで再認証を促すと、より自然です。