시댄스 private asset이란 무엇인가요?

시댄스 private asset은 시댄스 영상 생성을 위해 PiAPI에 업로드하는 재사용 가능한 참조입니다. Active가 되면 이후 작업에서 asset:// 로 참조할 수 있습니다.

얼굴 사진을 업로드해 시댄스에서 재사용할 수 있나요?

네. 얼굴 또는 인물 사진을 private asset으로 업로드하고 시댄스 영상 생성에서 참조할 수 있습니다. 단, 보장된 face swap이 아니라 reference-guided generation입니다.

Seedance Private Asset Library는 face swap과 같나요?

아니요. 업로드한 assets를 재사용 생성 참조로 사용해 생성 영상에서 캐릭터나 주체 일관성을 유지하기 위한 기능입니다.

인물 private asset과 풍경 이미지를 함께 사용할 수 있나요?

네. 보통 person asset을 image_urls 첫 번째에, scenic image URL을 두 번째에 넣고 prompt에서 Image 1과 Image 2를 설명합니다.

어떤 시댄스 API task type이 private assets를 지원하나요?

private assets는 seedance-2-less-restriction 및 seedance-2-fast-less-restriction에서 작동합니다. seedance-2와 seedance-2-fast는 asset://를 지원하지 않습니다.

private assets와 auto-upload mode의 차이는 무엇인가요?

private assets는 한 번 업로드해 재사용하는 managed references입니다. auto-upload는 auto_upload_assets: true일 때 일회성 raw URL을 임시로 ingest합니다.

Playground에서 private assets를 테스트할 수 있나요?

private assets는 주로 API 및 backend workflow입니다. Playground가 asset upload, status, asset://, less-restriction task type을 제공하지 않으면 cURL, Postman, backend code로 테스트하세요.

시댄스 API로 Private Assets 사용하는 방법

PiAPI는 이제 시댄스(Seedance) API에서 재사용 가능한 참조를 업로드하고 이후 asset://<asset_id>로 호출할 수 있는 워크플로우인 Seedance Private Asset Library를 지원합니다. 이 기능은 같은 인물, 캐릭터, 제품을 여러 AI 영상 제작 작업에서 반복 사용해야 하는 개발자와 콘텐츠 팀에 적합합니다.

Seedance Private Asset Library는 얼굴, 캐릭터, 제품, 장면, 비디오, 오디오 참조를 업로드해 시댄스 API 작업에서 반복 사용할 수 있게 해줍니다. 바이트댄스 AI 영상 모델을 활용하는 영상 AI 워크플로우에서 재사용 참조와 캐릭터 일관성에 적합하며, 전통적인 face swap, inpainting, 픽셀 단위 이미지 편집 도구가 아닙니다.

핵심 요약

같은 얼굴, 캐릭터, 제품, 주체가 여러 시댄스 AI 영상에 등장해야 할 때 private assets를 사용합니다.
한 번만 쓰는 배경, 소품, 장면 참조는 raw URL을 사용합니다.
일회성 사용자 참조를 임시로 처리하려면 auto_upload_assets: true를 사용합니다.
private asset은 Seedance 작업에서 참조하기 전에 Active 상태가 되어야 합니다.
asset://는 seedance-2-less-restriction 및 seedance-2-fast-less-restriction에서 동작하며 strict task type에서는 동작하지 않습니다.

빠른 답변

시댄스 private assets는 Seedance API에서 재사용할 참조에 가장 적합합니다. 참조를 한 번 업로드하고 Active가 될 때까지 기다린 뒤 이후 비디오 작업에서 asset://<asset_id>로 호출합니다. 시댄스 2.0 사용법이나 가격 흐름이 먼저 필요하다면 시댄스 2.0 사용법·가격·API 가이드를 참고하세요.

시댄스 Private Assets란?

애플리케이션이 영상 생성 전에 PiAPI에 업로드하는 재사용 가능한 파일입니다. 업로드 후 PiAPI는 asset_id를 반환합니다. asset이 Active가 되면 시댄스 API 요청에서 asset://<asset_id> 형식으로 사용할 수 있습니다. endpoint, quota, lifecycle은 Private Asset Library docs를 참고하세요.

