AIHubMix 실제 인간 자산을 사용하여 Seedance 2.5에서 실제 얼굴을 사용하는 방법

AI 비디오는 화면의 인물이 장면마다 인식 가능할 때 훨씬 더 유용해집니다. AIHubMix의 실제 인간 자산은 승인된 얼굴을 Seedance 비디오 생성에 사용할 수 있는 동의 기반 방법을 제공하며, 권한 부여, 자산 처리 및 생성을 별도의 검증 가능한 단계로 유지합니다.

이 가이드는 실제 인간 비디오가 무엇인지, AIHubMix 워크플로우가 어떻게 작동하는지, 왜 유용한지, 그리고 실제 얼굴로 Seedance 2.5 비디오를 만드는 방법을 설명합니다. 또한 기본 Seedance 2.5 API와 호환 가능한 Seedance 2.0 통합의 차이점도 설명합니다.

실제 인간 비디오란?

실제 인간 비디오는 승인된 사람을 신원 참조로 사용하는 AI 생성 비디오입니다. 모델은 설정, 의상, 행동, 카메라 움직임, 목소리 또는 언어를 변경할 수 있지만, 그 사람의 인식 가능한 외모는 유지합니다.

이는 일반적인 텍스트-비디오 생성과 다릅니다. 텍스트 프롬프트는 어떤 일이 일어나야 하는지를 설명하지만, 특정 실제 사람을 신뢰성 있게 식별하지는 않습니다. 실제 인간 자산은 모델에 여러 비디오에서 재사용할 수 있는 승인된 시각적 참조를 제공합니다.

일반적인 응용 프로그램에는 크리에이터 아바타, 가상 발표자, 제품 설명, 지역화 캠페인, 교육 비디오, 브랜드 캐릭터 및 짧은 형식의 소셜 콘텐츠가 포함됩니다.

AIHubMix 워크플로우 작동 방식

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

1. 한 사람에 대한 자산 그룹 생성.
2. 이미지의 사람에게 권한 부여 흐름을 완료하도록 요청.
3. 초상화를 추가하고 자산이 활성화될 때까지 기다림.
4. asset:// URI로 활성 자산 참조.
5. 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"}'

반환된 id를 저장합니다. 이는 ag_...와 같은 형식입니다:

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\":\"자연스러운 수직 브이로그. 그 사람이 미소를 지으며 손을 흔들고 일본어로 말합니다: やっほー！今日も笑顔でね！ 얼굴을 일관되게 유지하고, 입술 움직임을 동기화하며, 자연스러운 손 동작을 사용하고, 자막을 추가하지 마십시오.\",
    \"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 참조 필드를 사용하십시오.

최종 체크리스트

1. API 키가 안전하게 구성됨.
2. 자산 그룹이 생성됨.
3. 사람의 권한 부여가 완료됨.
4. 그룹 상태가 active.
5. 초상화 자산 상태가 active.
6. 비디오 요청이 asset://<asset_id>를 사용함.
7. 비디오 작업이 completed될 때까지 폴링됨.

AIHubMix의 실제 인간 자산은 개발자에게 Seedance와 함께 동의 기반의 신원 일관성 비디오 경험을 구축할 수 있는 실용적인 방법을 제공합니다. 하나의 승인된 초상화와 짧은 테스트 클립으로 시작한 후, 동일한 워크플로우를 크리에이터 도구, 브랜드 콘텐츠 및 프로덕션 애플리케이션으로 확장하십시오.