Lumaktaw sa nilalaman

TRELLIS.2 LoRA Inference

I-integrate

ID ng modelo 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"

Kahilingang ito: $0.25 250 kredito ng API Patakbuhin ito sa page na ito

Kumuha ng API key

Trellis 2 image-to-3D na maaaring maglapat ng custom LoRA adapter para sa structure, geometry at texture

Microsoft · 3D

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

•kinakailangan image_url
Mag-drop ng file, o

URL ng source larawan para sa conversion sa 3D modelo.

resolution default na 512

Resolution ng pagbuo; pinipili ng 1024 ang cascade pipeline. Piliin ang resolution na ginamit sa pagsasanay ng ibinigay na LoRA adapter; kinakailangan ang pagtutugma.

advanced 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

Opsyonal na LoRA checkpoint sa safetensors format, partikular na sinanay para sa texture denoiser.

texture_size default na 2048

Resolution ng mga texture na naka-bake sa GLB export.

Opsyonal na LoRA checkpoint sa safetensors format, partikular na sinanay para sa sparse structure denoiser.

Opsyonal na LoRA checkpoint sa safetensors format, partikular na sinanay para sa geometry denoiser.

default na 7.5

Lakas ng classifier-free guidance habang binubuo ang sparse structure.

default na 0.7

Rescaling ng guidance habang binubuo ang sparse structure. Mas nagiging stable ang output sa mas malalaking value.

default na 0.6

Fraction ng progreso ng denoising kung kailan nagsisimula ang sparse-structure guidance.

default na 1

Gumamit ng denoising fraction na katumbas o mas mataas sa `ss_guidance_interval_start` upang tukuyin kung kailan hihinto ang sparse-structure guidance.

default na 12

Bilang ng denoising step na ginagamit habang binubuo ang sparse structure.

default na 5

Sharpness ng noise schedule habang binubuo ang sparse structure.

default na 7.5

Lakas ng classifier-free guidance habang binubuo ang shape.

default na 0.5

Rescaling na inilalapat sa guidance habang binubuo ang shape; taasan ito kapag mukhang maingay ang geometry.

default na 0.6

Fraction ng denoising kung kailan nagsisimula ang guidance sa shape stage.

default na 1

Paghintong punto ng guidance sa shape stage, na ipinapahayag bilang denoising fraction na hindi mas mababa sa shape_slat_guidance_interval_start.

default na 12

Bilang ng denoising step habang binubuo ang shape.

default na 3

Sharpness ng noise schedule habang binubuo ang shape.

default na 1

Lakas ng classifier-free guidance habang binubuo ang texture.

default na 0

Rescaling na inilalapat sa guidance habang binubuo ang texture; taasan ito kapag mukhang maingay ang mga texture.

default na 0.6

Fraction ng denoising kung kailan nagsisimula ang guidance sa texture stage.

default na 0.9

Paghintong punto ng guidance sa texture stage, na ipinapahayag bilang denoising fraction na hindi mas mababa sa tex_slat_guidance_interval_start.

default na 12

Bilang ng denoising step habang binubuo ang texture.

default na 3

Sharpness ng noise schedule habang binubuo ang texture.

default na 500000

Ninanais na bilang ng vertex sa GLB export.

Random seed na ginagawang nauulit ang pagbuo.

POST /run/trellis-2-lora?wait=20 presyo → $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"

Patakbuhin ang kahilingang ito

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Kumuha ng API key

Tungkol sa TRELLIS.2 LoRA Inference

Gumagawa ng GLB mula sa `image_url`, na maaaring lagyan ng safetensors LoRA sa pamamagitan ng `sparse_structure_lora_url`, `geometry_lora_url` at `texture_lora_url`. Ang `resolution` ay 512 o 1024 at dapat tumugma sa training resolution ng mga adapter. May per-stage guidance at hakbang controls din, pati `decimation_target` at `texture_size`.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan
image_urlkinakailangan image
Uriurl · image
URL ng source larawan para sa conversion sa 3D modelo.
sparse_structure_lora_urlopsyonal
Uristring | null
Opsyonal na LoRA checkpoint sa safetensors format, partikular na sinanay para sa sparse structure denoiser.
geometry_lora_urlopsyonal
Uristring | null
Opsyonal na LoRA checkpoint sa safetensors format, partikular na sinanay para sa geometry denoiser.
texture_lora_urlopsyonal
Uristring | null
Opsyonal na LoRA checkpoint sa safetensors format, partikular na sinanay para sa texture denoiser.
seedopsyonal
Uriinteger | null
Random seed na ginagawang nauulit ang pagbuo.
resolutionopsyonal
Urienum
default512
5121024
Resolution ng pagbuo; pinipili ng 1024 ang cascade pipeline. Piliin ang resolution na ginamit sa pagsasanay ng ibinigay na LoRA adapter; kinakailangan ang pagtutugma.
ss_guidance_strengthopsyonal
Urinumber
default7.5
0 – 10
Lakas ng classifier-free guidance habang binubuo ang sparse structure.
ss_guidance_rescaleopsyonal
Urinumber
default0.7
0 – 1
Rescaling ng guidance habang binubuo ang sparse structure. Mas nagiging stable ang output sa mas malalaking value.
ss_guidance_interval_startopsyonal
Urinumber
default0.6
0 – 1
Fraction ng progreso ng denoising kung kailan nagsisimula ang sparse-structure guidance.
ss_guidance_interval_endopsyonal
Urinumber
default1
0 – 1
Gumamit ng denoising fraction na katumbas o mas mataas sa `ss_guidance_interval_start` upang tukuyin kung kailan hihinto ang sparse-structure guidance.
ss_sampling_stepsopsyonal
Uriinteger
default12
1 – 50
Bilang ng denoising step na ginagamit habang binubuo ang sparse structure.
ss_rescale_topsyonal
Urinumber
default5
1 – 6
Sharpness ng noise schedule habang binubuo ang sparse structure.
shape_slat_guidance_strengthopsyonal
Urinumber
default7.5
0 – 10
Lakas ng classifier-free guidance habang binubuo ang shape.
shape_slat_guidance_rescaleopsyonal
Urinumber
default0.5
0 – 1
Rescaling na inilalapat sa guidance habang binubuo ang shape; taasan ito kapag mukhang maingay ang geometry.
shape_slat_guidance_interval_startopsyonal
Urinumber
default0.6
0 – 1
Fraction ng denoising kung kailan nagsisimula ang guidance sa shape stage.
shape_slat_guidance_interval_endopsyonal
Urinumber
default1
0 – 1
Paghintong punto ng guidance sa shape stage, na ipinapahayag bilang denoising fraction na hindi mas mababa sa shape_slat_guidance_interval_start.
shape_slat_sampling_stepsopsyonal
Uriinteger
default12
1 – 50
Bilang ng denoising step habang binubuo ang shape.
shape_slat_rescale_topsyonal
Urinumber
default3
1 – 6
Sharpness ng noise schedule habang binubuo ang shape.
tex_slat_guidance_strengthopsyonal
Urinumber
default1
0 – 10
Lakas ng classifier-free guidance habang binubuo ang texture.
tex_slat_guidance_rescaleopsyonal
Urinumber
default0
0 – 1
Rescaling na inilalapat sa guidance habang binubuo ang texture; taasan ito kapag mukhang maingay ang mga texture.
tex_slat_guidance_interval_startopsyonal
Urinumber
default0.6
0 – 1
Fraction ng denoising kung kailan nagsisimula ang guidance sa texture stage.
tex_slat_guidance_interval_endopsyonal
Urinumber
default0.9
0 – 1
Paghintong punto ng guidance sa texture stage, na ipinapahayag bilang denoising fraction na hindi mas mababa sa tex_slat_guidance_interval_start.
tex_slat_sampling_stepsopsyonal
Uriinteger
default12
1 – 50
Bilang ng denoising step habang binubuo ang texture.
tex_slat_rescale_topsyonal
Urinumber
default3
1 – 6
Sharpness ng noise schedule habang binubuo ang texture.
decimation_targetopsyonal
Uriinteger
default500000
5,000 – 2,000,000
Ninanais na bilang ng vertex sa GLB export.
texture_sizeopsyonal
Urienum
default2048
102420484096
Resolution ng mga texture na naka-bake sa GLB export.
enable_safety_checkeropsyonal
Uriboolean
defaulttrue
Maaaring luwagan ang screening sa pamamagitan ng pagtatakda ng false, kung awtorisado ang tumatawag.
kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga file

Output

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"
  }
}
Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.
Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.
Mga field ng output
model_glb
object {url, content_type, file_name, file_size}GLB file na naglalaman ng nabuong 3D modelo.
seed
integerSeed na inilapat habang bumubuo.
resolution
integerResolution kung saan isinagawa ang pagbuo.
sparse_structure_lora_url
string | nullSparse-structure LoRA checkpoint na ginamit habang binubuo, kung mayroon.
geometry_lora_url
string | nullGeometry LoRA checkpoint na ginamit habang binubuo, kung mayroon.
texture_lora_url
string | nullTexture LoRA checkpoint na ginamit habang binubuo, kung mayroon.
decimation_target
integerTarget na bilang ng vertex na inilapat sa GLB export.
texture_size
integerResolution ng mga texture na naka-bake sa GLB export.

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/trellis-2-lora.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt