> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.0 は顔の参照画像をアセットライブラリに自動アップロードしますか？ ディープフェイクフィルターは発動しますか？

> Seedance 2.0 では、リアルな人間の顔を含む参照画像を直接受け付けることはできません。まずアセットライブラリにアップロードして、asset:// ID を取得する必要があります。このページでは、正しいワークフローとディープフェイクフィルターの回避方法を説明します。

## 簡潔な答え

2つの質問、2つの答えです。

1. **いいえ、自動アップロードはされません。** 参照画像は、Seedance 2.0 を呼び出したときに自動でアセットライブラリへ送信されることはありません。まずアセットライブラリ API で別途アップロードして `asset://` ID を取得し、その後で動画生成リクエスト内で参照してください。
2. **はい、ディープフェイクフィルターは作動します。** リアルな人間の顔を含む参照画像をそのまま渡すと、上流のコンテンツ安全性によってブロックされます。実在人物の写真を動画生成に送ると失敗します。

キャラクターの種類に応じて、正しいワークフローを選んでください。

* **バーチャルアバター**（AI生成のリアルな人間で、現実世界に対応する人物がいないもの）："Virtual avatar ingest" の経路を使う → `asset://` ID を取得 → それを参照する
* **実在の人物の顔**（有名人、モデル、エンドユーザーの写真）：まずライブネススキャンを完了する → その人物専用の `groupId` で ingest する → `asset://` ID を取得 → それを参照する
* **過去30日以内の Seedance の出力**：再作成用の参照として使用できます（プラットフォームで許可された経路）

## 詳細な説明

### なぜ顔画像を直接渡せないのですか？

Seedance 2.0 は、**実在の人間の顔を含む参照画像を直接受け付けません**（ディープフェイクフィルター）。これは上流側のコンテンツ安全性制限であり、APIYI のポリシーではありません。

### 正しいワークフロー

<Steps>
  <Step title="アセット種別を判定する">
    画像がどのカテゴリに該当するかを確認します。

    * **アニメ / スタイライズドキャラクター**: 実在感のある顔ではなく、**インジェスト不要** — public URL または base64 を直接渡します
    * **バーチャルアバター**（AI 生成のリアルな人物）: 「バーチャルアバターのインジェスト」を実施します — 完全自動で、レビューはありません
    * **実在人物の顔**（有名人、モデル、エンドユーザー）: まずライブネススキャンが必要です
  </Step>

  <Step title="アセットライブラリにアップロードして asset:// ID を取得します">
    * Web UI: [icover.ai アセットライブラリ](https://icover.ai/zh/seedance-official/asset-library) でアップロードし、ステータスが "Available" になるまで待ってから、`asset://xxx` をコピーします
    * API: 完全なコードパスには `presign` + `POST /api/asset-library/assets` を使用します — [アセット参照のエンドツーエンド](/ja/api-capabilities/seedance2/asset-reference) を参照してください
  </Step>

  <Step title="動画生成リクエストでアセット ID を参照します">
    Seedance 2.0 リクエストの `content` で、`asset://<Id>` を `image_url` に入れ、プロンプトでは "image 1" を使ってキャラクターを指します。[Seedance 2.0 動画生成 API](/ja/api-capabilities/seedance2/video-generation) を参照してください。
  </Step>
</Steps>

<Info>
  **2 つのキー — 混同しないでください**:

  * **アセットライブラリの KEY**（icover.ai で作成）: アップロード / インジェスト / 一覧表示 / 削除にのみ使用します
  * **APIYI SeeDance2 token**（api.apiyi.com で作成、`SeeDance2` グループが有効である必要があります）: 動画生成エンドポイントにのみ使用します

  詳細は [アセットライブラリ](/ja/api-capabilities/seedance2/asset-library) を参照してください。
</Info>

### 実在人物アセットの特殊フロー

実在人物の写真は、「ライブラリにアップロードするだけ」ではディープフェイクフィルターを回避できません。**被写体本人** がライブネススキャンを完了する必要があります（Volcano アカウントにログインし、顔認証を通過します）。これにより、肖像権は発生源で厳格に保護され、代理は認められません。

<Steps>
  <Step title="ライブネスリンクを生成します">
    対象者に QR コードをスキャン / スマートフォンでリンクを開いてもらい、Volcano アカウント経由でライブネスチェックを完了してもらいます
  </Step>

  <Step title="ライブネス結果を照会します">
    対象者専用の実在人物アセットグループ `groupId` を取得します
  </Step>

  <Step title="groupId でインジェストします">
    そのグループの `groupId` を使ってアセットをアップロードします。顔の整合性チェックに合格すると、`asset://` ID が付与されます。同じ対象者は、見た目が異なっても同じグループを再利用できます — 再検証は不要です
  </Step>
</Steps>

<Warning>
  **実在人物 ≠ AI 生成のリアルな人物。** 現実世界に対応する人物が存在しない AI 生成のリアルな人物（例: Nano Banana で生成されたもの）は「バーチャルアバター」です — 直接「バーチャルアバターのインジェスト」に進んでください。認可ステップはありません。**実在人物** の写真だけが「実在人物の顔」に該当します。このような写真をアップロードしても認可したことにはならず、対象者がライブネススキャンを完了する必要があります。
</Warning>

## よくある質問

<AccordionGroup>
  <Accordion title="アセット ID は期限切れになりますか？">
    いいえ。`asset://` アセット ID は永続的です — 1回取り込めば、永続的に参照できます。ただし、正常な生成後に返される`content.video_url`は 24 時間有効の署名付き URL です — **タスク成功後すぐにダウンロードして再ホストしてください**。
  </Accordion>

  <Accordion title="1 枚の画像で顔の一貫性チェックに失敗した場合、別の画像に差し替えられますか？">
    はい。同じアセット グループに複数の画像をアップロードできます（横顔、複数人の顔、ぼやけた画像は失敗する場合があります — 正面の鮮明な画像を推奨します）。`asset://` ID は画像ごとではなくアセット グループ単位です — 同じグループ内のすべての画像は同じ ID を共有します。
  </Accordion>

  <Accordion title="アセット ライブラリは別料金ですか？">
    いいえ。バーチャル アバターの取り込み、実在人物の確認、その他のプライベート アセット ライブラリ機能は、Seedance 2.0 API に年間追加料金なしで含まれています。
  </Accordion>

  <Accordion title="顔画像を直接渡すと 400 が返るのはなぜですか？">
    上流のコンテンツ安全フィルターがブロックします。400 では残高は差し引かれませんが、リクエストは拒否されます — まずアセット ライブラリの取り込みを完了し、その後`asset://` ID を参照してください。
  </Accordion>
</AccordionGroup>

## 関連ドキュメント

* [Seedance 2.0 Video Generation API](/ja/api-capabilities/seedance2/video-generation)
* [Seedance 2.0 アセットライブラリ](/ja/api-capabilities/seedance2/asset-library)
* [アセット参照のエンドツーエンド（完全なコード付き）](/ja/api-capabilities/seedance2/asset-reference)
* [Seedance 2.0 概要](/ja/api-capabilities/seedance2/overview)