
구조 인식 텍스처를 적용한 프로덕션 중심의 이미지 투 3D, 1536 및 1536 Pro 정밀 티어, 최대 200만 개의 얼굴 메시, 그리고 5가지 내보내기 포맷.
구조 인식 텍스처를 적용한 프로덕션 중심의 이미지 투 3D, 1536 및 1536 Pro 정밀 티어, 최대 200만 개의 얼굴 메시, 그리고 5가지 내보내기 포맷.
hitem3d-2-0/v1/3d/generationshitem3d-2.0hitem3d-2-0-251223EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.
Hitem3D 2.0은(는) POST /v1/3d/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. EmpirioLabs 대시보드에서 API 키를 발급받으세요.
curl https://api.empiriolabs.ai/v1/3d/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hitem3d-2-0",
"prompt": "Describe what you want Hitem3D 2.0 to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/3d/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "hitem3d-2-0",
"prompt": "Describe what you want Hitem3D 2.0 to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)EmpirioLabs에서 Hitem3D 2.0 API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| image | image | - | - | 객체의 입력 이미지가 1개에서 4개입니다. 여러 뷰가 있을 때는 multi_images_bit 사용하여 뷰 순서를 선언하세요. |
| prompt | string | - | - | 세대를 위한 선택적 안내 텍스트. |
| resolution | enum | 1536 | 1536, 1536pro | 기하학 해상도. 1536pro는 고정밀도 등급이며 발전당 요금이 더 높습니다. |
| texture | boolean | true | - | 지오메트리로 텍스처를 생성하세요. 오프는 더 낮은 세대당 백인 모델을 반환합니다. |
| face_count | integer | - | 100000 ~ 2000000 | 출력 메시의 타겟 폴리곤 수. |
| file_format | enum | glb | glb, obj, stl, fbx, usdz | 생성된 모델의 3D 파일 형식. |
| multi_images_bit | string | - | - | 입력 이미지의 뷰를 나타내는 네 자리 0/1 앞, 뒤, 왼쪽, 오른쪽 순서입니다. 예시: 앞쪽과 왼쪽 1010. |
이미지에서 3D로만 지원: 객체의 1개에서 4개의 뷰(앞, 뒤, 좌우 순서로 multi_images_bit 뷰 순서를 선언). 청구는 선택한 해상도와 텍스처 설정의 티어에서 생성된 모델별로 계산됩니다.
EmpirioLabs에서 Hitem3D 2.0은(는) 종량제로 청구됩니다: 1536년 텍스처 $2.80 요청에 따라; 1536 프로 텍스처 $3.60 요청에 따라; 1536년형 흰색 모델 $1.60 요청에 따라; 1536 프로 화이트 모델 $2.40 요청에 따라. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.
Hitem3D 2.0은(는) api.empiriolabs.ai의 POST /v1/3d/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Hitem3D 2.0을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.