> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Doubao 비공개 가상 인물 이미지 소재

> 본인 확인 없이 가상 인물 이미지 소재 그룹을 만들고 이미지를 업로드하여 Seedance 영상 생성에 사용합니다.

이 문서는 비공개 가상 인물 이미지 소재만 다룹니다. 공개 가상 인물 이미지 카탈로그는 포함하지 않습니다.

## 사전 조건

* `AIHUBMIX_API_KEY`를 환경 변수로 설정합니다.
* 대상 영상 모델과 가상 인물 이미지 기능을 활성화합니다.
* 모델 프로바이더가 읽을 수 있는 공개 HTTPS 이미지 URL을 준비합니다.

## 소재 그룹 만들기

`POST /ai/v1/asset-groups` 요청에 `kind: "virtual_portrait"`를 지정합니다. 성공 응답은 `201`이며 일반적으로 `active`, 인증 상태는 `not_required`입니다. 본인 확인 Session은 사용하지 않습니다.

```bash theme={null}
BASE_URL="https://aihubmix.com"
curl --fail-with-body -sS -X POST "$BASE_URL/ai/v1/asset-groups" -H "Authorization: Bearer $AIHUBMIX_API_KEY" -H "Content-Type: application/json" -d '{"name":"가상 인물 이미지","kind":"virtual_portrait"}' | jq
```

## 이미지 업로드 및 영상 생성

`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는 환경 변수로만 관리합니다.