멀티뷰에서 3D 모델로 — P 시리즈

POST /v3/generation/multiview-to-model

P 시리즈 모델을 사용하여 다중 뷰 이미지에서 3D 모델을 생성합니다. 깨끗한 토폴로지를 사용하여 로우 폴리 생성에 최적화되었습니다.

표준과의 주요 차이점

로우폴리 출력에 최적화(P1-20260311: 50~20,000면, P2-20260801: 최대 50,000면)
quad는 P2-20260801에서만 지원됩니다. smart_low_poly, generate_parts, geometry_quality는 지원 하지 않음

요청 매개변수

매개변수	유형	필수	기본값	설명
inputs	문자열[]	필수	-	4개의 멀티뷰 이미지 목록 [앞, 왼쪽, 뒤, 오른쪽]
original_task_id	문자열	선택사항	-	이전 다중 뷰 세대의 작업 ID입니다. 입력과 상호 배타적
model	문자열	필수	-	P 시리즈 모델 버전. 값: `P1-20260311`(로우폴리 최적화), `P2-20260801`(차세대, 쿼드 출력 지원. Preview)
texture_alignment	문자열	선택사항	original_image	`original_image` 또는 `geometry`
orientation	문자열	선택사항	기본값	`default` 또는 `align_image`
model_seed	정수	선택사항	무작위	기하학의 무작위 시드
face_limit	정수	선택사항	적응형	최대 폴리카운트. `P1-20260311`: 50~20,000; `P2-20260801` 삼각면: 48~50,000, `quad=true` 시: 48~25,000
texture	부울	선택사항	사실	텍스처 맵 활성화
pbr	부울	선택사항	사실	PBR를 활성화합니다. 강제 텍스처=true
texture_seed	정수	선택사항	무작위	텍스처의 무작위 시드
texture_quality	문자열	선택사항	표준	`standard`, `detailed` 또는 `extreme`
auto_size	부울	선택사항	거짓	실제 크기로 확장
export_uv	부울	선택사항	사실	UV 언래핑 제어
export_orientation	문자열	선택사항	`+x`	수출 방향. 사용 가능한 값: `-x`, `-y`, `+y`
quad	부울	선택사항	false	`P2-20260801` 전용. 삼각면 대신 쿼드 메시를 출력합니다. 출력 형식이 `FBX`로 고정되며, `face_limit` 미지정 시 기본 10,000면입니다.

export_orientation 참고 사항:

이번 생성에만 적용됩니다. 모델을 후처리 작업(텍스처, 리그, 리타겟, 변환 등)에 사용할 경우 이 파라미터를 설정하지 않는 것이 좋습니다.
설정하면 후처리 시 모델 방향 오류로 인해 최종 결과에 영향을 줄 수 있지만, 작업은 계속 status: success를 보고합니다 — 오류가 발생하지 않습니다. 주의해서 사용하세요.
모델을 후처리할 계획이라면 이 파라미터를 설정하지 말고 마지막 단계에서 /v3/models/convert를 사용하여 방향을 변환하세요.

예

JSON

{
  "inputs": [
    "https://example.com/front.png",
    "https://example.com/back.png",
    "https://example.com/left.png",
    "https://example.com/right.png"
  ],
  "model": "P1-20260311",
  "face_limit": 5000,
  "texture": true
}

P2-20260801(쿼드 출력):

JSON

{
  "inputs": [
    "https://example.com/front.png",
    "https://example.com/back.png",
    "https://example.com/left.png",
    "https://example.com/right.png"
  ],
  "model": "P2-20260801",
  "quad": true,
  "face_limit": 8000,
  "texture": true
}