Prijeđi na sadržaj

Trellis 2

Integriraj

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

Ovaj zahtjev: 0,30 $ 300 API kredita Pokreni na ovoj stranici

Nabavi API ključ
Microsoft Slika u 3D #image-to-3d

Pretvara jednu sliku u teksturiranu GLB 3D mrežu s podesivim postavkama strukture, oblika, teksture i UV-a

Microsoft · 3D

Vaš prvi rezultat bit će ovdje

Izradite zahtjev u nastavku i pokrenite ga svojim API ključem. Izlazi se kopiraju u našu pohranu i čuvaju zauvijek ili 7 dana besplatno.

Izradi zahtjev

Kontrole se generiraju iz sheme modela. Kôd i cijena ažuriraju se dok ih mijenjate.

•obavezno image_url
Ispustite datoteku ili

URL koji upućuje na izvornu sliku za 3D pretvorbu.

resolution zadano 1024

Razlučivost izlaza; povećanjem se dodaju pojedinosti, ali obrada traje dulje.

Napredno 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 zadano 2048

Razlučivost teksture mreže za pečenje. Finije pojedinosti površine stvaraju veće datoteke pri povećanju ove razlučivosti.

zadano 7.5

Kontrola vjernosti početne 3D strukture: povećanjem se daje prednost većem podudaranju s ulaznom slikom, uz rizik dodatnog šuma.

zadano 0.7

Kontrola artefakata usmjeravanja u 1. fazi, koja pri niskim postavkama daje snažnije učinke usmjeravanja, a pri visokima stabilniji izlaz.

zadano 0.6

Početna granica prozora classifier-free guidancea u fazi 1 (rijetka struktura), izražena kao razlomak uklanjanja šuma. Niže postavke ranije pokreću upute; samo interval od interval_start do interval_end koristi upute, a drugdje se obrada odvija bez njih.

zadano 1

Granica uputa za fazu 1 (rijetka struktura): odaberite vrijednost najmanje jednaku ss_guidance_interval_start. Vrijednost označava razlomak uklanjanja šuma pri kojem classifier-free guidance prestaje.

zadano 12

Broj koraka uklanjanja šuma početne strukture: moguća poboljšanja kvalitete dodatnim koracima dolaze uz sporiju obradu.

zadano 5

Postavite oštrinu prijelaza putem rasporeda šuma generiranja strukture: povećanjem ove vrijednosti prijelazi postaju oštriji.

zadano 7.5

Kontrola vjernosti detaljne geometrije: većim pridržavanjem ulazne slike dobivaju se dodatne pojedinosti, uz rizik dodatnog šuma.

zadano 0.5

Povećajte ovu postavku kada geometrija izgleda bučno: time se smanjuju artefakti uzrokovani snažnim usmjeravanjem tijekom faze oblika.

zadano 0.6

Točka aktivacije classifier-free guidancea za pročišćavanje oblika u fazi 2. Izražena kao razlomak napretka uklanjanja šuma, postavlja interval_start; upute djeluju samo unutar prozora omeđenog vrijednostima interval_start i interval_end.

zadano 1

Granica uputa za fazu 2 (pročišćavanje oblika): odaberite vrijednost najmanje jednaku shape_slat_guidance_interval_start. Vrijednost označava razlomak uklanjanja šuma pri kojem classifier-free guidance prestaje.

zadano 12

Broj koraka uklanjanja šuma za poboljšanje oblika: potencijalno glađa geometrija postiže se nauštrb brzine pri upotrebi dodatnih koraka.

zadano 3

Postavite oštrinu geometrijskih pojedinosti putem rasporeda šuma za poboljšanje oblika; povećanjem ove vrijednosti dobivaju se oštrije pojedinosti.

zadano 1

Kontrola vjernosti boje teksture: veće pridržavanje boja ulazne slike pri višim postavkama povećava živost, ali može uzrokovati prezasićenost.

zadano 0

Povećajte ovu postavku da biste riješili bučne teksture ili pojaseve boja: time se smanjuju artefakti uzrokovani snažnim usmjeravanjem tijekom faze teksture.

