콘텐츠로 건너뛰기

TRELLIS.2 LoRA Inference

통합

모델 id trellis-2-lora
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청: $0.25 250 API 크레딧 이 페이지에서 실행

API 키 받기
Microsoft 이미지를 3D로

구조, 지오메트리 및 텍스처에 사용자 지정 LoRA 어댑터를 적용할 수 있는 Trellis 2 이미지-3D 모델

Microsoft · 3D

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수 image_url
파일을 끌어다 놓거나

3D 모델로 변환할 원본 이미지 URL입니다.

resolution 기본값 512

생성 해상도입니다. 1024를 선택하면 cascade 파이프라인이 사용됩니다. 제공된 LoRA 어댑터를 학습하는 데 사용한 해상도를 선택해야 하며 일치해야 합니다.

고급 texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · seed · enable_safety_checker

텍스처 노이즈 제거기 전용으로 학습된 선택적 safetensors 형식 LoRA 체크포인트입니다.

texture_size 기본값 2048

GLB 내보내기에 베이크되는 텍스처의 해상도입니다.

희소 구조 노이즈 제거기 전용으로 학습된 선택적 safetensors 형식 LoRA 체크포인트입니다.

기하 노이즈 제거기 전용으로 학습된 선택적 safetensors 형식 LoRA 체크포인트입니다.

기본값 7.5

희소 구조 생성 중 classifier-free guidance 강도입니다.

기본값 0.7

희소 구조 생성 중 안내 재조정입니다. 값이 클수록 출력이 안정적입니다.

기본값 0.6

희소 구조 안내가 시작되는 노이즈 제거 진행률입니다.

기본값 1

희소 구조 안내가 중지되는 시점을 지정하려면 `ss_guidance_interval_start` 이상인 노이즈 제거 비율을 사용하세요.

기본값 12

희소 구조 생성 중 사용하는 노이즈 제거 단계 수입니다.

기본값 5

희소 구조 생성 중 노이즈 스케줄의 선명도입니다.

기본값 7.5

형태 생성 중 classifier-free guidance 강도입니다.

기본값 0.5

형태 생성 중 안내에 적용되는 재조정입니다. 기하에 노이즈가 보이면 값을 높이세요.

기본값 0.6

형태 단계 안내가 시작되는 노이즈 제거 비율입니다.

기본값 1

형태 단계 안내의 중지 지점입니다. shape_slat_guidance_interval_start 이상인 노이즈 제거 비율로 지정합니다.

기본값 12

형태 생성 중 사용하는 노이즈 제거 단계 수입니다.

기본값 3

형태 생성 중 노이즈 스케줄의 선명도입니다.

기본값 1

텍스처 생성 중 classifier-free guidance 강도입니다.

기본값 0

텍스처 생성 중 안내에 적용되는 재조정입니다. 텍스처에 노이즈가 보이면 값을 높이세요.

기본값 0.6

텍스처 단계 안내가 시작되는 노이즈 제거 비율입니다.

기본값 0.9

텍스처 단계 안내의 중지 지점입니다. tex_slat_guidance_interval_start 이상인 노이즈 제거 비율로 지정합니다.

기본값 12

텍스처 생성 중 사용하는 노이즈 제거 단계 수입니다.

기본값 3

텍스처 생성 중 노이즈 스케줄의 선명도입니다.

기본값 500000

GLB 내보내기에서 원하는 정점 수입니다.

생성 결과를 재현할 수 있게 하는 무작위 시드입니다.

POST /run/trellis-2-lora?wait=20 견적 → $0.25
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

TRELLIS.2 LoRA Inference 정보

