Siirry sisältöön

Trellis 2

Integroi

Mallin tunniste trellis-2
# 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?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"

Tämä pyyntö: 0,30 $ 300 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Microsoft Kuvasta 3D:ksi #image-to-3d

Muuntaa yhden kuvan teksturoiduksi GLB 3D -verkoksi, jonka rakenne-, muoto-, tekstuuri- ja UV-asetuksia voi säätää

Microsoft · 3D

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen image_url
Pudota tiedosto tai

3D-muunnoksen lähdekuvaan osoittava URL-osoite.

resolution oletus 1024

Tulosteen resoluutio; sen kasvattaminen lisää yksityiskohtia mutta pidentää käsittelyä.

Lisäasetukset texture_size · 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 · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh
texture_size oletus 2048

Verkon tekstuurin leivonnassa käytettävä resoluutio. Resoluutioasetuksen kasvattaminen tuottaa hienompia pintayksityiskohtia mutta suurempia tiedostoja.

oletus 7.5

Alkuperäisen 3D-rakenteen uskollisuuden säätö: suurempi arvo suosii tarkempaa vastaavuutta syötekuvan kanssa, mutta voi lisätä kohinaa.

oletus 0.7

Vaiheen 1 ohjausartefaktien säätö: pienet arvot korostavat ohjauksen vaikutuksia ja suuret arvot tuottavat vakaamman tulosteen.

oletus 0.6

Classifier-free guidance -ikkunan aloitusraja vaiheen 1 (harva rakenne) aikana, ilmaistuna kohinanpoiston osuutena. Pienemmät asetukset aloittavat ohjauksen aiemmin; vain väli interval_start–interval_end käyttää ohjausta, muualla käsittely on ohjaamatonta.

oletus 1

Vaiheen 1 (harva rakenne) ohjauksen katkaisukohta: valitse vähintään arvo ss_guidance_interval_start. Arvo ilmaisee kohinanpoiston osuuden, jossa classifier-free guidance päättyy.

oletus 12

Alkurakenteen kohinanpoistovaiheiden määrä: lisävaiheiden mahdolliset laatuhyödyt hidastavat käsittelyä.

oletus 5

Aseta siirtymän terävyys rakenteen generoinnin kohina-aikataululla: arvon kasvattaminen tekee siirtymistä terävämpiä.

oletus 7.5

Yksityiskohtaisen geometrian uskollisuuden säätö: suurempi vastaavuus syötekuvan kanssa lisää yksityiskohtia, mutta voi lisätä kohinaa.

oletus 0.5

Kasvata tätä asetusta, kun geometria näyttää kohinaiselta: se vähentää muotovaiheen voimakkaan ohjauksen aiheuttamia artefakteja.

oletus 0.6

Classifier-free guidance -ohjauksen aloituskohta muodon tarkennuksessa vaiheessa 2. Kohinanpoiston etenemisen osuutena ilmaistuna se määrittää interval_start-arvon; ohjaus toimii vain interval_start- ja interval_end-arvojen rajaamassa ikkunassa.

oletus 1

Vaiheen 2 (muodon tarkennus) ohjauksen katkaisukohta: valitse vähintään arvo shape_slat_guidance_interval_start. Arvo ilmaisee kohinanpoiston osuuden, jossa classifier-free guidance päättyy.

oletus 12

Muodon hienosäädön kohinanpoistovaiheiden määrä: lisävaiheet voivat tasoittaa geometriaa, mutta hidastavat käsittelyä.

oletus 3

Aseta geometrisen yksityiskohdan terävyys muodon hienosäädön kohina-aikataululla; arvon kasvattaminen tuottaa terävämpiä yksityiskohtia.

oletus 1

Tekstuurin värien uskollisuuden säätö: suurempi vastaavuus syötekuvan väreihin lisää eloisuutta, mutta voi aiheuttaa ylikylläisyyttä.

oletus 0

Kasvata tätä asetusta kohinaisten tekstuurien tai värijuovien korjaamiseksi: se vähentää tekstuurivaiheen voimakkaan ohjauksen aiheuttamia artefakteja.

oletus 0.6

Classifier-free guidance -ohjauksen aloituskohta tekstuurin generoinnissa vaiheessa 3. Kohinanpoiston etenemisen osuutena ilmaistuna se määrittää interval_start-arvon; ohjaus toimii vain interval_start- ja interval_end-arvojen rajaamassa ikkunassa.

oletus 0.9

Vaiheen 3 (tekstuurin) ohjauksen katkaisukohta: valitse vähintään arvo tex_slat_guidance_interval_start. Arvo ilmaisee kohinanpoiston osuuden, jossa classifier-free guidance päättyy.

oletus 12

Tekstuurien generointiin käytettävien kohinanpoistovaiheiden määrä. Määrän kasvattaminen pidentää käsittelyä, mutta voi tuottaa puhtaampia tekstuureja.

oletus 3

Aseta tekstuurin yksityiskohtien terävyys tekstuurien generoinnin kohina-aikataululla; arvon kasvattaminen tuottaa terävämpiä yksityiskohtia.

oletus 500000

Verkon kärkipisteiden tavoitemäärä: yleiskäyttöön suositellaan 500k ja verkkoon/mobiiliin 20k–50k. Tavoitteen pienentäminen vaihtaa verkkoyksityiskohtia pienempiin tiedostoihin.

oletus 1

Uudelleenverkotuksen liikevara: suurempi arvo voi lisätä tasoitusta hienojen yksityiskohtien kustannuksella. Asetus rajoittaa kärkipisteiden siirtymää alkuperäiseen pintaan nähden.

oletus 0

Uudelleenverkotettujen kärkipisteiden alkuperäiseen pintaan palauttavan projektion voimakkuus: 1 säilyttää yksityiskohdat täydellä projektiolla, kun taas 0 poistaa projektion käytöstä ja tuottaa tasaisemman tuloksen.

oletus 90

UV-kaavion kulmaraja asteina, joka rajoittaa vierekkäisten pintanormaalien eroa yhdessä kaaviossa. Suurempi raja suosii harvempia ja suurempia kaavioita venymisen riskillä; pienempi raja suosii useampia kaavioita ja vähäisempää vääristymää.

oletus 0

UV-kaavioiden laskemiseen käytettävien paikallisten tarkennuspassien määrä.

oletus 1

UV-kaavioiden tasapainoa voi parantaa lisäämällä kaavioiden laskemiseen käytettävien globaalien klusterointipassien määrää.

oletus 1

Säädä UV-kaavion reunojen tasoituksen voimakkuutta; suurempien asetusten vähemmän näkyviin saumoihin liittyy UV-vääristymän riski.

Toistettavaan satunnaisgenerointiin käytetty siemen.

POST /run/trellis-2?wait=20 hinta → 0,30 $
# 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?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"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Trellis 2

Rakentaa 3D-objektin yhdestä kuvasta (`image_url`) ja palauttaa GLB-tiedoston. `resolution` on 512, 1024 tai 1536, ja `texture_size` on 1024, 2048 tai 4096. Jokaisella kolmesta vaiheesta (rakenne, muoto, tekstuuri) on omat ohjaus- ja näytteenottoaskelmäärityksensä. `decimation_target` määrittää verkon kärkipisteiden määrän (5,000–2,000,000), ja käytettävissä ovat myös uudelleenverkotus- ja UV-purkuasetukset.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
seedvalinnainen
Tyyppiinteger | null
Toistettavaan satunnaisgenerointiin käytetty siemen.
resolutionvalinnainen
Tyyppienum
Oletus1024
51210241536
Tulosteen resoluutio; sen kasvattaminen lisää yksityiskohtia mutta pidentää käsittelyä.
ss_guidance_strengthvalinnainen
Tyyppinumber
Oletus7.5
0 – 10
Alkuperäisen 3D-rakenteen uskollisuuden säätö: suurempi arvo suosii tarkempaa vastaavuutta syötekuvan kanssa, mutta voi lisätä kohinaa.
ss_guidance_rescalevalinnainen
Tyyppinumber
Oletus0.7
0 – 1
Vaiheen 1 ohjausartefaktien säätö: pienet arvot korostavat ohjauksen vaikutuksia ja suuret arvot tuottavat vakaamman tulosteen.
ss_guidance_interval_startvalinnainen
Tyyppinumber
Oletus0.6
0 – 1
Classifier-free guidance -ikkunan aloitusraja vaiheen 1 (harva rakenne) aikana, ilmaistuna kohinanpoiston osuutena. Pienemmät asetukset aloittavat ohjauksen aiemmin; vain väli interval_start–interval_end käyttää ohjausta, muualla käsittely on ohjaamatonta.
ss_guidance_interval_endvalinnainen
Tyyppinumber
Oletus1
0 – 1
Vaiheen 1 (harva rakenne) ohjauksen katkaisukohta: valitse vähintään arvo ss_guidance_interval_start. Arvo ilmaisee kohinanpoiston osuuden, jossa classifier-free guidance päättyy.
ss_sampling_stepsvalinnainen
Tyyppiinteger
Oletus12
1 – 50
Alkurakenteen kohinanpoistovaiheiden määrä: lisävaiheiden mahdolliset laatuhyödyt hidastavat käsittelyä.
ss_rescale_tvalinnainen
Tyyppinumber
Oletus5
1 – 6
Aseta siirtymän terävyys rakenteen generoinnin kohina-aikataululla: arvon kasvattaminen tekee siirtymistä terävämpiä.
shape_slat_guidance_strengthvalinnainen
Tyyppinumber
Oletus7.5
0 – 10
Yksityiskohtaisen geometrian uskollisuuden säätö: suurempi vastaavuus syötekuvan kanssa lisää yksityiskohtia, mutta voi lisätä kohinaa.
shape_slat_guidance_rescalevalinnainen
Tyyppinumber
Oletus0.5
0 – 1
Kasvata tätä asetusta, kun geometria näyttää kohinaiselta: se vähentää muotovaiheen voimakkaan ohjauksen aiheuttamia artefakteja.
shape_slat_guidance_interval_startvalinnainen
Tyyppinumber
Oletus0.6
0 – 1
Classifier-free guidance -ohjauksen aloituskohta muodon tarkennuksessa vaiheessa 2. Kohinanpoiston etenemisen osuutena ilmaistuna se määrittää interval_start-arvon; ohjaus toimii vain interval_start- ja interval_end-arvojen rajaamassa ikkunassa.
shape_slat_guidance_interval_endvalinnainen
Tyyppinumber
Oletus1
0 – 1
Vaiheen 2 (muodon tarkennus) ohjauksen katkaisukohta: valitse vähintään arvo shape_slat_guidance_interval_start. Arvo ilmaisee kohinanpoiston osuuden, jossa classifier-free guidance päättyy.
shape_slat_sampling_stepsvalinnainen
Tyyppiinteger
Oletus12
1 – 50
Muodon hienosäädön kohinanpoistovaiheiden määrä: lisävaiheet voivat tasoittaa geometriaa, mutta hidastavat käsittelyä.
shape_slat_rescale_tvalinnainen
Tyyppinumber
Oletus3
1 – 6
Aseta geometrisen yksityiskohdan terävyys muodon hienosäädön kohina-aikataululla; arvon kasvattaminen tuottaa terävämpiä yksityiskohtia.
tex_slat_guidance_strengthvalinnainen
Tyyppinumber
Oletus1
0 – 10
Tekstuurin värien uskollisuuden säätö: suurempi vastaavuus syötekuvan väreihin lisää eloisuutta, mutta voi aiheuttaa ylikylläisyyttä.
tex_slat_guidance_rescalevalinnainen
Tyyppinumber
Oletus0
0 – 1
Kasvata tätä asetusta kohinaisten tekstuurien tai värijuovien korjaamiseksi: se vähentää tekstuurivaiheen voimakkaan ohjauksen aiheuttamia artefakteja.
tex_slat_guidance_interval_startvalinnainen
Tyyppinumber
Oletus0.6
0 – 1
Classifier-free guidance -ohjauksen aloituskohta tekstuurin generoinnissa vaiheessa 3. Kohinanpoiston etenemisen osuutena ilmaistuna se määrittää interval_start-arvon; ohjaus toimii vain interval_start- ja interval_end-arvojen rajaamassa ikkunassa.
tex_slat_guidance_interval_endvalinnainen
Tyyppinumber
Oletus0.9
0 – 1
Vaiheen 3 (tekstuurin) ohjauksen katkaisukohta: valitse vähintään arvo tex_slat_guidance_interval_start. Arvo ilmaisee kohinanpoiston osuuden, jossa classifier-free guidance päättyy.
tex_slat_sampling_stepsvalinnainen
Tyyppiinteger
Oletus12
1 – 50
Tekstuurien generointiin käytettävien kohinanpoistovaiheiden määrä. Määrän kasvattaminen pidentää käsittelyä, mutta voi tuottaa puhtaampia tekstuureja.
tex_slat_rescale_tvalinnainen
Tyyppinumber
Oletus3
1 – 6
Aseta tekstuurin yksityiskohtien terävyys tekstuurien generoinnin kohina-aikataululla; arvon kasvattaminen tuottaa terävämpiä yksityiskohtia.
decimation_targetvalinnainen
Tyyppiinteger
Oletus500000
5 000 – 2 000 000
Verkon kärkipisteiden tavoitemäärä: yleiskäyttöön suositellaan 500k ja verkkoon/mobiiliin 20k–50k. Tavoitteen pienentäminen vaihtaa verkkoyksityiskohtia pienempiin tiedostoihin.
texture_sizevalinnainen
Tyyppienum
Oletus2048
102420484096
Verkon tekstuurin leivonnassa käytettävä resoluutio. Resoluutioasetuksen kasvattaminen tuottaa hienompia pintayksityiskohtia mutta suurempia tiedostoja.
remeshvalinnainen
Tyyppiboolean
Oletustrue
Topologian uudelleenrakennus tuottaa siistimpiä verkon kolmioita ja yleensä parantaa soveltuvuutta myöhempiin käyttötarkoituksiin, kuten animaatioon tai 3D-tulostukseen, mutta hidastaa käsittelyä.
remesh_bandvalinnainen
Tyyppinumber
Oletus1
0 – 4
Uudelleenverkotuksen liikevara: suurempi arvo voi lisätä tasoitusta hienojen yksityiskohtien kustannuksella. Asetus rajoittaa kärkipisteiden siirtymää alkuperäiseen pintaan nähden.
remesh_projectvalinnainen
Tyyppinumber
Oletus0
0 – 1
Uudelleenverkotettujen kärkipisteiden alkuperäiseen pintaan palauttavan projektion voimakkuus: 1 säilyttää yksityiskohdat täydellä projektiolla, kun taas 0 poistaa projektion käytöstä ja tuottaa tasaisemman tuloksen.
uv_unwrap_angle_threshold_degvalinnainen
Tyyppinumber
Oletus90
0 – 180
UV-kaavion kulmaraja asteina, joka rajoittaa vierekkäisten pintanormaalien eroa yhdessä kaaviossa. Suurempi raja suosii harvempia ja suurempia kaavioita venymisen riskillä; pienempi raja suosii useampia kaavioita ja vähäisempää vääristymää.
uv_unwrap_refine_iterationsvalinnainen
Tyyppiinteger
Oletus0
0 – 10
UV-kaavioiden laskemiseen käytettävien paikallisten tarkennuspassien määrä.
uv_unwrap_global_iterationsvalinnainen
Tyyppiinteger
Oletus1
1 – 10
UV-kaavioiden tasapainoa voi parantaa lisäämällä kaavioiden laskemiseen käytettävien globaalien klusterointipassien määrää.
uv_unwrap_smooth_strengthvalinnainen
Tyyppinumber
Oletus1
0 – 10
Säädä UV-kaavion reunojen tasoituksen voimakkuutta; suurempien asetusten vähemmän näkyviin saumoihin liittyy UV-vääristymän riski.
image_urlpakollinen image
Tyyppiurl · image
3D-muunnoksen lähdekuvaan osoittava URL-osoite.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    }
  },
  "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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
model_glb
object {url, content_type, file_name, file_size}GLB-muodossa generoitu 3D-malli.

Lisää malleja: Kuvasta 3D:ksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/trellis-2.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt