TRELLIS.2 4B API

TRELLIS.2 이미지-3D 모델은 참조 이미지를 해상도, 시드, 메쉬, 텍스처, 내보내기 컨트롤이 있는 텍스처가 있는 GLB 자산으로 변환합니다.

Microsoft3D 생성네이티브 추론

TRELLIS.2 4B 소개

TRELLIS.2 이미지-3D 모델은 참조 이미지를 해상도, 시드, 메쉬, 텍스처, 내보내기 컨트롤이 있는 텍스처가 있는 GLB 자산으로 변환합니다.

다른 이름 Microsoft TRELLIS.2 4B

image to 3dglb outputpbr materialsseed controlcommercial ready

TRELLIS.2 4B 사양

모델 ID
trellis-2-4b
개발사
Microsoft
카테고리
3D 생성
출시
-
입력
이미지
출력
3D
엔드포인트
POST/v1/3d/generations
대체 모델 ID
microsoft/trellis.2-4btrellis-2

TRELLIS.2 4B API 요금최대 90% 절약

EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.

유형
사양
요금
512 자산
요청에 따라
$0.25$0.025
1024 자산
요청에 따라
$0.30$0.249
1536 자산
요청에 따라
$0.499
전체 가격 페이지에서 비교

TRELLIS.2 4B API 호출 방법

TRELLIS.2 4B은(는) POST /v1/3d/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. EmpirioLabs 대시보드에서 API 키를 발급받으세요.

cURL: 작업 제출
curl https://api.empiriolabs.ai/v1/3d/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "trellis-2-4b",
    "prompt": "Describe what you want TRELLIS.2 4B to generate."
  }'
cURL: 결과 폴링
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/3d/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "trellis-2-4b",
        "prompt": "Describe what you want TRELLIS.2 4B 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)
TRELLIS.2 4B API 전체 레퍼런스

TRELLIS.2 4B API 파라미터

EmpirioLabs에서 TRELLIS.2 4B API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.

파라미터유형기본값범위 / 값설명
imageimage--이미지 URL, 데이터 URI, 또는 업로드된 이미지 객체를 참조하세요.
resolutionenum1024512, 1024, 1536복셀 그리드 해상도. 높은 수치일수록 더 느리고 세밀합니다.
pipeline_typeenum1024_cascade512, 1024_cascade, 1536_cascade명시적인 TRELLIS 파이프라인. 512나 1536 경로가 필요하지 않다면 1024 캐스케이드로 출발하세요.
seedinteger420 ~ 2147483647복제 가능한 세대를 위한 무작위 시드.
preprocess_imagebooleantrue-배경을 제거하고 참조 이미지를 정규화한 후 생성하세요.
max_num_tokensinteger491521024 ~ 131072캐스케이드 생성에 사용되는 최대 희소 토큰.
ss_sampling_stepsinteger121 ~ 64희소 구조 생성을 위한 샘플러 단계.
ss_guidance_strengthnumber7.50 ~ 20희소 구조 생성을 위한 가이드 강도.
ss_guidance_rescalenumber0.70 ~ 2희소 구조 생성을 위한 가이드 재조정.
ss_guidance_interval_startnumber0.60 ~ 1희소 구조 유도 간격 시작.
ss_guidance_interval_endnumber10 ~ 1희소 구조 유도 구간 종료.
ss_rescale_tnumber50 ~ 20희소한 구조 생성을 위해 온도를 재조정하세요.
shape_slat_sampling_stepsinteger121 ~ 64형태 구조적 잠재 생성을 위한 샘플러 단계.
shape_slat_guidance_strengthnumber7.50 ~ 20구조적 잠재 생성에 대한 유도 강도.
문서에 파라미터 21개 더 있음

알아두면 좋은 점

기본값 - 1024 캐스케이드 파이프라인 - 단계당 12단계 샘플러 - 2048 텍스처 크기 - 500k 디시메이션 목표 - GLB 출력 컨트롤 이미지 URL 또는 업로드, 512/1024/1536 해상도, 시드, 파이프라인 유형, 샘플러 guidance/interval/리스케일 컨트롤, 텍스처 크기, 메시 디시메이션, 리메싱, UV 언랩 튜닝, URL 또는 base64 출력을 지원합니다. 청구는 생성된 3D 자산 단위로 계산됩니다.

TRELLIS.2 4B API: 자주 묻는 질문

TRELLIS.2 4B API 비용은 얼마인가요?

EmpirioLabs에서 TRELLIS.2 4B은(는) 종량제로 청구됩니다. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.

TRELLIS.2 4B은(는) 어떤 엔드포인트를 사용하나요?

TRELLIS.2 4B은(는) api.empiriolabs.aiPOST /v1/3d/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.

통합하기 전에 브라우저에서 TRELLIS.2 4B을(를) 사용해 볼 수 있나요?

네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 TRELLIS.2 4B을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.

TRELLIS.2 4B API 키는 어떻게 발급받나요?

EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.

더 나은 엔드포인트를 사용할 준비가 되셨나요?

저희 가격을 확인하시거나 저희 스택에 자체 모델을 배포하고 싶으시면 연락해 주세요.