AIHubMix 실사 인물 에셋으로 Seedance 2.5에서 실제 얼굴 사용하기

AI 영상은 화면 속 인물이 장면이 바뀌어도 알아볼 수 있게 유지될 때 훨씬 더 유용해집니다. AIHubMix 실사 인물 에셋은 승인된 얼굴을 Seedance 영상 생성에 사용하는 동의 기반 방식을 제공하며, 인증, 에셋 처리, 생성을 각각 분리되고 검증 가능한 단계로 유지합니다.

이 가이드에서는 실사 인물 영상이 무엇인지, AIHubMix 워크플로가 어떻게 작동하는지, 왜 유용한지, 그리고 실제 얼굴로 Seedance 2.5 영상을 만드는 방법을 설명합니다. 또한 네이티브 Seedance 2.5 API와 호환되는 Seedance 2.0 연동 방식의 차이도 설명합니다.

실사 인물 영상이란?

실사 인물 영상은 인증된 인물을 신원 참조로 사용하는 AI 생성 영상입니다. 모델은 인물의 알아볼 수 있는 외모를 유지하면서 배경, 의상, 동작, 카메라 움직임, 음성 또는 언어를 바꿀 수 있습니다.

이는 일반적인 텍스트-투-비디오 생성과 다릅니다. 텍스트 프롬프트는 무엇이 일어나야 하는지를 설명하지만, 특정 실제 인물을 안정적으로 식별하지는 못합니다. 실사 인물 에셋은 여러 영상에서 반복해 사용할 수 있는 승인된 시각 참조를 모델에 제공합니다.

대표적인 활용 사례로는 크리에이터 아바타, 가상 발표자, 제품 설명 영상, 현지화 캠페인, 교육 영상, 브랜드 캐릭터, 숏폼 소셜 콘텐츠 등이 있습니다.

AIHubMix 워크플로 작동 방식

워크플로는 다섯 가지 주요 단계로 구성됩니다:

한 인물을 위한 에셋 그룹을 만듭니다.
이미지 속 인물이 인증 절차를 완료하도록 합니다.
인물 사진을 추가하고 에셋이 활성 상태가 될 때까지 기다립니다.
asset:// URI로 활성 에셋을 참조합니다.
Seedance 영상 작업을 제출하고 완료될 때까지 폴링합니다.

이러한 분리는 의도된 것입니다. 인증은 생성 이전에 이루어지고, 에셋 준비 상태는 독립적으로 확인할 수 있으며, 모든 중요한 단계는 애플리케이션이 모니터링할 수 있는 상태를 제공합니다.

AIHubMix를 사용하는 이유는?

전체 워크플로를 위한 하나의 API

AIHubMix는 에셋 그룹, 인증 세션, 인물 에셋, 비동기 영상 생성을 위한 엔드포인트를 제공합니다. 같은 계정과 API 키로 전체 파이프라인을 관리할 수 있습니다.

명시적인 인증

인물 사진 속 인물이 인증 페이지를 완료합니다. 이를 통해 이미지가 재사용 가능한 실사 인물 참조로 쓰이기 전에 명확한 동의 단계가 만들어집니다.

재사용 가능한 신원 에셋

이미지가 활성 상태가 되면, 애플리케이션은 매번 원본 이미지를 업로드하는 대신 에셋 ID를 여러 영상 요청에서 재사용할 수 있습니다.

Seedance에 바로 사용할 수 있는 생성

네이티브 Seedance 2.5 엔드포인트는 텍스트, 이미지, 영상, 오디오 참조를 지원하며, 길이, 해상도, 화면 비율, 오디오 생성에 대한 제어 기능도 제공합니다.

관찰 가능하고 프로덕션에 적합한 상태

애플리케이션은 작업이 끝났는지 추측하는 대신 verified, active, completed 상태를 기다릴 수 있습니다. 이를 통해 재시도와 오류 처리를 더 쉽게 구현할 수 있습니다.

단계별 튜토리얼

1단계: API 키와 인물 사진 준비

AIHubMix 콘솔에서 API 키를 만듭니다. 비공개로 보관하세요. 터미널에서 환경 변수로 설정합니다:

export AIHUBMIX_API_KEY="your_api_key"

직접 접근 가능한 HTTPS 이미지 URL을 준비합니다. 이 URL은 로그인이나 사용자 지정 헤더 없이 이미지 파일을 반환해야 하며, AIHubMix가 처리하는 동안 계속 사용 가능해야 합니다.

권장 이미지 요건:

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC 또는 HEIF
30MB 미만
너비와 높이가 300픽셀보다 크고 6000픽셀보다 작음
종횡비가 0.4보다 크고 2.5보다 작음
인증을 완료하는 본인의 선명한 인물 사진

2단계: 실사 인물 에셋 그룹 만들기

터미널에서 다음 명령을 실행합니다:

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My real-human asset"}'

ag_... 형식의 반환된 id을 저장합니다:

GROUP_ID="ag_your_group_id"

