POST /v1/3d/generationsTRELLIS.2 이미지-3D 모델은 참조 이미지를 해상도, 시드, 메쉬, 텍스처, 내보내기 컨트롤이 있는 텍스처가 있는 GLB 자산으로 변환합니다.
| 필드 | 가치 |
|---|---|
| 모델 ID | trellis-2-4b |
| 모델 출시일 | - |
| 입력 양상 | 이미지 |
| 출력 방식 | 3D |
| 컨텍스트 윈도우 | - |
| 무게 정밀도 | 혼합 BF16/FP16 |
| 특징 | image_to_3d, glb_output, pbr_materials, seed_control, commercial_ready |
| 원주민 추론 | 네 |
| 신규 | 네 |
| 지원되는 엔드포인트 | POST /v1/3d/generations |
| 돌격 | 사양 | 요금 |
|---|---|---|
| 512 자산 | 요청에 따라 | $0.025 ($0.25였다) |
| 1024 자산 | 요청에 따라 | $0.249 ($0.30였다) |
| 1536 자산 | 요청에 따라 | $0.499 |
$ curl https://api.empiriolabs.ai/v1/3d/generations \ > -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \ > -H 'Content-Type: application/json' \ > -d '{"model": "trellis-2-4b", "image_url": "https://example.com/product-photo.png", "resolution": "1024", "texture_size": "2048"}'
| 매개변수 | 유형 | 필수 | 기본 설정 | 설명 |
|---|---|---|---|---|
image | 이미지 | 네 | - | 이미지 URL, 데이터 URI, 또는 업로드된 이미지 객체를 참조하세요. |
resolution | 열거 | 아니 | "1024" | 복셀 그리드 해상도. 높은 수치일수록 더 느리고 세밀합니다. · 허용: 512, 1024, 1536 |
pipeline_type | 열거 | 아니 | "1024_cascade" | 명시적인 TRELLIS 파이프라인. 512나 1536 경로가 필요하지 않다면 1024 캐스케이드로 출발하세요. · 허용: 512, 1024_cascade, 1536_cascade |
seed | 정수 | 아니 | 42 | 복제 가능한 세대를 위한 무작위 시드. · 사거리: 0 – 2147483647 |
preprocess_image | 불리언 | 아니 | 맞아요 | 배경을 제거하고 참조 이미지를 정규화한 후 생성하세요. |
max_num_tokens | 정수 | 아니 | 49152 | 캐스케이드 생성에 사용되는 최대 희소 토큰. · 거리: 1024 – 131072 |
ss_sampling_steps | 정수 | 아니 | 12 | 희소 구조 생성을 위한 샘플러 단계. · 사거리: 1 – 64 |
ss_guidance_strength | 번호 | 아니 | 7.5 | 희소 구조 생성을 위한 가이드 강도. · 범위: 0 – 20 |
ss_guidance_rescale | 번호 | 아니 | 0.7 | 희소 구조 생성을 위한 가이드 재조정. · 사거리: 0 – 2 |
ss_guidance_interval_start | 번호 | 아니 | 0.6 | 희소 구조 유도 간격 시작. · 사거리: 0 – 1 |
ss_guidance_interval_end | 번호 | 아니 | 1 | 희소 구조 유도 구간 종료. · 사거리: 0 – 1 |
ss_rescale_t | 번호 | 아니 | 5 | 희소한 구조 생성을 위해 온도를 재조정하세요. · 범위: 0 – 20 |
shape_slat_sampling_steps | 정수 | 아니 | 12 | 형태 구조적 잠재 생성을 위한 샘플러 단계. · 사거리: 1 – 64 |
shape_slat_guidance_strength | 번호 | 아니 | 7.5 | 구조적 잠재 생성에 대한 유도 강도. · 범위: 0 – 20 |
shape_slat_guidance_rescale | 번호 | 아니 | 0.5 | 형태 구조적 잠재 생성에 대한 가이드 재조정. · 사거리: 0 – 2 |
shape_slat_guidance_interval_start | 번호 | 아니 | 0.6 | 도형 시작 SLat 유도 간격. · 사거리: 0 – 1 |
shape_slat_guidance_interval_end | 번호 | 아니 | 1 | 도형 종료 SLat 유도 간격. · 사거리: 0 – 1 |
shape_slat_rescale_t | 번호 | 아니 | 3 | 도형에 맞게 온도를 재조정하세요. 구조적 잠재 생성. · 범위: 0 – 20 |
tex_slat_sampling_steps | 정수 | 아니 | 12 | 텍스처 구조화 잠재 생성을 위한 샘플러 단계. · 사거리: 1 – 64 |
tex_slat_guidance_strength | 번호 | 아니 | 1 | 질감 구조적 잠재 생성에 대한 가이드 강도. · 범위: 0 – 20 |
tex_slat_guidance_rescale | 번호 | 아니 | 0 | 텍스처 구조화된 잠재 생성에 대한 가이드 재조정. · 사거리: 0 – 2 |
tex_slat_guidance_interval_start | 번호 | 아니 | 0.6 | 텍스처 SLat 가이던스 간격의 시작. · 사거리: 0 – 1 |
tex_slat_guidance_interval_end | 번호 | 아니 | 0.9 | 텍스처 SLat 가이던스 간격 끝. · 사거리: 0 – 1 |
tex_slat_rescale_t | 번호 | 아니 | 3 | 텍스처 구조 잠재 생성을 위한 온도 재조정. · 범위: 0 – 20 |
texture_size | 열거 | 아니 | "2048" | 텍스처 해상도가 GLB 재질에 베이크되었습니다. · 허용: 1024, 2048, 4096 |
decimation_target | 정수 | 아니 | 500000 | 내보내진 메쉬의 대략적인 목표 정점 수. · 범위: 10000 – 10000000 |
remesh | 불리언 | 아니 | 맞아요 | UV 언래핑과 텍스처 베이킹 전에 메시 토폴로지를 다시 구축하세요. |
remesh_band | 번호 | 아니 | 1 | 밴드 크기 재조정. · 사거리: 0 – 5 |
remesh_project | 번호 | 아니 | 0.9 | 리메시 시 사용 투영 계수. · 사거리: 0 – 1 |
uv_unwrap_angle_threshold_deg | 번호 | 아니 | 90 | UV 언랩 클러스터링에 사용되는 콘 반각(cone-half-angle) 임계값. · 범위: 1 – 180 |
uv_unwrap_refine_iterations | 정수 | 아니 | 0 | UV 클러스터링 정제화 반복. · 범위: 0 – 10 |
uv_unwrap_global_iterations | 정수 | 아니 | 1 | 글로벌 UV 클러스터링 반복. · 범위: 0 – 10 |
uv_unwrap_smooth_strength | 번호 | 아니 | 1 | UV 클러스터 스무딩 강도. · 범위: 0 – 10 |
response_format | 열거 | 아니 | "url" | 기본적으로 서명된 미디어 URL을 반환하거나, 요청 시 인라인 base64 json을 반환하세요. · 허용: url, b64_json |
verbose | 불리언 | 아니 | 거짓 | Verbose Mesh 내보내기 로그를 활성화하세요. |
디폴트
조작법
이미지 URL 또는 업로드, 512/1024/1536 해상도, 시드, 파이프라인 유형, 샘플러 guidance/interval/리스케일 컨트롤, 텍스처 크기, 메시 디시메이션, 리메싱, UV 언랩 튜닝, URL 또는 base64 출력을 지원합니다. 청구는 생성된 3D 자산당 계산됩니다.
Machine-읽기 가능한 스키마: GET https://api.empiriolabs.ai/v1/models/trellis-2-4b.