簡潔な答え
2つの質問、2つの答えです。- いいえ、自動アップロードはされません。 参照画像は、Seedance 2.0 を呼び出したときに自動でアセットライブラリへ送信されることはありません。まずアセットライブラリ API で別途アップロードして
asset://ID を取得し、その後で動画生成リクエスト内で参照してください。 - はい、ディープフェイクフィルターは作動します。 リアルな人間の顔を含む参照画像をそのまま渡すと、上流のコンテンツ安全性によってブロックされます。実在人物の写真を動画生成に送ると失敗します。
- バーチャルアバター(AI生成のリアルな人間で、現実世界に対応する人物がいないもの):“Virtual avatar ingest” の経路を使う →
asset://ID を取得 → それを参照する - 実在の人物の顔(有名人、モデル、エンドユーザーの写真):まずライブネススキャンを完了する → その人物専用の
groupIdで ingest する →asset://ID を取得 → それを参照する - 過去30日以内の Seedance の出力:再作成用の参照として使用できます(プラットフォームで許可された経路)
詳細な説明
なぜ顔画像を直接渡せないのですか?
Seedance 2.0 は、実在の人間の顔を含む参照画像を直接受け付けません(ディープフェイクフィルター)。これは上流側のコンテンツ安全性制限であり、APIYI のポリシーではありません。正しいワークフロー
1
アセット種別を判定する
画像がどのカテゴリに該当するかを確認します。
- アニメ / スタイライズドキャラクター: 実在感のある顔ではなく、インジェスト不要 — public 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 に入れ、プロンプトでは “image 1” を使ってキャラクターを指します。Seedance 2.0 動画生成 API を参照してください。2 つのキー — 混同しないでください:
- アセットライブラリの KEY(icover.ai で作成): アップロード / インジェスト / 一覧表示 / 削除にのみ使用します
- APIYI SeeDance2 token(api.apiyi.com で作成、
SeeDance2グループが有効である必要があります): 動画生成エンドポイントにのみ使用します
実在人物アセットの特殊フロー
実在人物の写真は、「ライブラリにアップロードするだけ」ではディープフェイクフィルターを回避できません。被写体本人 がライブネススキャンを完了する必要があります(Volcano アカウントにログインし、顔認証を通過します)。これにより、肖像権は発生源で厳格に保護され、代理は認められません。1
ライブネスリンクを生成します
対象者に QR コードをスキャン / スマートフォンでリンクを開いてもらい、Volcano アカウント経由でライブネスチェックを完了してもらいます
2
ライブネス結果を照会します
対象者専用の実在人物アセットグループ
groupId を取得します3
groupId でインジェストします
そのグループの
groupId を使ってアセットをアップロードします。顔の整合性チェックに合格すると、asset:// ID が付与されます。同じ対象者は、見た目が異なっても同じグループを再利用できます — 再検証は不要ですよくある質問
アセット ID は期限切れになりますか?
アセット ID は期限切れになりますか?
いいえ。
asset:// アセット ID は永続的です — 1回取り込めば、永続的に参照できます。ただし、正常な生成後に返されるcontent.video_urlは 24 時間有効の署名付き URL です — タスク成功後すぐにダウンロードして再ホストしてください。1 枚の画像で顔の一貫性チェックに失敗した場合、別の画像に差し替えられますか?
1 枚の画像で顔の一貫性チェックに失敗した場合、別の画像に差し替えられますか?
はい。同じアセット グループに複数の画像をアップロードできます(横顔、複数人の顔、ぼやけた画像は失敗する場合があります — 正面の鮮明な画像を推奨します)。
asset:// ID は画像ごとではなくアセット グループ単位です — 同じグループ内のすべての画像は同じ ID を共有します。アセット ライブラリは別料金ですか?
アセット ライブラリは別料金ですか?
いいえ。バーチャル アバターの取り込み、実在人物の確認、その他のプライベート アセット ライブラリ機能は、Seedance 2.0 API に年間追加料金なしで含まれています。
顔画像を直接渡すと 400 が返るのはなぜですか?
顔画像を直接渡すと 400 が返るのはなぜですか?
上流のコンテンツ安全フィルターがブロックします。400 では残高は差し引かれませんが、リクエストは拒否されます — まずアセット ライブラリの取り込みを完了し、その後
asset:// ID を参照してください。