Skip to main content

​
간단한 답변

두 가지 질문에 대한 두 가지 답변입니다.
  1. 아니요, 자동 업로드되지 않습니다. Seedance 2.0을 호출할 때 참조 이미지는 자산 라이브러리로 자동 전송되지 않습니다. 별도로 자산 라이브러리 API를 통해 업로드하여 asset:// ID를 받은 다음, 동영상 생성 요청에서 이를 참조해야 합니다.
  2. 예, 딥페이크 필터가 동작합니다. 사실적인 인간 얼굴이 포함된 참조 이미지를 직접 전달하면 업스트림 콘텐츠 안전성에 의해 차단됩니다. 실제 인물 사진을 동영상 생성에 보내면 실패합니다.
캐릭터 유형에 따라 올바른 워크플로를 선택하십시오.
  • 가상 아바타 (AI가 생성한 사실적인 인간, 현실의 대응물이 없음): “Virtual avatar ingest” 경로를 사용 → asset:// ID 획득 → 이를 참조
  • 실제 인간 얼굴 (연예인, 모델, 최종 사용자 사진): 먼저 라이브니스 스캔을 완료 → 인물별 groupId로 인제스트 → 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

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 SeeDance2 group enabled, shared by 2.5 and the 2.0 family): only for the video generation endpoint
Details in Asset library.

​
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 groupId
3

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
Real person ≠ AI-generated realistic human. AI-generated realistic-looking humans that have no real-world counterpart (e.g., generated by Nano Banana) are “virtual avatars” — go through “Virtual avatar ingest” directly, no authorization step. Only photos of real people count as “real human faces” — uploading such a photo is not equivalent to authorization; the subject must complete the liveness scan.

​
자주 묻는 질문

아니요. asset:// asset ID는 영구적입니다 — 한 번 수집하면 영구적으로 참조할 수 있습니다. 그러나, 성공적인 생성 후 반환되는 content.video_url는 24시간 서명된 URL입니다 — 작업이 성공하면 즉시 다운로드하여 다시 호스팅하십시오.
네. 동일한 asset 그룹에 여러 이미지를 업로드할 수 있습니다(측면 사진, 다중 얼굴, 흐린 사진은 실패할 수 있습니다 — 선명한 정면 사진을 권장합니다). asset:// ID는 이미지별이 아니라 asset 그룹 수준입니다 — 같은 그룹의 모든 이미지는 동일한 ID를 공유합니다.
아니요. 가상 아바타 수집, 실제 인물 검증, 그리고 기타 비공개 asset 라이브러리 기능은 추가 연간 비용 없이 Seedance 2.0 API에 포함됩니다.
업스트림 콘텐츠 안전 필터가 이를 차단합니다. 400은 잔액을 차감하지 않지만 요청은 거절됩니다 — 먼저 asset 라이브러리 수집을 완료한 다음 asset:// ID를 참조하십시오.

​
관련 문서