Saltar al cuntegna

TRELLIS.2 LoRA Inference

Integrar

ID dal model 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"

Questa dumonda: $0,25 250 credits API Lantschar sin questa pagina

Obtegna ina clav API
Microsoft Maletg a 3D

Trellis 2 da maletg a 3D che po applitgar adaptaders LoRA persunalisads per structura, geometria e textur

Microsoft · 3D

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori image_url
Trametta in datoteca u

URL dal maletg da funtauna per la conversiun en in model 3D.

resolution standard 512

Resoluziun da generaziun, cun 1024 che tscherna la pipeline cascade. Tscherna la resoluziun utilisada per trenar ils adapters LoRA furnids; ina correspundenza è necessaria.

Avanzà 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

Checkpoint LoRA opziunal en format safetensors, trenà spezialmain per il denoiser da la textura.

texture_size standard 2048

Resoluziun da las texturas incrustadas en l'export GLB.

Checkpoint LoRA opziunal en format safetensors, trenà spezialmain per il denoiser da la structura sparsa.

Checkpoint LoRA opziunal en format safetensors, trenà spezialmain per il denoiser da la geometria.

standard 7.5

Forza da la guidance senza classificader durant la generaziun da la structura sparsa.

standard 0.7

Rescaling da la guidance durant la generaziun da la structura sparsa. Valurs pli grondas rendan l'output pli stabil.

standard 0.6

Fracziun dal progress da reducziun dal ramur nua che la guidance da la structura sparsa cumenza.

standard 1

Utilisescha ina fracziun da reducziun dal ramur almain eguala a `ss_guidance_interval_start` per inditgar cura che la guidance da la structura sparsa sa ferma.

standard 12

Dumber da pass da reducziun dal ramur durant la generaziun da la structura sparsa.

standard 5

Nettezza dal plan da ramur durant la generaziun da la structura sparsa.

standard 7.5

Forza da la guidance senza classificader durant la generaziun da la furma.

standard 0.5

Rescaling applitgà a la guidance durant la generaziun da la furma; augmenta ella sche la geometria para ramurusa.

standard 0.6

Fracziun da reducziun dal ramur nua che la guidance da la fasa da la furma cumenza.

standard 1

Punct da fermada da la guidance da la fasa da la furma, exprimì sco fracziun da reducziun dal ramur betg pli pitschna che shape_slat_guidance_interval_start.

standard 12

Dumber da pass da reducziun dal ramur durant la generaziun da la furma.

standard 3

Nettezza dal plan da ramur durant la generaziun da la furma.

standard 1

Forza da la guidance senza classificader durant la generaziun da la textura.

standard 0

Rescaling applitgà a la guidance durant la generaziun da la textura; augmenta ella sche las texturas paran ramurusas.

standard 0.6

Fracziun da reducziun dal ramur nua che la guidance da la fasa da la textura cumenza.

standard 0.9

Punct da fermada da la guidance da la fasa da la textura, exprimì sco fracziun da reducziun dal ramur betg pli pitschna che tex_slat_guidance_interval_start.

standard 12

Dumber da pass da reducziun dal ramur durant la generaziun da la textura.

standard 3

Nettezza dal plan da ramur durant la generaziun da la textura.

standard 500000

Dumber giavischà da vertizels en l'export GLB.

Semenza casuala che renda la generaziun reproducibla.

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

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart TRELLIS.2 LoRA Inference

Generescha in GLB da `image_url` e po applitgar LoRAs safetensors via `sparse_structure_lora_url`, `geometry_lora_url` e `texture_lora_url`. `resolution` è 512 u 1024 e sto correspunder a la resoluziun d'entrenament dals adaptaders. Disponibels èn er controlls per guidance e pass per staziun, `decimation_target` e `texture_size`.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
image_urlobligatori image
Tipurl · image
URL dal maletg da funtauna per la conversiun en in model 3D.
sparse_structure_lora_urlopziunal
Tipstring | null
Checkpoint LoRA opziunal en format safetensors, trenà spezialmain per il denoiser da la structura sparsa.
geometry_lora_urlopziunal
Tipstring | null
Checkpoint LoRA opziunal en format safetensors, trenà spezialmain per il denoiser da la geometria.
texture_lora_urlopziunal
Tipstring | null
Checkpoint LoRA opziunal en format safetensors, trenà spezialmain per il denoiser da la textura.
seedopziunal
Tipinteger | null
Semenza casuala che renda la generaziun reproducibla.
resolutionopziunal
Tipenum
Standard512
5121024
Resoluziun da generaziun, cun 1024 che tscherna la pipeline cascade. Tscherna la resoluziun utilisada per trenar ils adapters LoRA furnids; ina correspundenza è necessaria.
ss_guidance_strengthopziunal
Tipnumber
Standard7.5
0 – 10
Forza da la guidance senza classificader durant la generaziun da la structura sparsa.
ss_guidance_rescaleopziunal
Tipnumber
Standard0.7
0 – 1
Rescaling da la guidance durant la generaziun da la structura sparsa. Valurs pli grondas rendan l'output pli stabil.
ss_guidance_interval_startopziunal
Tipnumber
Standard0.6
0 – 1
Fracziun dal progress da reducziun dal ramur nua che la guidance da la structura sparsa cumenza.
ss_guidance_interval_endopziunal
Tipnumber
Standard1
0 – 1
Utilisescha ina fracziun da reducziun dal ramur almain eguala a `ss_guidance_interval_start` per inditgar cura che la guidance da la structura sparsa sa ferma.
ss_sampling_stepsopziunal
Tipinteger
Standard12
1 – 50
Dumber da pass da reducziun dal ramur durant la generaziun da la structura sparsa.
ss_rescale_topziunal
Tipnumber
Standard5
1 – 6
Nettezza dal plan da ramur durant la generaziun da la structura sparsa.
shape_slat_guidance_strengthopziunal
Tipnumber
Standard7.5
0 – 10
Forza da la guidance senza classificader durant la generaziun da la furma.
shape_slat_guidance_rescaleopziunal
Tipnumber
Standard0.5
0 – 1
Rescaling applitgà a la guidance durant la generaziun da la furma; augmenta ella sche la geometria para ramurusa.
shape_slat_guidance_interval_startopziunal
Tipnumber
Standard0.6
0 – 1
Fracziun da reducziun dal ramur nua che la guidance da la fasa da la furma cumenza.
shape_slat_guidance_interval_endopziunal
Tipnumber
Standard1
0 – 1
Punct da fermada da la guidance da la fasa da la furma, exprimì sco fracziun da reducziun dal ramur betg pli pitschna che shape_slat_guidance_interval_start.
shape_slat_sampling_stepsopziunal
Tipinteger
Standard12
1 – 50
Dumber da pass da reducziun dal ramur durant la generaziun da la furma.
shape_slat_rescale_topziunal
Tipnumber
Standard3
1 – 6
Nettezza dal plan da ramur durant la generaziun da la furma.
tex_slat_guidance_strengthopziunal
Tipnumber
Standard1
0 – 10
Forza da la guidance senza classificader durant la generaziun da la textura.
tex_slat_guidance_rescaleopziunal
Tipnumber
Standard0
0 – 1
Rescaling applitgà a la guidance durant la generaziun da la textura; augmenta ella sche las texturas paran ramurusas.
tex_slat_guidance_interval_startopziunal
Tipnumber
Standard0.6
0 – 1
Fracziun da reducziun dal ramur nua che la guidance da la fasa da la textura cumenza.
tex_slat_guidance_interval_endopziunal
Tipnumber
Standard0.9
0 – 1
Punct da fermada da la guidance da la fasa da la textura, exprimì sco fracziun da reducziun dal ramur betg pli pitschna che tex_slat_guidance_interval_start.
tex_slat_sampling_stepsopziunal
Tipinteger
Standard12
1 – 50
Dumber da pass da reducziun dal ramur durant la generaziun da la textura.
tex_slat_rescale_topziunal
Tipnumber
Standard3
1 – 6
Nettezza dal plan da ramur durant la generaziun da la textura.
decimation_targetopziunal
Tipinteger
Standard500000
5 000 – 2 000 000
Dumber giavischà da vertizels en l'export GLB.
texture_sizeopziunal
Tipenum
Standard2048
102420484096
Resoluziun da las texturas incrustadas en l'export GLB.
enable_safety_checkeropziunal
Tipboolean
Standardtrue
La controlla po vegnir schluccada cun definir false, premess che l'appelant saja autorisà.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
model_glb
object {url, content_type, file_name, file_size}Datoteca GLB che cuntegna il model 3D generà.
seed
integerSemenza applitgada durant la generaziun.
resolution
integerResoluziun a la quala la generaziun è vegnida exequida.
sparse_structure_lora_url
string | nullCheckpoint LoRA da la structura sparsa utilisà durant la generaziun, sch'in tal è vegnì applitgà.
geometry_lora_url
string | nullCheckpoint LoRA da la geometria utilisà durant la generaziun, sch'in tal è vegnì applitgà.
texture_lora_url
string | nullCheckpoint LoRA da la textura utilisà durant la generaziun, sch'in tal è vegnì applitgà.
decimation_target
integerFinamira dal dumber da vertizels applitgada a l'export GLB.
texture_size
integerResoluziun da las texturas incrustadas en l'export GLB.

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/trellis-2-lora.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt