Op den Inhalt sprangen

TRELLIS.2 LoRA Inference

Integréieren

Modell-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"

Dës Ufro: 0,25 $ 250 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
Microsoft Bild zu 3D

Trellis 2 Image-zu-3D, deen personaliséiert LoRA-Adapter fir Struktur, Geometrie an Textur applizéiere kann

Microsoft · 3D

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch image_url
Fichier erofzéien, oder

URL vum Quellbild fir d'Konversioun an en 3D-Modell.

resolution Standard 512

Generatiounsopléisung; 1024 wielt d'Cascade-Pipeline. Wielt d'Opléisung, mat där déi geliwwert LoRA-Adapter trainéiert goufen; eng Iwwereneestëmmung ass erfuerderlech.

Erweidert 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

Optionalen LoRA-Checkpoint am safetensors-Format, speziell fir den Textur-Denoiser trainéiert.

texture_size Standard 2048

Opléisung vun den Texturen, déi an den GLB-Export gebak ginn.

Optionalen LoRA-Checkpoint am safetensors-Format, speziell fir den Denoiser vun der sparse Struktur trainéiert.

Optionalen LoRA-Checkpoint am safetensors-Format, speziell fir de Geometrie-Denoiser trainéiert.

Standard 7.5

Stäerkt vun der classifier-free Guidance bei der Generatioun vun der sparse Struktur.

Standard 0.7

Reskaléierung vun der Guidance bei der Generatioun vun der sparse Struktur. Méi grouss Wäerter maachen den Output méi stabil.

Standard 0.6

Fraktioun vum Denoising-Fortschrëtt, bei där d'Guidance vun der sparse Struktur ufänkt.

Standard 1

Benotzt eng Denoising-Fraktioun op oder iwwer `ss_guidance_interval_start`, fir unzeginn, wéini d'Guidance vun der sparse Struktur ophält.

Standard 12

Zuel vun den Denoising-Schrëtt bei der Generatioun vun der sparse Struktur.

Standard 5

Schäerft vum Geräischplang bei der Generatioun vun der sparse Struktur.

Standard 7.5

Stäerkt vun der classifier-free Guidance bei der Formgeneratioun.

Standard 0.5

Reskaléierung vun der Guidance bei der Formgeneratioun; erhéicht se, wann d'Geometrie geräischend erschéngt.

Standard 0.6

Fraktioun vum Denoising, bei där d'Guidance vun der Formetapp ufänkt.

Standard 1

Stoppunkt vun der Guidance an der Formetapp, als Denoising-Fraktioun, déi net méi kleng wéi shape_slat_guidance_interval_start ass.

Standard 12

Zuel vun den Denoising-Schrëtt bei der Formgeneratioun.

Standard 3

Schäerft vum Geräischplang bei der Formgeneratioun.

Standard 1

Stäerkt vun der classifier-free Guidance bei der Texturgeneratioun.

Standard 0

Reskaléierung vun der Guidance bei der Texturgeneratioun; erhéicht se, wann d'Texturen geräischend erschéngen.

Standard 0.6

Fraktioun vum Denoising, bei där d'Guidance vun der Texturetap ufänkt.

Standard 0.9

Stoppunkt vun der Guidance an der Texturetap, als Denoising-Fraktioun, déi net méi kleng wéi tex_slat_guidance_interval_start ass.

Standard 12

Zuel vun den Denoising-Schrëtt bei der Texturgeneratioun.

Standard 3

Schäerft vum Geräischplang bei der Texturgeneratioun.

Standard 500000

Gewënschten Zuel vu Vertexen am GLB-Export.

Zoufällege Seed, deen d'Generatioun reproduzéierbar mécht.

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

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer TRELLIS.2 LoRA Inference

Generéiert eng GLB aus `image_url` a kann optional safetensors-LoRAs iwwer `sparse_structure_lora_url`, `geometry_lora_url` an `texture_lora_url` applizéieren. `resolution` ass 512 oder 1024 a muss mat der Trainingsopléisung vun den Adaptere gläich sinn. Och verfügbar si Guidance- a Schrëtt-Kontrollen pro Etapp, `decimation_target` an `texture_size`.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
image_urlobligatoresch image
Typurl · image
URL vum Quellbild fir d'Konversioun an en 3D-Modell.
sparse_structure_lora_urloptional
Typstring | null
Optionalen LoRA-Checkpoint am safetensors-Format, speziell fir den Denoiser vun der sparse Struktur trainéiert.
geometry_lora_urloptional
Typstring | null
Optionalen LoRA-Checkpoint am safetensors-Format, speziell fir de Geometrie-Denoiser trainéiert.
texture_lora_urloptional
Typstring | null
Optionalen LoRA-Checkpoint am safetensors-Format, speziell fir den Textur-Denoiser trainéiert.
seedoptional
Typinteger | null
Zoufällege Seed, deen d'Generatioun reproduzéierbar mécht.
resolutionoptional
Typenum
Standard512
5121024
Generatiounsopléisung; 1024 wielt d'Cascade-Pipeline. Wielt d'Opléisung, mat där déi geliwwert LoRA-Adapter trainéiert goufen; eng Iwwereneestëmmung ass erfuerderlech.
ss_guidance_strengthoptional
Typnumber
Standard7.5
0 – 10
Stäerkt vun der classifier-free Guidance bei der Generatioun vun der sparse Struktur.
ss_guidance_rescaleoptional
Typnumber
Standard0.7
0 – 1
Reskaléierung vun der Guidance bei der Generatioun vun der sparse Struktur. Méi grouss Wäerter maachen den Output méi stabil.
ss_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Fraktioun vum Denoising-Fortschrëtt, bei där d'Guidance vun der sparse Struktur ufänkt.
ss_guidance_interval_endoptional
Typnumber
Standard1
0 – 1
Benotzt eng Denoising-Fraktioun op oder iwwer `ss_guidance_interval_start`, fir unzeginn, wéini d'Guidance vun der sparse Struktur ophält.
ss_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Zuel vun den Denoising-Schrëtt bei der Generatioun vun der sparse Struktur.
ss_rescale_toptional
Typnumber
Standard5
1 – 6
Schäerft vum Geräischplang bei der Generatioun vun der sparse Struktur.
shape_slat_guidance_strengthoptional
Typnumber
Standard7.5
0 – 10
Stäerkt vun der classifier-free Guidance bei der Formgeneratioun.
shape_slat_guidance_rescaleoptional
Typnumber
Standard0.5
0 – 1
Reskaléierung vun der Guidance bei der Formgeneratioun; erhéicht se, wann d'Geometrie geräischend erschéngt.
shape_slat_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Fraktioun vum Denoising, bei där d'Guidance vun der Formetapp ufänkt.
shape_slat_guidance_interval_endoptional
Typnumber
Standard1
0 – 1
Stoppunkt vun der Guidance an der Formetapp, als Denoising-Fraktioun, déi net méi kleng wéi shape_slat_guidance_interval_start ass.
shape_slat_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Zuel vun den Denoising-Schrëtt bei der Formgeneratioun.
shape_slat_rescale_toptional
Typnumber
Standard3
1 – 6
Schäerft vum Geräischplang bei der Formgeneratioun.
tex_slat_guidance_strengthoptional
Typnumber
Standard1
0 – 10
Stäerkt vun der classifier-free Guidance bei der Texturgeneratioun.
tex_slat_guidance_rescaleoptional
Typnumber
Standard0
0 – 1
Reskaléierung vun der Guidance bei der Texturgeneratioun; erhéicht se, wann d'Texturen geräischend erschéngen.
tex_slat_guidance_interval_startoptional
Typnumber
Standard0.6
0 – 1
Fraktioun vum Denoising, bei där d'Guidance vun der Texturetap ufänkt.
tex_slat_guidance_interval_endoptional
Typnumber
Standard0.9
0 – 1
Stoppunkt vun der Guidance an der Texturetap, als Denoising-Fraktioun, déi net méi kleng wéi tex_slat_guidance_interval_start ass.
tex_slat_sampling_stepsoptional
Typinteger
Standard12
1 – 50
Zuel vun den Denoising-Schrëtt bei der Texturgeneratioun.
tex_slat_rescale_toptional
Typnumber
Standard3
1 – 6
Schäerft vum Geräischplang bei der Texturgeneratioun.
decimation_targetoptional
Typinteger
Standard500000
5.000 – 2.000.000
Gewënschten Zuel vu Vertexen am GLB-Export.
texture_sizeoptional
Typenum
Standard2048
102420484096
Opléisung vun den Texturen, déi an den GLB-Export gebak ginn.
enable_safety_checkeroptional
Typboolean
Standardtrue
D'Kontroll kann duerch false gelackert ginn, wann den Uruffer autoriséiert ass.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
model_glb
object {url, content_type, file_name, file_size}GLB-Datei mat dem generéierten 3D-Modell.
seed
integerSeed, deen an der Generatioun benotzt gëtt.
resolution
integerOpléisung, bei där d'Generatioun duerchgefouert gouf.
sparse_structure_lora_url
string | nullLoRA-Checkpoint vun der sparse Struktur, dee bei der Generatioun benotzt gouf, wann een applizéiert gouf.
geometry_lora_url
string | nullGeometrie-LoRA-Checkpoint, dee bei der Generatioun benotzt gouf, wann een applizéiert gouf.
texture_lora_url
string | nullTextur-LoRA-Checkpoint, dee bei der Generatioun benotzt gouf, wann een applizéiert gouf.
decimation_target
integerVertex-Zilzuel, déi op den GLB-Export applizéiert gouf.
texture_size
integerOpléisung vun den Texturen, déi an den GLB-Export gebak ginn.

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/trellis-2-lora.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt