簡単な回答
2つの質問、2つの回答です。- いいえ、自動アップロードはされません。 Seedance 2.0 を呼び出しても、参照画像が資産ライブラリに自動的にプッシュされることはありません。まず資産ライブラリ API を通じて別途アップロードし、
asset://ID を取得してから、動画生成リクエストで参照する必要があります。 - はい、ディープフェイクフィルターが作動します。 リアルな人間の顔が写った参照画像を直接渡すと、上流のコンテンツセーフティによってブロックされます。実在人物の写真を動画生成に使用すると失敗します。
- バーチャルアバター(AI生成のリアルな人物で、現実世界に対応する人物がいない場合): 「バーチャルアバターの取り込み」パスを使用 →
asset://ID を取得 → それを参照 - 実在人物の顔(著名人、モデル、エンドユーザーの写真):まずライブネススキャンを完了 → 人物固有の
groupIdを使用して取り込み →asset://ID を取得 → それを参照 - 過去30日以内に Seedance で出力したもの:再作成の参照として使用できます(プラットフォームで許可されている方法)
詳細説明
顔画像を直接渡せないのはなぜですか?
Seedance 2.0 はリアルな人間の顔を含む参照画像を直接受け付けることができません(ディープフェイクフィルター)。これは上流のコンテンツセーフティ制限であり、APIYI のポリシーではありません。正しいワークフロー
1
アセットタイプを特定する
画像がどのカテゴリに該当するかを確認します:
- アニメ/様式化されたキャラクター:リアルな顔ではないため、インジェスト不要 — 公開 URL または base64 をそのまま渡します
- バーチャルアバター(AI 生成のリアルな人間):「バーチャルアバターのインジェスト」を経由します — 完全自動で、審査はありません
- 実在の人物の顔(有名人、モデル、エンドユーザー):先にライブネススキャンが必要です
2
アセットライブラリにアップロードして asset:// ID を取得する
- Web UI:icover.ai アセットライブラリ でアップロードし、ステータスが「Available」になるまで待ってから
asset://xxxをコピーします - API:完全なコードパスについては
presign+POST /api/asset-library/assetsを使用します — アセット参照のエンドツーエンド を参照してください
3
動画生成リクエストでアセット ID を参照する
Seedance 2.0 リクエストの
content で、asset://<Id> を image_url に入れ、prompt 内で「image 1」を使ってキャラクターを参照します。Seedance 2.0 動画生成 API を参照してください。2 つのキー — 混同しないでください:
- アセットライブラリ KEY(icover.ai で作成):アップロード/インジェスト/一覧/削除のみに使用
- APIYI Seedance 動画 token(api.apiyi.com で作成、
SeeDance2グループを有効化、2.5 と 2.0 ファミリーで共通):動画生成エンドポイント専用
実在人物アセットの特別なフロー
実在人物の写真は「ライブラリにアップロードするだけ」でディープフェイクフィルターを回避することはできません — 本人自身がライブネススキャンを完了する必要があります(自身の Volcano アカウントにログインし、顔認証を通過します)。これは肖像権をソースの段階で保護するものであり、代理は認められません。1
ライブネスリンクを生成する
本人に QR コードをスキャンさせるか、スマートフォンでリンクを開かせ、自身の Volcano アカウント経由でライブネスチェックを完了してもらいます
2
ライブネスの結果を照会する
本人専用の実在人物アセットグループ
groupId を取得します3
groupId を使ってインジェストする
そのグループの
groupId を使ってアセットをアップロードします。顔の一貫性チェックに合格すると、asset:// ID を受け取ります。同じ本人は異なる見た目でも同じグループを再利用できるため、再認証は不要ですFAQ
アセット ID の有効期限はありますか?
アセット ID の有効期限はありますか?
いいえ。
asset:// アセット ID は永続的です。一度取り込めば、いつでも参照できます。ただし、生成成功後に返される content.video_url は24時間有効な署名付き URL です。タスクが成功したら、すぐにダウンロードして再ホストしてください。1つの画像で顔の一貫性チェックに失敗した場合、別の画像に差し替えられますか?
1つの画像で顔の一貫性チェックに失敗した場合、別の画像に差し替えられますか?
はい。同じアセットグループに複数の画像をアップロードできます(横顔、複数の顔、ぼやけた画像は失敗する場合があります。鮮明な正面画像を推奨します)。
asset:// ID は画像ごとではなくアセットグループ単位です。同じグループ内のすべての画像で同じ ID が共有されます。アセットライブラリには別途課金されますか?
アセットライブラリには別途課金されますか?
いいえ。バーチャルアバターの取り込み、実在人物の認証、その他のプライベートアセットライブラリ機能は、追加の年間料金なしで Seedance 2.0 API に含まれています。
顔画像を直接渡すと 400 が返されるのはなぜですか?
顔画像を直接渡すと 400 が返されるのはなぜですか?
上流のコンテンツセーフティフィルターによってブロックされています。400 では残高は課金されませんが、リクエストは拒否されます。まずアセットライブラリへの取り込みを完了してから、
asset:// ID を参照してください。