Asset Library 완전 연동 가이드
— 실사 인물 관리 & API 레퍼런스

{
  "Statement": [
    {
      "Effect":   "Allow",
      "Action":   ["ark:*Asset*"],
      "Resource": ["*"]
    }
  ]
}

회사 관리 계정 / digicap_test 프로젝트
 ├─ 배우 A → CreateVisualValidateSession → H5Link (QR로 전달) → 인증 → Group A → 배우 A 이미지
 ├─ 배우 B → CreateVisualValidateSession → H5Link (QR로 전달) → 인증 → Group B → 배우 B 이미지
 └─ 배우 C → CreateVisualValidateSession → H5Link (QR로 전달) → 인증 → Group C → 배우 C 이미지

핵심 원칙
 • CreateVisualValidateSession 은 배우마다 별도 호출
 • BytedToken · GroupId 는 배우 식별자(DB)와 1:1 매핑
 • 모든 Group · Asset · Seedance Endpoint 에 동일 ProjectName 사용

POST /?Action=ListAssets&Version=2024-01-01 HTTP/1.1
Host:             ark.ap-southeast-1.byteplusapi.com
Content-Type:     application/json; charset=UTF-8
X-Date:          <UTC timestamp, e.g. 20260729T090000Z>
X-Content-Sha256: <SHA256 hex of request body>
Authorization:   HMAC-SHA256 Credential=<AK>/<date>/ap-southeast-1/ark/request, ...

// POST /?Action=ListAssets&Version=2024-01-01
{
  "Filter": {
    "GroupType": "LivenessFace",
    "Statuses":  ["Active", "Processing"]
  },
  "PageNumber":  1,
  "PageSize":    100,
  "SortBy":      "GroupId",
  "SortOrder":   "Asc",
  "ProjectName": "digicap_test"
}

// POST /?Action=CreateVisualValidateSession&Version=2024-01-01
{
  "ProjectName": "digicap_test",
  "CallbackURL": "https://your-platform.com/auth/callback"
  // ExpireTime 파라미터는 공식 문서에 정의되어 있지 않으므로 추가하지 않습니다
}

// 응답 — 실제 필드명은 H5Link (H5Url 아님)
{
  "SessionId":   "session-xxxxxxxxxxxx",
  "H5Link":      "https://validate.byteplus.com/liveness?session=...",  // 배우에게 전달하거나 QR로 변환
  "BytedToken":  "byted-xxxxxx"  // 공식 문서상 30분 유효
}

// POST /?Action=GetVisualValidateResult&Version=2024-01-01
{
  "SessionId":   "session-xxxxxxxxxxxx",
  "ProjectName": "digicap_test"
}

// 응답 — Status가 Completed이고 resultCode=10000일 때 GroupId 사용
{
  "Status":      "Completed",          // Pending | Completed | Failed
  "GroupId":     "grp-zzzzzzzzzzzzzzzz",// 인증된 LivenessFace Group ID → DB에 배우와 매핑
  "resultCode":  10000                  // 10000 = 인증 성공
}

// POST /?Action=CreateAsset&Version=2024-01-01
{
  "GroupId":     "grp-zzzzzzzzzzzzzzzz",
  "Name":        "홍길동_정면샷_01",
  "AssetType":   "Image",
  "URL":         "https://your-cdn.example.com/portrait.jpg",  // 공개 접근 가능한 URL
  "ProjectName": "digicap_test"
}

// 응답
{
  "AssetId": "asset-yyyyyyyyyyyyyyyy",
  "Status":  "Processing"  // 비동기 처리 시작 — 아래 폴링 패턴으로 Active 대기
}

import time

def wait_for_active(asset_id, project_name,
                    max_attempts=20, interval_sec=3):
    """CreateAsset 후 Active 상태가 될 때까지 폴링."""
    for attempt in range(max_attempts):
        res = call_ark_api(
            action="GetAsset",
            body={"AssetId": asset_id, "ProjectName": project_name}
        )
        status = res["Asset"]["Status"]

        if status == "Active":
            return asset_id               # 사용 가능

        if status == "Failed":
            err = res["Asset"].get("FailReason", "unknown")
            raise RuntimeError(f"Asset processing failed: {err}")

        # Processing — 재시도
        time.sleep(interval_sec)

    raise TimeoutError(
        f"Asset {asset_id} did not become Active "
        f"after {max_attempts * interval_sec}s"
    )

# 사용 예
asset_id = create_asset(group_id, image_url)["AssetId"]
wait_for_active(asset_id, project_name="digicap_test")
# 이후 Seedance 호출에 asset_id 사용 가능

POST /chat/completions
Authorization: Bearer {MODELARK_API_KEY}

{
  "model": "ep-20260710123019-wz6fj",
  "content": [
    {
      "type": "text",
      "text": "Image 1의 인물이 카메라를 바라보며 자연스럽게 인사한다."
    },
    {
      "type":       "image_url",
      "image_url": { "url": "asset://asset-yyyyyyyyyyyyyyyy" },
      "role":       "reference_image"
    }
  ],
  "generate_audio": true,
  "ratio":         "16:9",
  "duration":      5,
  "watermark":     false
}

// 여러 레퍼런스를 content 배열에 순서대로 추가
// 프롬프트에서 "Image 1", "Image 2" 로 참조
{
  "model": "ep-20260710123019-wz6fj",
  "content": [
    {
      "type": "text",
      "text": "Image 1의 인물이 Image 2의 배경에서 걷고 있다."
    },
    {
      "type":       "image_url",
      "image_url": { "url": "asset://asset-person-id" },
      "role":       "reference_image"   // → Image 1
    },
    {
      "type":       "image_url",
      "image_url": { "url": "https://cdn.example.com/background.jpg" },
      "role":       "reference_image"   // → Image 2 (t2i 생성 이미지 — 직접 URL 가능)
    }
  ],
  "ratio": "16:9",
  "duration": 5
}