アセットライブラリを利用する理由
キャラクターの一貫性を保った動画を生成する場合、Seedance 2.0 は人間の顔を含む参照画像を直接受け付けません(ディープフェイク対策フィルタリング)。まず画像を信頼済みアセットとして取り込み、asset://xxx アセット 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: アセットライブラリ キーを作成する
icover.ai にログインしたら、設定 → アセットライブラリ キー(icover.ai/en/settings/apikeys)に移動し、sk-... 形式のキーを作成してください。

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"}してグループIDを取得し、次にここに"groupId":"group-xxx"を含めます。labelは任意です。ウェブUIでアセットを識別しやすくなります。
ステップ 3: アクティブになるまでポーリングする
Ingest は非同期です(画像1枚あたり約13秒、SLA なし)。返された ID を使ってポーリングしてください:Active なしで90秒経過した場合は、調査が必要なタイムアウトとして扱ってください。
ステップ 4:アセット ID を使用して動画を生成する(APIYI 経由)
アセット ID をasset://<Id> として記述し、ご自身の APIYI Seedance 動画 token(アセットライブラリのキーではありません)を使用して APIYI を呼び出します。
エンドポイント全一覧
- 単一項目エンドポイント(グループ作成 / 取り込み / ステータス取得 / 削除)は、成功・失敗のいずれでも 生の Volcengine JSON をそのまま返します。
- リスト系エンドポイント(
GETongroups/assets)はマージされ、ご自身のアセットにフィルタリングされるため、上流の出力と1バイト単位で一致するものではありません。元の Volcengine フィールドはすべて保持され、さらに_をプレフィックスに持つ独自のメタデータフィールドがいくつか追加されます(例:_library)。解析時は未知の_プレフィックス付きフィールドを無視してください — それらが増えても破壊的変更ではありません。 - 当方独自のエラーは
[client]を先頭に付けたプレーンテキストです(400/401/403/404/502)。 records、real-person/sessionsの GET/PATCH/DELETE、およびアセットPATCHは{code, message, data}JSON を返します(code 0 = 成功)。
実在人物アセット(完全自動 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を参照できます。アセットIDは秘密情報として扱ってください。アセットはAPIYI / icover.aiの独自サーバーに保存されますか?
アセットはAPIYI / icover.aiの独自サーバーに保存されますか?
- 公開URLを指定する場合(独自のCDN / 画像ホスト):元のファイルが当社を経由することはありません。そのURLをVolcengineに転送するだけです。
/api/storage/presign経由でアップロードする場合:公開URLを取得するため、ファイルはまず当社のオブジェクトストレージ(cdn.icover.ai)に保存され、その後Volcengineに転送されます。元のファイルは当社のストレージに残ります。
asset:// IDが返されます。当社独自のデータベースに保存するのは、そのIDとアカウント所有情報だけです(上記で説明したアカウント単位の分離に使用します)。アセットのコンテンツ自体は記録しません。実在人物の顔を含むアセットには、追加の必須要件があります。撮影対象の人物本人が、対面でライブネス認証を完了する必要があります(自身のVolcengineアカウントにログインして顔認証を実行します)。これにより、肖像権の所有者を元の認証時点で確実に確認できます。この認証を本人に代わって完了することは、他の人にはできません。完全なフローについては、上記の「実在人物の顔を含むアセット」を参照してください。会社内の複数の部署 / チームで、アセットライブラリを共有または分離するにはどうすればよいですか?
会社内の複数の部署 / チームで、アセットライブラリを共有または分離するにはどうすればよいですか?
asset:// IDを配布してください。動画生成リクエストで参照するにはIDを持っているだけで十分です(動画生成では各部署自身のAPIYI Seedance動画tokenを使用し、アセットライブラリKEYとは関係ありません)。同じアカウント配下に複数のKEYを作成し、それぞれを異なる部署に渡すこともできます(認証情報のローテーション / 失効に便利です)。ただし、これらのKEYは引き続き同じライブラリにアクセスします。部署間で分離する:部署ごとに別のicover.aiアカウントを登録し、それぞれのアカウントで独自のKEYを作成してください。分離の対象は一覧表示・照会・削除である点に注意してください。アセットIDが漏洩すると参照できるため、部署間であってもIDを不用意に共有しないでください。これは完全な機能を備えたSeeDance 2.0ですか?
これは完全な機能を備えたSeeDance 2.0ですか?
doubao-seedance-2-5-260628とdoubao-seedance-2-0-260128を提供しています。モデルパラメータ、解像度、再生時間は公式サービスと同一で、機能を削減していません。モデルの詳細と料金については、Seedance 2.0 / 2.5の概要を参照してください。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だけを保存するため、後でプロバイダーを切り替える場合もマッピングを更新するだけで済みます。 - 実在人物認証済みのアセット:実在人物認証もアカウントに紐づいており、移行できません。再認証が必要です。撮影対象の本人が再度ライブネス認証を完了する必要があります(上記の実在人物の顔に関するセクションを参照してください)。
- 消費者向けプロダクトへのアドバイス:既存アセットを大量に保有している場合は、バックエンドジョブでバーチャルアセットをユーザーに気づかれない形で移行してください。ユーザーには通知されません。実在人物認証済みのアセットについては、システムのアップグレードや新バージョンのリリース時に再認証を促すと、より自然に受け入れられます。