새 그룹은 보통 pending_auth 상태로 시작합니다.

3단계: 인증 세션 만들기

그룹 ID를 사용해 인증 세션을 요청합니다:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

응답에는 임시 verification_url이 포함됩니다. 이 URL을 브라우저에서 열고, 사진 속 인물에게 사용 목적을 검토한 뒤 인증 절차를 완료하도록 요청하세요.

이 URL은 민감하며 임시로만 유효합니다. 공개하거나, 저장소에 커밋하거나, 스크린샷에 포함하지 마세요.

4단계: 인증 및 그룹 상태 확인

인물이 브라우저 절차를 마친 후, 두 리소스를 모두 조회합니다:

curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

인증 세션이 verified 상태이고 에셋 그룹이 active 상태일 때만 진행하세요. 브라우저의 오류 페이지는 최종 결과를 결정하지 않으므로 API 상태를 사용하세요.

5단계: 인물 사진 추가

직접 접근 가능한 이미지 URL을 제출합니다:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portrait-001" \
  -d '{
    "url":"https://cdn.example.com/portrait.jpg",
    "asset_type":"image",
    "client_reference_id":"portrait-001"
  }'

반환된 에셋 ID를 저장하고 폴링합니다:

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

에셋 상태가 active일 때만 사용하세요. creating과 processing은 아직 준비되지 않았음을 의미합니다.

6단계: Seedance 2.5 영상 생성

실사 인물 에셋은 input_references[].url에 넣어야 합니다. 프롬프트 텍스트에 붙여넣지 마세요:

curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"doubao-seedance-2-5-260628\",
    \"prompt\":\"A realistic vertical vlog. The person smiles, waves, and says in Japanese: やっほー！今日も笑顔でね！ Keep the face consistent, synchronize lip movement, use natural hand motion, and add no subtitles.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

응답으로 영상 작업 ID가 반환됩니다. 작업이 completed가 될 때까지 GET /ai/v1/videos/{id}를 폴링한 뒤, 영상 URL은 임시이므로 출력물을 바로 다운로드하세요.

Seedance 2.5와 Seedance 2.0

Seedance 2.5는 위에서 설명한 네이티브 /ai/v1/videos 엔드포인트를 사용합니다. 기존 연동에서는 호환 /v1/videos 프로토콜과 다른 콘텐츠 구조를 사용하는 Seedance 2.0을 쓸 수 있습니다.

두 요청 형식을 섞어 쓰지 마세요. 프로덕션에 적용하기 전에 지원되는 길이, 해상도, 참조 유형, 오디오 동작, 엔드포인트 경로를 실시간 모델 스키마에서 확인하세요.

프롬프트 작성 모범 사례

환경, 동작, 타이밍, 카메라 움직임, 음성, 제약 조건을 설명하세요. 좋은 프롬프트의 예로는 기모노, 떨어지는 벚꽃잎, 부드러운 바람, 일본어 대사, 입 모양 동기화, 자연스러운 머리카락 움직임, 자막 없음을 지정하는 경우가 있습니다.

짧은 인사에는 5초가 적당합니다. 영상에 여러 동작이나 긴 문장이 포함된다면, 연기가 급하게 느껴지지 않도록 더 긴 길이를 쓰거나 대본을 줄이세요.

간단한 테스트에는 하나의 신원 참조만 사용하세요. 모델 스키마가 지원하고 각 에셋이 같은 에셋 그룹에 속할 때만 추가 참조를 넣으세요.

자주 발생하는 문제

그룹이 활성 상태가 아님: 인증 세션이 verified가 되고 그룹이 active가 될 때까지 기다리세요.
에셋이 처리 중임: 원래 에셋 ID를 계속 폴링하세요. 새 ID로 중복 생성하지 마세요.
이미지 URL이 실패함: 로컬 경로, 로그인 페이지, 공유 페이지가 아닌 공개 HTTPS 파일 URL을 사용하세요.
영상에서 에셋이 거부됨: 에셋이 active 상태이고, 같은 계정에 속하며, 올바른 미디어 유형을 사용하는지 확인하세요.
Playground에 asset://가 표시되지 않음: Playground 이미지 업로드와 실사 인물 에셋 등록은 별개의 워크플로입니다. 등록된 에셋에는 API 참조 필드를 사용하세요.

최종 체크리스트

API 키를 안전하게 설정함.
에셋 그룹을 만듦.
인물 인증을 완료함.
그룹 상태가 active임.
인물 사진 에셋 상태가 active임.
영상 요청이 asset://<asset_id>를 사용함.
영상 작업을 completed가 될 때까지 폴링함.

AIHubMix 실사 인물 에셋을 사용하면 개발자는 Seedance로 동의 기반이며 신원이 일관된 영상 경험을 실용적으로 구축할 수 있습니다. 승인된 인물 사진 하나와 짧은 테스트 클립으로 시작한 뒤, 같은 워크플로를 크리에이터 도구, 브랜드 콘텐츠, 프로덕션 애플리케이션으로 확장해 보세요.