사전 조건
AIHUBMIX_API_KEY를 환경 변수로 설정합니다.- 대상 영상 모델과 가상 인물 이미지 기능을 활성화합니다.
- 모델 프로바이더가 읽을 수 있는 공개 HTTPS 이미지 URL을 준비합니다.
소재 그룹 만들기
POST /ai/v1/asset-groups 요청에 kind: "virtual_portrait"를 지정합니다. 성공 응답은 201이며 일반적으로 active, 인증 상태는 not_required입니다. 본인 확인 Session은 사용하지 않습니다.
이미지 업로드 및 영상 생성
POST /ai/v1/asset-groups/<group_id>/assets에 공개 이미지 URL과 asset_type: "image"를 전달합니다. GET /ai/v1/assets/<asset_id>로 조회하여 active가 된 후 사용합니다.
영상 요청에서는 반환된 소재 ID를 asset://<asset_id>로 사용하고, GET /ai/v1/videos/<video_id>에서 status=completed를 확인한 뒤 /content 경로로 영상을 가져옵니다.
creating 또는 reconciling 그룹은 생성 결과가 확정되지 않았으므로 자동 삭제하지 않습니다. API Key는 환경 변수로만 관리합니다.