簡潔な答え
2つの質問、2つの答えです。- いいえ、自動アップロードはされません。 参照画像は、Seedance 2.0 を呼び出したときに自動でアセットライブラリへ送信されることはありません。まずアセットライブラリ API で別途アップロードして
asset://ID を取得し、その後で動画生成リクエスト内で参照してください。 - はい、ディープフェイクフィルターは作動します。 リアルな人間の顔を含む参照画像をそのまま渡すと、上流のコンテンツ安全性によってブロックされます。実在人物の写真を動画生成に送ると失敗します。
- バーチャルアバター(AI生成のリアルな人間で、現実世界に対応する人物がいないもの):“Virtual avatar ingest” の経路を使う →
asset://ID を取得 → それを参照する - 実在の人物の顔(有名人、モデル、エンドユーザーの写真):まずライブネススキャンを完了する → その人物専用の
groupIdで ingest する →asset://ID を取得 → それを参照する - 過去30日以内の Seedance の出力:再作成用の参照として使用できます(プラットフォームで許可された経路)
Detailed explanation
Why can’t I pass face images directly?
Seedance 2.0 cannot accept reference images with realistic human faces directly (deepfake filter). This is an upstream content-safety restriction, not an apiyi policy.The correct workflow
1
Determine the asset type
Identify which category your image falls into:
- Anime / stylized characters: no realistic face, no ingest required — pass a public URL or base64 directly
- Virtual avatars (AI-generated realistic humans): go through “Virtual avatar ingest” — fully automatic, no review
- Real human faces (celebrity, model, end-user): liveness scan is required first
2
Upload to the asset library to get an asset:// ID
- Web UI: upload at the icover.ai asset library, wait for status to become “Available”, copy the
asset://xxx - API: use
presign+POST /api/asset-library/assetsfor the full code path — see Asset reference end-to-end
3
Reference the asset ID in the video generation request
In the Seedance 2.0 request’s
content, put asset://<Id> into image_url, and use “image 1” in the prompt to refer to the character. See Seedance 2.0 Video Generation API.Two keys — don’t mix them up:
- Asset library KEY (created at icover.ai): only for upload / ingest / list / delete
- APIYI Seedance video token (created at api.apiyi.com, with the
SeeDance2group enabled, shared by 2.5 and the 2.0 family): only for the video generation endpoint
Real-person asset special flow
Real-person photos cannot bypass the deepfake filter by “just uploading to the library” — the subject themselves must complete a liveness scan (log into their Volcano account and pass facial recognition). This locks down portrait rights at the source; no proxy is allowed.1
Generate the liveness link
Have the subject scan the QR code / open the link on their phone and complete the liveness check via their Volcano account
2
Query the liveness result
Get the subject-specific real-person asset group
groupId3
Ingest with the groupId
Upload the asset with that group’s
groupId. After the face-consistency check passes, you’ll receive the asset:// ID. The same subject reuses the same group for different looks — no re-verification neededよくある質問
アセット ID は期限切れになりますか?
アセット ID は期限切れになりますか?
いいえ。
asset:// アセット ID は永続的です — 1回取り込めば、永続的に参照できます。ただし、正常な生成後に返されるcontent.video_urlは 24 時間有効の署名付き URL です — タスク成功後すぐにダウンロードして再ホストしてください。1 枚の画像で顔の一貫性チェックに失敗した場合、別の画像に差し替えられますか?
1 枚の画像で顔の一貫性チェックに失敗した場合、別の画像に差し替えられますか?
はい。同じアセット グループに複数の画像をアップロードできます(横顔、複数人の顔、ぼやけた画像は失敗する場合があります — 正面の鮮明な画像を推奨します)。
asset:// ID は画像ごとではなくアセット グループ単位です — 同じグループ内のすべての画像は同じ ID を共有します。アセット ライブラリは別料金ですか?
アセット ライブラリは別料金ですか?
いいえ。バーチャル アバターの取り込み、実在人物の確認、その他のプライベート アセット ライブラリ機能は、Seedance 2.0 API に年間追加料金なしで含まれています。
顔画像を直接渡すと 400 が返るのはなぜですか?
顔画像を直接渡すと 400 が返るのはなぜですか?
上流のコンテンツ安全フィルターがブロックします。400 では残高は差し引かれませんが、リクエストは拒否されます — まずアセット ライブラリの取り込みを完了し、その後
asset:// ID を参照してください。