어떤 문제를 해결하나요?

AI 영상 생성은 같은 주체를 여러 prompt, 장면, 변형에서 일관되게 유지해야 할 때 어려워집니다. 특히 광고, 숏폼, 드리미나 스타일의 반복 제작처럼 같은 인물이나 제품이 계속 등장하는 영상 AI 작업에서는 raw image URL만으로 관리하기가 번거롭습니다.

대표 사례는 같은 인물이나 캐릭터 유지, avatar 또는 influencer 영상 제품 구축, 광고 변형에서 제품 참조 재사용, 짧은 스토리의 안정적인 캐스트 유지, backend 반복 업로드 감소입니다. 모델 개요는 시댄스 2.0 API 가이드를 먼저 확인하세요.

Private Assets가 아닌 것

Seedance Private Asset Library는 face swap, inpainting, 정확한 사진 합성이 아닙니다. 시댄스는 업로드한 입력을 생성 참조로 사용합니다. 결과는 참조 기반 생성 영상이지, 기존 이미지에 사람을 픽셀 단위로 삽입하는 것이 아닙니다.

Private Assets vs Raw URL vs Auto-Upload

패턴	적합한 용도	예시	사용 시점
Managed private asset	반복 사용 인물, 캐릭터, 제품, 주체	`asset://asset-123`	같은 참조가 여러 작업에 쓰일 때.
Raw URL	일회성 배경, 장면, 소품	`https://your-cdn.com/scene.jpg`	현재 작업에만 필요한 경우.
Auto-uploaded ephemeral asset	임시 사용자 참조	URL + `auto_upload_assets: true`	PiAPI가 임시로 ingest해야 할 때.

규칙은 간단합니다. 다시 쓸 참조는 private asset으로 만들고, 한 번만 쓰는 것은 raw URL 또는 auto-upload를 사용합니다.

Workflow

재사용 참조를 업로드합니다.
상태가 Active가 될 때까지 기다립니다.
image_urls, video_urls, audio_urls에 asset://<asset_id>를 넣어 시댄스 작업을 제출합니다.
prompt에서 입력 순서에 맞춰 Image 1, Image 2, Video 1, Audio 1로 참조합니다.
영상이 완료될 때까지 작업을 poll합니다.

{
  "image_urls": ["asset://asset-person-reference", "https://your-cdn.com/scenic-background.jpg"],
  "prompt": "Image 1 is the person reference. Image 2 is the scenic background. Generate a cinematic 5-second video."
}

API 예시

https://api.piapi.ai/api/v1/asset/upload로 참조를 업로드하고 asset list endpoint로 상태를 확인합니다. Active가 되면 seedance-2-less-restriction 또는 seedance-2-fast-less-restriction 작업에서 asset://<asset_id>를 사용합니다. seedance-2, seedance-2-fast 같은 strict variant는 private asset references를 지원하지 않습니다.

Best Practices

반복 사용되는 얼굴, 주인공, 제품, 브랜드 주체에 private assets를 사용합니다.
일회성 배경은 raw URL로 둡니다.
prompt에 Image 1, Image 2 같은 명확한 label을 사용합니다.
생성 전 Active를 기다립니다.
quota, TTL, 사용자 참조 사용 권한을 계획합니다.

FAQ

시댄스 private asset이란?

시댄스 영상 생성을 위해 PiAPI에 업로드하는 재사용 참조입니다. Active가 되면 asset://<asset_id>로 사용할 수 있습니다.

얼굴 사진을 재사용할 수 있나요?

네. 다만 정확한 face swap이 아니라 reference-guided generation으로 이해해야 합니다.

결론

Seedance Private Asset Library는 시댄스 API로 재사용 참조 워크플로우를 더 깔끔하게 구축하게 해줍니다. 참조를 업로드하고 Active를 확인한 뒤 asset, prompt, 일회성 raw URL을 포함한 less-restriction 작업을 제출하세요. 바이트 댄스 기반 시댄스 AI를 API로 테스트하려면 Seedance workspace에서 시작할 수 있습니다.