> ## 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를 얻어야 합니다. 이 페이지에서는 올바른 작업 흐름과 딥페이크 필터 우회 방법을 설명합니다.

## 간단한 답변

두 가지 질문에 대한 두 가지 답변입니다.

1. **아니요, 자동 업로드되지 않습니다.** Seedance 2.0을 호출할 때 참조 이미지는 자산 라이브러리로 자동 전송되지 않습니다. 별도로 자산 라이브러리 API를 통해 업로드하여 `asset://` ID를 받은 다음, 동영상 생성 요청에서 이를 참조해야 합니다.
2. **예, 딥페이크 필터가 동작합니다.** 사실적인 인간 얼굴이 포함된 참조 이미지를 직접 전달하면 업스트림 콘텐츠 안전성에 의해 차단됩니다. 실제 인물 사진을 동영상 생성에 보내면 실패합니다.

캐릭터 유형에 따라 올바른 워크플로를 선택하십시오.

* **가상 아바타** (AI가 생성한 사실적인 인간, 현실의 대응물이 없음): “Virtual avatar ingest” 경로를 사용 → `asset://` ID 획득 → 이를 참조
* **실제 인간 얼굴** (연예인, 모델, 최종 사용자 사진): 먼저 라이브니스 스캔을 완료 → 인물별 `groupId`로 인제스트 → `asset://` ID 획득 → 이를 참조
* **지난 30일 내 Seedance 출력물**: 재생성을 위한 참조로 사용할 수 있습니다(플랫폼에서 허용하는 경로)

## 상세 설명

### 얼굴 이미지를 직접 전달할 수 없는 이유는 무엇입니까?

Seedance 2.0은 **실제 사람 얼굴이 포함된 참조 이미지를 직접 받을 수 없습니다**(딥페이크 필터). 이는 상위단 콘텐츠 안전 제한이며, apiyi 정책이 아닙니다.

### 올바른 작업 흐름

<Steps>
  <Step title="에셋 유형을 결정하십시오">
    이미지가 어떤 범주에 해당하는지 식별하십시오:

    * **애니메이션 / 스타일화된 캐릭터**: 현실적인 얼굴이 없으며, **인제스트가 필요 없습니다** — 공용 URL 또는 base64를 직접 전달하십시오
    * **가상 아바타** (AI가 생성한 현실적인 인간): "가상 아바타 인제스트"를 거치십시오 — 완전 자동이며 검토가 없습니다
    * **실제 사람 얼굴** (연예인, 모델, 최종 사용자): 먼저 라이브니스 스캔이 필요합니다
  </Step>

  <Step title="asset:// ID를 받으려면 에셋 라이브러리에 업로드하십시오">
    * Web UI: [icover.ai 에셋 라이브러리](https://icover.ai/zh/seedance-official/asset-library)에 업로드하고, 상태가 “사용 가능”이 될 때까지 기다린 다음 `asset://xxx`를 복사하십시오
    * API: 전체 코드 경로를 위해 `presign` + `POST /api/asset-library/assets`를 사용하십시오 — [에셋 참조 엔드투엔드](/ko/api-capabilities/seedance2/asset-reference)를 참조하십시오
  </Step>

  <Step title="동영상 생성 요청에서 에셋 ID를 참조하십시오">
    Seedance 2.0 요청의 `content`에 `asset://<Id>`를 `image_url`에 넣고, prompt에서 “이미지 1”을 사용하여 캐릭터를 참조하십시오. [Seedance 2.0 동영상 생성 API](/ko/api-capabilities/seedance2/video-generation)를 참조하십시오.
  </Step>
</Steps>

<Info>
  **두 개의 키 — 혼동하지 마십시오**:

  * **에셋 라이브러리 키** (icover.ai에서 생성됨): 업로드 / 인제스트 / 목록 조회 / 삭제에만 사용됩니다
  * **APIYI SeeDance2 token** (api.apiyi.com에서 생성되며, `SeeDance2` 그룹이 활성화되어 있어야 합니다): 동영상 생성 엔드포인트에만 사용됩니다

  자세한 내용은 [에셋 라이브러리](/ko/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="asset ID는 만료됩니까?">
    아니요. `asset://` asset ID는 영구적입니다 — 한 번 수집하면 영구적으로 참조할 수 있습니다. 그러나, 성공적인 생성 후 반환되는 `content.video_url`는 24시간 서명된 URL입니다 — **작업이 성공하면 즉시 다운로드하여 다시 호스팅하십시오**.
  </Accordion>

  <Accordion title="얼굴 일관성 검사가 한 이미지에서 실패하면 다른 이미지로 바꿀 수 있습니까?">
    네. 동일한 asset 그룹에 여러 이미지를 업로드할 수 있습니다(측면 사진, 다중 얼굴, 흐린 사진은 실패할 수 있습니다 — 선명한 정면 사진을 권장합니다). `asset://` ID는 이미지별이 아니라 asset 그룹 수준입니다 — 같은 그룹의 모든 이미지는 동일한 ID를 공유합니다.
  </Accordion>

  <Accordion title="asset 라이브러리는 별도로 과금됩니까?">
    아니요. 가상 아바타 수집, 실제 인물 검증, 그리고 기타 비공개 asset 라이브러리 기능은 추가 연간 비용 없이 Seedance 2.0 API에 포함됩니다.
  </Accordion>

  <Accordion title="얼굴 이미지를 직접 전달하면 왜 400이 반환됩니까?">
    업스트림 콘텐츠 안전 필터가 이를 차단합니다. 400은 잔액을 차감하지 않지만 요청은 거절됩니다 — 먼저 asset 라이브러리 수집을 완료한 다음 `asset://` ID를 참조하십시오.
  </Accordion>
</AccordionGroup>

## 관련 문서

* [Seedance 2.0 동영상 생성 API](/ko/api-capabilities/seedance2/video-generation)
* [Seedance 2.0 자산 라이브러리](/ko/api-capabilities/seedance2/asset-library)
* [자산 참조 엔드투엔드(전체 코드 포함)](/ko/api-capabilities/seedance2/asset-reference)
* [Seedance 2.0 개요](/ko/api-capabilities/seedance2/overview)