`image_url`에서 GLB를 생성하며, `sparse_structure_lora_url`, `geometry_lora_url`, `texture_lora_url`을 통해 safetensors LoRA를 선택적으로 적용합니다. `resolution`은 512 또는 1024이며 어댑터의 학습 해상도와 일치해야 합니다. 단계별 가이던스 및 단계 제어, `decimation_target`, `texture_size`도 제공합니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
image_url필수 image
유형url · image
3D 모델로 변환할 원본 이미지 URL입니다.
sparse_structure_lora_url선택 사항
유형string | null
희소 구조 노이즈 제거기 전용으로 학습된 선택적 safetensors 형식 LoRA 체크포인트입니다.
geometry_lora_url선택 사항
유형string | null
기하 노이즈 제거기 전용으로 학습된 선택적 safetensors 형식 LoRA 체크포인트입니다.
texture_lora_url선택 사항
유형string | null
텍스처 노이즈 제거기 전용으로 학습된 선택적 safetensors 형식 LoRA 체크포인트입니다.
seed선택 사항
유형integer | null
생성 결과를 재현할 수 있게 하는 무작위 시드입니다.
resolution선택 사항
유형enum
기본값512
5121024
생성 해상도입니다. 1024를 선택하면 cascade 파이프라인이 사용됩니다. 제공된 LoRA 어댑터를 학습하는 데 사용한 해상도를 선택해야 하며 일치해야 합니다.
ss_guidance_strength선택 사항
유형number
기본값7.5
0 – 10
희소 구조 생성 중 classifier-free guidance 강도입니다.
ss_guidance_rescale선택 사항
유형number
기본값0.7
0 – 1
희소 구조 생성 중 안내 재조정입니다. 값이 클수록 출력이 안정적입니다.
ss_guidance_interval_start선택 사항
유형number
기본값0.6
0 – 1
희소 구조 안내가 시작되는 노이즈 제거 진행률입니다.
ss_guidance_interval_end선택 사항
유형number
기본값1
0 – 1
희소 구조 안내가 중지되는 시점을 지정하려면 `ss_guidance_interval_start` 이상인 노이즈 제거 비율을 사용하세요.
ss_sampling_steps선택 사항
유형integer
기본값12
1 – 50
희소 구조 생성 중 사용하는 노이즈 제거 단계 수입니다.
ss_rescale_t선택 사항
유형number
기본값5
1 – 6
희소 구조 생성 중 노이즈 스케줄의 선명도입니다.
shape_slat_guidance_strength선택 사항
유형number
기본값7.5
0 – 10
형태 생성 중 classifier-free guidance 강도입니다.
shape_slat_guidance_rescale선택 사항
유형number
기본값0.5
0 – 1
형태 생성 중 안내에 적용되는 재조정입니다. 기하에 노이즈가 보이면 값을 높이세요.
shape_slat_guidance_interval_start선택 사항
유형number
기본값0.6
0 – 1
형태 단계 안내가 시작되는 노이즈 제거 비율입니다.
shape_slat_guidance_interval_end선택 사항
유형number
기본값1
0 – 1
형태 단계 안내의 중지 지점입니다. shape_slat_guidance_interval_start 이상인 노이즈 제거 비율로 지정합니다.
shape_slat_sampling_steps선택 사항
유형integer
기본값12
1 – 50
형태 생성 중 사용하는 노이즈 제거 단계 수입니다.
shape_slat_rescale_t선택 사항
유형number
기본값3
1 – 6
형태 생성 중 노이즈 스케줄의 선명도입니다.
tex_slat_guidance_strength선택 사항
유형number
기본값1
0 – 10
텍스처 생성 중 classifier-free guidance 강도입니다.
tex_slat_guidance_rescale선택 사항
유형number
기본값0
0 – 1
텍스처 생성 중 안내에 적용되는 재조정입니다. 텍스처에 노이즈가 보이면 값을 높이세요.
tex_slat_guidance_interval_start선택 사항
유형number
기본값0.6
0 – 1
텍스처 단계 안내가 시작되는 노이즈 제거 비율입니다.
tex_slat_guidance_interval_end선택 사항
유형number
기본값0.9
0 – 1
텍스처 단계 안내의 중지 지점입니다. tex_slat_guidance_interval_start 이상인 노이즈 제거 비율로 지정합니다.
tex_slat_sampling_steps선택 사항
유형integer
기본값12
1 – 50
텍스처 생성 중 사용하는 노이즈 제거 단계 수입니다.
tex_slat_rescale_t선택 사항
유형number
기본값3
1 – 6
텍스처 생성 중 노이즈 스케줄의 선명도입니다.
decimation_target선택 사항
유형integer
기본값500000
5,000 – 2,000,000
GLB 내보내기에서 원하는 정점 수입니다.
texture_size선택 사항
유형enum
기본값2048
102420484096
GLB 내보내기에 베이크되는 텍스처의 해상도입니다.
enable_safety_checker선택 사항
유형boolean
기본값true
호출자에게 권한이 있으면 false로 설정해 검사를 완화할 수 있습니다.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2-lora",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
model_glb
object {url, content_type, file_name, file_size}생성된 3D 모델이 포함된 GLB 파일입니다.
seed
integer생성 중 적용된 시드입니다.
resolution
integer생성을 수행한 해상도입니다.
sparse_structure_lora_url
string | null생성 중 적용된 경우 사용하는 희소 구조 LoRA 체크포인트입니다.
geometry_lora_url
string | null생성 중 적용된 경우 사용하는 기하 LoRA 체크포인트입니다.
texture_lora_url
string | null생성 중 적용된 경우 사용하는 텍스처 LoRA 체크포인트입니다.
decimation_target
integerGLB 내보내기에 적용되는 정점 수 목표입니다.
texture_size
integerGLB 내보내기에 베이크되는 텍스처의 해상도입니다.

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/trellis-2-lora.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt