Preskoči na vsebino

TRELLIS.2 LoRA Inference

Integracija

ID modela 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"

Ta zahteva: 0,25 $ 250 API kreditov Zaženi na tej strani

Pridobi ključ API
Microsoft Slika v 3D

Pretvorba slike v 3D z Trellis 2, ki lahko uporabi prilagojene adapterje LoRA za strukturo, geometrijo in teksturo

Microsoft · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno image_url
Spustite datoteko ali

URL izvorne slike za pretvorbo v 3D-model.

resolution privzeto 512

Ločljivost generiranja, pri kateri 1024 izbere cevovod cascade. Izberite ločljivost, uporabljeno za učenje priloženih prilagoditev LoRA; ujemanje je obvezno.

Napredno 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

Izbirna kontrolna točka LoRA v obliki safetensors, posebej naučena za odstranjevalnik šuma teksture.

texture_size privzeto 2048

Ločljivost tekstur, vgrajenih v izvoz GLB.

Izbirna kontrolna točka LoRA v obliki safetensors, posebej naučena za odstranjevalnik šuma redke strukture.

Izbirna kontrolna točka LoRA v obliki safetensors, posebej naučena za odstranjevalnik šuma geometrije.

privzeto 7.5

Moč classifier-free guidance med generiranjem redke strukture.

privzeto 0.7

Prilagajanje usmerjanja med generiranjem redke strukture. Večje vrednosti naredijo izhod stabilnejši.

privzeto 0.6

Delež napredka odstranjevanja šuma, pri katerem se začne usmerjanje redke strukture.

privzeto 1

Uporabite delež odstranjevanja šuma, ki je enak ali večji od `ss_guidance_interval_start`, da določite, kdaj se usmerjanje redke strukture konča.

privzeto 12

Število korakov odstranjevanja šuma pri generiranju redke strukture.

privzeto 5

Ostrina razporeda šuma pri generiranju redke strukture.

privzeto 7.5

Moč classifier-free guidance pri generiranju oblike.

privzeto 0.5

Prilagoditev usmerjanja pri generiranju oblike; povečajte jo, če je geometrija videti šumna.

privzeto 0.6

Delež odstranjevanja šuma, pri katerem se začne usmerjanje stopnje oblike.

privzeto 1

Točka ustavitve usmerjanja stopnje oblike, izražena kot delež odstranjevanja šuma, ki ni manjši od shape_slat_guidance_interval_start.

privzeto 12

Število korakov odstranjevanja šuma pri generiranju oblike.

privzeto 3

Ostrina razporeda šuma pri generiranju oblike.

privzeto 1

Moč classifier-free guidance pri generiranju teksture.

privzeto 0

Prilagoditev usmerjanja pri generiranju teksture; povečajte jo, če je tekstura videti šumna.

privzeto 0.6

Delež odstranjevanja šuma, pri katerem se začne usmerjanje stopnje teksture.

privzeto 0.9

Točka ustavitve usmerjanja stopnje teksture, izražena kot delež odstranjevanja šuma, ki ni manjši od tex_slat_guidance_interval_start.

privzeto 12

Število korakov odstranjevanja šuma pri generiranju teksture.

privzeto 3

Ostrina razporeda šuma pri generiranju teksture.

privzeto 500000

Želeno število oglišč v izvozu GLB.

Naključni seed, ki omogoča ponovljivo generiranje.

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

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu TRELLIS.2 LoRA Inference

Ustvari GLB iz `image_url` in po želji uporabi LoRA-je safetensors prek `sparse_structure_lora_url`, `geometry_lora_url` in `texture_lora_url`. `resolution` je 512 ali 1024 in se mora ujemati z ločljivostjo učenja adapterjev. Na voljo so tudi nastavitve vodenja in korakov za posamezne stopnje, `decimation_target` in `texture_size`.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlobvezno image
Vrstaurl · image
URL izvorne slike za pretvorbo v 3D-model.
sparse_structure_lora_urlneobvezno
Vrstastring | null
Izbirna kontrolna točka LoRA v obliki safetensors, posebej naučena za odstranjevalnik šuma redke strukture.
geometry_lora_urlneobvezno
Vrstastring | null
Izbirna kontrolna točka LoRA v obliki safetensors, posebej naučena za odstranjevalnik šuma geometrije.
texture_lora_urlneobvezno
Vrstastring | null
Izbirna kontrolna točka LoRA v obliki safetensors, posebej naučena za odstranjevalnik šuma teksture.
seedneobvezno
Vrstainteger | null
Naključni seed, ki omogoča ponovljivo generiranje.
resolutionneobvezno
Vrstaenum
Privzeto512
5121024
Ločljivost generiranja, pri kateri 1024 izbere cevovod cascade. Izberite ločljivost, uporabljeno za učenje priloženih prilagoditev LoRA; ujemanje je obvezno.
ss_guidance_strengthneobvezno
Vrstanumber
Privzeto7.5
0 – 10
Moč classifier-free guidance med generiranjem redke strukture.
ss_guidance_rescaleneobvezno
Vrstanumber
Privzeto0.7
0 – 1
Prilagajanje usmerjanja med generiranjem redke strukture. Večje vrednosti naredijo izhod stabilnejši.
ss_guidance_interval_startneobvezno
Vrstanumber
Privzeto0.6
0 – 1
Delež napredka odstranjevanja šuma, pri katerem se začne usmerjanje redke strukture.
ss_guidance_interval_endneobvezno
Vrstanumber
Privzeto1
0 – 1
Uporabite delež odstranjevanja šuma, ki je enak ali večji od `ss_guidance_interval_start`, da določite, kdaj se usmerjanje redke strukture konča.
ss_sampling_stepsneobvezno
Vrstainteger
Privzeto12
1 – 50
Število korakov odstranjevanja šuma pri generiranju redke strukture.
ss_rescale_tneobvezno
Vrstanumber
Privzeto5
1 – 6
Ostrina razporeda šuma pri generiranju redke strukture.
shape_slat_guidance_strengthneobvezno
Vrstanumber
Privzeto7.5
0 – 10
Moč classifier-free guidance pri generiranju oblike.
shape_slat_guidance_rescaleneobvezno
Vrstanumber
Privzeto0.5
0 – 1
Prilagoditev usmerjanja pri generiranju oblike; povečajte jo, če je geometrija videti šumna.
shape_slat_guidance_interval_startneobvezno
Vrstanumber
Privzeto0.6
0 – 1
Delež odstranjevanja šuma, pri katerem se začne usmerjanje stopnje oblike.
shape_slat_guidance_interval_endneobvezno
Vrstanumber
Privzeto1
0 – 1
Točka ustavitve usmerjanja stopnje oblike, izražena kot delež odstranjevanja šuma, ki ni manjši od shape_slat_guidance_interval_start.
shape_slat_sampling_stepsneobvezno
Vrstainteger
Privzeto12
1 – 50
Število korakov odstranjevanja šuma pri generiranju oblike.
shape_slat_rescale_tneobvezno
Vrstanumber
Privzeto3
1 – 6
Ostrina razporeda šuma pri generiranju oblike.
tex_slat_guidance_strengthneobvezno
Vrstanumber
Privzeto1
0 – 10
Moč classifier-free guidance pri generiranju teksture.
tex_slat_guidance_rescaleneobvezno
Vrstanumber
Privzeto0
0 – 1
Prilagoditev usmerjanja pri generiranju teksture; povečajte jo, če je tekstura videti šumna.
tex_slat_guidance_interval_startneobvezno
Vrstanumber
Privzeto0.6
0 – 1
Delež odstranjevanja šuma, pri katerem se začne usmerjanje stopnje teksture.
tex_slat_guidance_interval_endneobvezno
Vrstanumber
Privzeto0.9
0 – 1
Točka ustavitve usmerjanja stopnje teksture, izražena kot delež odstranjevanja šuma, ki ni manjši od tex_slat_guidance_interval_start.
tex_slat_sampling_stepsneobvezno
Vrstainteger
Privzeto12
1 – 50
Število korakov odstranjevanja šuma pri generiranju teksture.
tex_slat_rescale_tneobvezno
Vrstanumber
Privzeto3
1 – 6
Ostrina razporeda šuma pri generiranju teksture.
decimation_targetneobvezno
Vrstainteger
Privzeto500000
5000 – 2.000.000
Želeno število oglišč v izvozu GLB.
texture_sizeneobvezno
Vrstaenum
Privzeto2048
102420484096
Ločljivost tekstur, vgrajenih v izvoz GLB.
enable_safety_checkerneobvezno
Vrstaboolean
Privzetotrue
Preverjanje je mogoče omiliti z nastavitvijo false, če je klicatelj pooblaščen.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
model_glb
object {url, content_type, file_name, file_size}Datoteka GLB z ustvarjenim 3D-modelom.
seed
integerSeed, uporabljen med generiranjem.
resolution
integerLočljivost, pri kateri je potekalo generiranje.
sparse_structure_lora_url
string | nullKontrolna točka LoRA redke strukture, uporabljena pri generiranju, če je bila uporabljena.
geometry_lora_url
string | nullKontrolna točka LoRA geometrije, uporabljena pri generiranju, če je bila uporabljena.
texture_lora_url
string | nullKontrolna točka LoRA teksture, uporabljena pri generiranju, če je bila uporabljena.
decimation_target
integerCiljno število oglišč, uporabljeno za izvoz GLB.
texture_size
integerLočljivost tekstur, vgrajenih v izvoz GLB.

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/trellis-2-lora.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt