TRELLIS.2 4B API: 요금, 플레이그라운드, 문서

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

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

TRELLIS.2 4B 소개

TRELLIS.2 이미지-to-3D 모델은 해상도, 종자, 메쉬, 질감, 수출 컨트롤을 가진 텍스처 GLB 자산으로 참조 이미지를 전환합니다.

다른 이름 Microsoft TRELLIS.2 4B, TRELLIS.2-4B, 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가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.

파라미터	유형	기본값	범위 / 값	설명
image	image	-	-	이미지 URL, 데이터 URI, 또는 업로드된 이미지 객체를 참조하세요.
resolution	enum	1024	512, 1024, 1536	복셀 그리드 해상도. 높은 수치일수록 더 느리고 세밀합니다.
pipeline_type	enum	1024_cascade	512, 1024_cascade, 1536_cascade	명시적인 TRELLIS 파이프라인. 512나 1536 경로가 필요하지 않다면 1024 캐스케이드로 출발하세요.
seed	integer	42	0 ~ 2147483647	복제 가능한 세대를 위한 무작위 시드.
preprocess_image	boolean	true	-	배경을 제거하고 참조 이미지를 정규화한 후 생성하세요.
max_num_tokens	integer	49152	1024 ~ 131072	캐스케이드 생성에 사용되는 최대 희소 토큰.
ss_sampling_steps	integer	12	1 ~ 64	희소 구조 생성을 위한 샘플러 단계.
ss_guidance_strength	number	7.5	0 ~ 20	희소 구조 생성을 위한 가이드 강도.
ss_guidance_rescale	number	0.7	0 ~ 2	희소 구조 생성을 위한 가이드 재조정.
ss_guidance_interval_start	number	0.6	0 ~ 1	희소 구조 유도 간격 시작.
ss_guidance_interval_end	number	1	0 ~ 1	희소 구조 유도 구간 종료.
ss_rescale_t	number	5	0 ~ 20	희소한 구조 생성을 위해 온도를 재조정하세요.
shape_slat_sampling_steps	integer	12	1 ~ 64	형태 구조적 잠재 생성을 위한 샘플러 단계.
shape_slat_guidance_strength	number	7.5	0 ~ 20	구조적 잠재 생성에 대한 유도 강도.

문서에 파라미터 21개 더 있음

알아두면 좋은 점

디폴트 - 1024 캐스케이드 파이프 라인 - 스테이지 당 12 샘플러 단계 - 2048 텍스처 크기 - 500k decimation 대상 - GLB 출력 컨트롤 이미지 URL 또는 업로드를 지원, 512/1024 /1536 해결책,씨, 파이프라인 유형, 견본 guidance/interval /rescale 통제, 짜임새 크기, 메시 decimation, remeshing, UV unwrap tuning 및 URL 또는 base64 산출. 빌링은 생성된 3D 자산 당입니다.

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

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

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

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

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

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

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

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

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

TRELLIS.2 4B API