zadano 0.6

Točka aktivacije classifier-free guidancea za generiranje teksture u fazi 3. Izražena kao razlomak napretka uklanjanja šuma, postavlja interval_start; upute djeluju samo unutar prozora omeđenog vrijednostima interval_start i interval_end.

zadano 0.9

Granica uputa za fazu 3 (tekstura): odaberite vrijednost najmanje jednaku tex_slat_guidance_interval_start. Vrijednost označava razlomak uklanjanja šuma pri kojem classifier-free guidance prestaje.

zadano 12

Broj koraka uklanjanja šuma za generiranje tekstura. Povećanje broja koraka traje dulje, ali može dati čišće teksture.

zadano 3

Postavite oštrinu pojedinosti teksture putem rasporeda šuma za generiranje teksture; povećanjem ove vrijednosti dobivaju se oštrije pojedinosti.

zadano 500000

Ciljani broj vrhova mreže; za opću namjenu preporučuje se 500k, a za web/mobilne uređaje 20k–50k. Smanjenje cilja zamjenjuje detalje mreže manjim datotekama.

zadano 1

Dopuštenje pomicanja pri ponovnom stvaranju mreže: dodatno zaglađivanje može žrtvovati fine detalje kada se vrijednost poveća. Postavka ograničava pomak vrhova u odnosu na izvornu površinu.

zadano 0

Jačina projekcije za vraćanje ponovno stvorenih vrhova na izvornu površinu: 1 čuva detalje potpunom projekcijom, dok 0 isključuje projekciju za glađi rezultat.

zadano 90

Ograničenje kuta UV grafikona u stupnjevima, kojim se ograničava razlika susjednih normala ploha unutar jednog grafikona. Veće ograničenje pogoduje manjem broju većih grafikona uz rizik rastezanja; manje ograničenje pogoduje većem broju grafikona i manjem izobličenju.

zadano 0

Broj lokalnih prolaza pročišćavanja za izračun UV grafikona.

zadano 1

Ravnoteža UV grafikona može se poboljšati povećanjem broja globalnih prolaza grupiranja koji se koriste za njihov izračun.

zadano 1

Prilagodite jačinu zaglađivanja rubova UV grafikona; manje vidljivi spojevi pri višim postavkama nose rizik izobličenja UV-a.

Sjeme koje se upotrebljava za ponovljivo nasumično generiranje.

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

Pokreni ovaj zahtjev

Vaš ključ ostaje u ovom pregledniku: šalje se samo Doitong API-ju i sprema u localStorage samo ako označite Zapamti. Nabavite API ključ

O modelu Trellis 2

Iz jedne slike (`image_url`) izrađuje 3D sredstvo i vraća GLB datoteku. `resolution` je 512, 1024 ili 1536, a `texture_size` 1024, 2048 ili 4096. Svaka od tri faze (struktura, oblik, tekstura) ima vlastite kontrole usmjeravanja i koraka uzorkovanja. `decimation_target` postavlja broj vrhova mreže (5,000 do 2,000,000), a dostupne su i opcije ponovne izrade mreže te UV-odmotavanja.

Parametri

Pošaljite kanonski naziv ili izvorni naziv, ne oba. Kanonski nazivi

NazivVrsta ZadanoDopušteno Opis
seedneobavezno
Vrstainteger | null
Sjeme koje se upotrebljava za ponovljivo nasumično generiranje.
resolutionneobavezno
Vrstaenum
Zadano1024
51210241536
Razlučivost izlaza; povećanjem se dodaju pojedinosti, ali obrada traje dulje.
ss_guidance_strengthneobavezno
Vrstanumber
Zadano7.5
0 – 10
Kontrola vjernosti početne 3D strukture: povećanjem se daje prednost većem podudaranju s ulaznom slikom, uz rizik dodatnog šuma.
ss_guidance_rescaleneobavezno
Vrstanumber
Zadano0.7
0 – 1
Kontrola artefakata usmjeravanja u 1. fazi, koja pri niskim postavkama daje snažnije učinke usmjeravanja, a pri visokima stabilniji izlaz.
ss_guidance_interval_startneobavezno
Vrstanumber
Zadano0.6
0 – 1
Početna granica prozora classifier-free guidancea u fazi 1 (rijetka struktura), izražena kao razlomak uklanjanja šuma. Niže postavke ranije pokreću upute; samo interval od interval_start do interval_end koristi upute, a drugdje se obrada odvija bez njih.
ss_guidance_interval_endneobavezno
Vrstanumber
Zadano1
0 – 1
Granica uputa za fazu 1 (rijetka struktura): odaberite vrijednost najmanje jednaku ss_guidance_interval_start. Vrijednost označava razlomak uklanjanja šuma pri kojem classifier-free guidance prestaje.
ss_sampling_stepsneobavezno
Vrstainteger
Zadano12
1 – 50
Broj koraka uklanjanja šuma početne strukture: moguća poboljšanja kvalitete dodatnim koracima dolaze uz sporiju obradu.
ss_rescale_tneobavezno
Vrstanumber
Zadano5
1 – 6
Postavite oštrinu prijelaza putem rasporeda šuma generiranja strukture: povećanjem ove vrijednosti prijelazi postaju oštriji.
shape_slat_guidance_strengthneobavezno
Vrstanumber
Zadano7.5
0 – 10
Kontrola vjernosti detaljne geometrije: većim pridržavanjem ulazne slike dobivaju se dodatne pojedinosti, uz rizik dodatnog šuma.
shape_slat_guidance_rescaleneobavezno
Vrstanumber
Zadano0.5
0 – 1
Povećajte ovu postavku kada geometrija izgleda bučno: time se smanjuju artefakti uzrokovani snažnim usmjeravanjem tijekom faze oblika.
shape_slat_guidance_interval_startneobavezno
Vrstanumber
Zadano0.6
0 – 1
Točka aktivacije classifier-free guidancea za pročišćavanje oblika u fazi 2. Izražena kao razlomak napretka uklanjanja šuma, postavlja interval_start; upute djeluju samo unutar prozora omeđenog vrijednostima interval_start i interval_end.
shape_slat_guidance_interval_endneobavezno
Vrstanumber
Zadano1
0 – 1
Granica uputa za fazu 2 (pročišćavanje oblika): odaberite vrijednost najmanje jednaku shape_slat_guidance_interval_start. Vrijednost označava razlomak uklanjanja šuma pri kojem classifier-free guidance prestaje.
shape_slat_sampling_stepsneobavezno
Vrstainteger
Zadano12
1 – 50
Broj koraka uklanjanja šuma za poboljšanje oblika: potencijalno glađa geometrija postiže se nauštrb brzine pri upotrebi dodatnih koraka.
shape_slat_rescale_tneobavezno
Vrstanumber
Zadano3
1 – 6
Postavite oštrinu geometrijskih pojedinosti putem rasporeda šuma za poboljšanje oblika; povećanjem ove vrijednosti dobivaju se oštrije pojedinosti.
tex_slat_guidance_strengthneobavezno
Vrstanumber
Zadano1
0 – 10
Kontrola vjernosti boje teksture: veće pridržavanje boja ulazne slike pri višim postavkama povećava živost, ali može uzrokovati prezasićenost.
tex_slat_guidance_rescaleneobavezno
Vrstanumber
Zadano0
0 – 1
Povećajte ovu postavku da biste riješili bučne teksture ili pojaseve boja: time se smanjuju artefakti uzrokovani snažnim usmjeravanjem tijekom faze teksture.
tex_slat_guidance_interval_startneobavezno
Vrstanumber
Zadano0.6
0 – 1
Točka aktivacije classifier-free guidancea za generiranje teksture u fazi 3. Izražena kao razlomak napretka uklanjanja šuma, postavlja interval_start; upute djeluju samo unutar prozora omeđenog vrijednostima interval_start i interval_end.
tex_slat_guidance_interval_endneobavezno
Vrstanumber
Zadano0.9
0 – 1
Granica uputa za fazu 3 (tekstura): odaberite vrijednost najmanje jednaku tex_slat_guidance_interval_start. Vrijednost označava razlomak uklanjanja šuma pri kojem classifier-free guidance prestaje.
tex_slat_sampling_stepsneobavezno
Vrstainteger
Zadano12
1 – 50
Broj koraka uklanjanja šuma za generiranje tekstura. Povećanje broja koraka traje dulje, ali može dati čišće teksture.
tex_slat_rescale_tneobavezno
Vrstanumber
Zadano3
1 – 6
Postavite oštrinu pojedinosti teksture putem rasporeda šuma za generiranje teksture; povećanjem ove vrijednosti dobivaju se oštrije pojedinosti.
decimation_targetneobavezno
Vrstainteger
Zadano500000
5.000 – 2.000.000
Ciljani broj vrhova mreže; za opću namjenu preporučuje se 500k, a za web/mobilne uređaje 20k–50k. Smanjenje cilja zamjenjuje detalje mreže manjim datotekama.
texture_sizeneobavezno
Vrstaenum
Zadano2048
102420484096
Razlučivost teksture mreže za pečenje. Finije pojedinosti površine stvaraju veće datoteke pri povećanju ove razlučivosti.
remeshneobavezno
Vrstaboolean
Zadanotrue
Obnova topologije koja stvara čišće trokute mreže i obično poboljšava prikladnost za kasniju upotrebu, poput animacije ili 3D ispisa, uz sporiju obradu.
remesh_bandneobavezno
Vrstanumber
Zadano1
0 – 4
Dopuštenje pomicanja pri ponovnom stvaranju mreže: dodatno zaglađivanje može žrtvovati fine detalje kada se vrijednost poveća. Postavka ograničava pomak vrhova u odnosu na izvornu površinu.
remesh_projectneobavezno
Vrstanumber
Zadano0
0 – 1
Jačina projekcije za vraćanje ponovno stvorenih vrhova na izvornu površinu: 1 čuva detalje potpunom projekcijom, dok 0 isključuje projekciju za glađi rezultat.
uv_unwrap_angle_threshold_degneobavezno
Vrstanumber
Zadano90
0 – 180
Ograničenje kuta UV grafikona u stupnjevima, kojim se ograničava razlika susjednih normala ploha unutar jednog grafikona. Veće ograničenje pogoduje manjem broju većih grafikona uz rizik rastezanja; manje ograničenje pogoduje većem broju grafikona i manjem izobličenju.
uv_unwrap_refine_iterationsneobavezno
Vrstainteger
Zadano0
0 – 10
Broj lokalnih prolaza pročišćavanja za izračun UV grafikona.
uv_unwrap_global_iterationsneobavezno
Vrstainteger
Zadano1
1 – 10
Ravnoteža UV grafikona može se poboljšati povećanjem broja globalnih prolaza grupiranja koji se koriste za njihov izračun.
uv_unwrap_smooth_strengthneobavezno
Vrstanumber
Zadano1
0 – 10
Prilagodite jačinu zaglađivanja rubova UV grafikona; manje vidljivi spojevi pri višim postavkama nose rizik izobličenja UV-a.
image_urlobavezno image
Vrstaurl · image
URL koji upućuje na izvornu sliku za 3D pretvorbu.
obavezno Kanonski naziv, također prihvaćen

Parametri datoteka prihvaćaju javni https:// URL, data: URI do 10 MB ili file_url prenesene datoteke. Datoteke

Izlaz

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"
  }
}
Vaše datoteke, vaš izborSvaki outputs[].url kopija je u našoj pohrani: čuva se zauvijek (naplaćuje se po GB-mjesecu) ili 7 dana besplatno, prema postavci računa ili ?storage=.
Isti oblik na svakom modelutype, url, content_type, width, height i duration za slike, videozapise i zvuk. output je vlastiti objekt rezultata modela.
Polja izlaza
model_glb
object {url, content_type, file_name, file_size}3D model generiran u formatu GLB.

Više modela: Slika u 3D

Za AI agente: ova je stranica u Markdownu dostupna na https://doitong.com/hr/developers/models/trellis-2.md. Svi modeli i vodiči: https://doitong.com/developers/llms.txt