Pereiti prie turinio

Trellis 2

Integruoti

Modelio id 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"

Ši užklausa: 0,30 $ 300 API kreditų Paleisti šiame puslapyje

Gauti API raktą
Microsoft Vaizdas į 3D #image-to-3d

Vieną vaizdą paverčia tekstūruotu GLB 3D tinkleliu su reguliuojamais struktūros, formos, tekstūros ir UV nustatymais

Microsoft · 3D

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma image_url
Įmeskite failą arba

3D konvertavimui naudojamo šaltinio vaizdo URL.

resolution numatytoji 1024

Išvesties raiška; ją didinant pridedama detalių, bet apdorojimas trunka ilgiau.

Išplėstiniai 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 numatytoji 2048

Tinklo tekstūros kepimo raiška. Didinant raišką gaunama daugiau paviršiaus detalių, bet failai tampa didesni.

numatytoji 7.5

Pradinės 3D struktūros tikslumo valdymas: didesnė reikšmė teikia pirmenybę didesniam atitikimui įvesties vaizdui, tačiau gali padidinti triukšmą.

numatytoji 0.7

1 etapo valdymo artefaktų kontrolė: mažos reikšmės sustiprina valdymo poveikį, o didelės užtikrina stabilesnę išvestį.

numatytoji 0.6

Klasifikatoriaus nenaudojančio valdymo lango pradinė riba 1 etape (retosios struktūros), išreikšta triukšmo šalinimo dalimi. Mažesnės nuostatos pradeda valdymą anksčiau; tik intervalas nuo interval_start iki interval_end naudoja valdymą, o kitur apdorojama be valdymo.

numatytoji 1

1 etapo (retosios struktūros) valdymo pabaiga: pasirinkite reikšmę, bent lygią ss_guidance_interval_start. Reikšmė nurodo triukšmo šalinimo dalį, kurią pasiekus klasifikatoriaus nenaudojantis valdymas sustoja.

numatytoji 12

Pradinės struktūros triukšmo šalinimo žingsnių skaičius: papildomi žingsniai gali pagerinti kokybę, bet lėtina apdorojimą.

numatytoji 5

Nustatykite perėjimo ryškumą pagal struktūros generavimo triukšmo tvarkaraštį: didesnė reikšmė daro perėjimus ryškesnius.

numatytoji 7.5

Detalios geometrijos tikslumo valdymas: didesnis atitikimas įvesties vaizdui suteikia daugiau detalių, tačiau gali padidinti triukšmą.

numatytoji 0.5

Padidinkite šią reikšmę, kai geometrija atrodo triukšminga: tai sumažina stipraus valdymo formos etape sukeltus artefaktus.

numatytoji 0.6

Klasifikatoriaus nenaudojančio valdymo aktyvavimo taškas formos tobulinimui 2 etape. Išreikštas triukšmo šalinimo progreso dalimi, jis nustato interval_start; valdymas veikia tik lange tarp interval_start ir interval_end.

numatytoji 1

2 etapo valdymo pabaiga (formos tobulinimas): pasirinkite reikšmę, bent lygią shape_slat_guidance_interval_start. Reikšmė nurodo triukšmo šalinimo dalį, kurią pasiekus klasifikatoriaus nenaudojantis valdymas sustoja.

numatytoji 12

Formos tobulinimo triukšmo šalinimo žingsnių skaičius: papildomi žingsniai gali sukurti tolygesnę geometriją, bet mažina spartą.

numatytoji 3

Nustatykite geometrinių detalių ryškumą pagal formos tobulinimo triukšmo tvarkaraštį; didesnė reikšmė suteikia ryškesnių detalių.

numatytoji 1

Tekstūros spalvų tikslumo valdymas: didesnė reikšmė geriau išlaiko įvesties vaizdo spalvas ir didina sodrumą, tačiau gali sukelti persotinimą.

numatytoji 0

Padidinkite šią reikšmę, jei tekstūros triukšmingos arba matomos spalvų juostos: tai sumažina stipraus valdymo tekstūros etape sukeltus artefaktus.

numatytoji 0.6

Klasifikatoriaus nenaudojančio valdymo aktyvavimo taškas tekstūrai generuoti 3 etape. Išreikštas triukšmo šalinimo progreso dalimi, jis nustato interval_start; valdymas veikia tik lange tarp interval_start ir interval_end.

numatytoji 0.9

3 etapo valdymo pabaiga (tekstūra): pasirinkite reikšmę, bent lygią tex_slat_guidance_interval_start. Reikšmė nurodo triukšmo šalinimo dalį, kurią pasiekus klasifikatoriaus nenaudojantis valdymas sustoja.

numatytoji 12

Tekstūroms generuoti naudojamų triukšmo šalinimo žingsnių skaičius. Didesnis skaičius užtrunka ilgiau, bet gali suteikti švaresnes tekstūras.

numatytoji 3

Nustatykite tekstūros detalių ryškumą pagal tekstūros generavimo triukšmo tvarkaraštį; didesnė reikšmė suteikia ryškesnių detalių.

numatytoji 500000

Tinklelio viršūnių skaičiaus tikslas: bendrajai paskirčiai rekomenduojama 500k, o žiniatinkliui ir mobiliesiems įrenginiams – 20k–50k. Sumažinus tikslą, sumažėja tinklelio detalių ir failai tampa mažesni.

numatytoji 1

Perdarymo judėjimo leidžiamas dydis: padidinus šią reikšmę, papildus glodinimas gali paaukoti smulkias detales. Nuostata riboja viršūnių poslinkį, palyginti su pradiniu paviršiumi.

numatytoji 0

Perdarytų viršūnių grąžinimo į pradinį paviršių projekcijos stiprumas: 1 išlaiko detales per visą projekciją, o 0 išjungia projekciją ir sukuria lygesnį rezultatą.

numatytoji 90

UV diagramos kampo riba laipsniais, ribojanti gretimų paviršių normalių skirtumą vienoje diagramoje. Padidinus ribą pasirenkama mažiau didesnių diagramų, tačiau gali atsirasti tempimas; ją sumažinus pasirenkama daugiau diagramų ir mažiau iškraipymų.

numatytoji 0

Vietinio tobulinimo etapų, naudojamų UV diagramoms apskaičiuoti, skaičius.

numatytoji 1

UV diagramų balansą galima pagerinti padidinus globaliojo grupavimo etapų, naudojamų diagramoms apskaičiuoti, skaičių.

numatytoji 1

Koreguokite, kaip stipriai glodinami UV diagramos kraštai; didesnės nuostatos mažina matomų siūlių skaičių, tačiau gali iškraipyti UV.

Atkuriamam atsitiktiniam generavimui naudojama pradžia.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Trellis 2

Sukuria 3D išteklių iš vieno vaizdo (`image_url`) ir grąžina GLB failą. `resolution` yra 512, 1024 arba 1536, o `texture_size` – 1024, 2048 arba 4096. Kiekvienas iš trijų etapų (struktūra, forma, tekstūra) turi atskirus valdymo ir mėginių ėmimo žingsnių parametrus. `decimation_target` nustato tinklelio viršūnių skaičių (5,000-2,000,000), taip pat pateikiamos perlyginimo ir UV išvyniojimo parinktys.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
seedneprivalomas
Tipasinteger | null
Atkuriamam atsitiktiniam generavimui naudojama pradžia.
resolutionneprivalomas
Tipasenum
Numatytoji reikšmė1024
51210241536
Išvesties raiška; ją didinant pridedama detalių, bet apdorojimas trunka ilgiau.
ss_guidance_strengthneprivalomas
Tipasnumber
Numatytoji reikšmė7.5
0 – 10
Pradinės 3D struktūros tikslumo valdymas: didesnė reikšmė teikia pirmenybę didesniam atitikimui įvesties vaizdui, tačiau gali padidinti triukšmą.
ss_guidance_rescaleneprivalomas
Tipasnumber
Numatytoji reikšmė0.7
0 – 1
1 etapo valdymo artefaktų kontrolė: mažos reikšmės sustiprina valdymo poveikį, o didelės užtikrina stabilesnę išvestį.
ss_guidance_interval_startneprivalomas
Tipasnumber
Numatytoji reikšmė0.6
0 – 1
Klasifikatoriaus nenaudojančio valdymo lango pradinė riba 1 etape (retosios struktūros), išreikšta triukšmo šalinimo dalimi. Mažesnės nuostatos pradeda valdymą anksčiau; tik intervalas nuo interval_start iki interval_end naudoja valdymą, o kitur apdorojama be valdymo.
ss_guidance_interval_endneprivalomas
Tipasnumber
Numatytoji reikšmė1
0 – 1
1 etapo (retosios struktūros) valdymo pabaiga: pasirinkite reikšmę, bent lygią ss_guidance_interval_start. Reikšmė nurodo triukšmo šalinimo dalį, kurią pasiekus klasifikatoriaus nenaudojantis valdymas sustoja.
ss_sampling_stepsneprivalomas
Tipasinteger
Numatytoji reikšmė12
1 – 50
Pradinės struktūros triukšmo šalinimo žingsnių skaičius: papildomi žingsniai gali pagerinti kokybę, bet lėtina apdorojimą.
ss_rescale_tneprivalomas
Tipasnumber
Numatytoji reikšmė5
1 – 6
Nustatykite perėjimo ryškumą pagal struktūros generavimo triukšmo tvarkaraštį: didesnė reikšmė daro perėjimus ryškesnius.
shape_slat_guidance_strengthneprivalomas
Tipasnumber
Numatytoji reikšmė7.5
0 – 10
Detalios geometrijos tikslumo valdymas: didesnis atitikimas įvesties vaizdui suteikia daugiau detalių, tačiau gali padidinti triukšmą.
shape_slat_guidance_rescaleneprivalomas
Tipasnumber
Numatytoji reikšmė0.5
0 – 1
Padidinkite šią reikšmę, kai geometrija atrodo triukšminga: tai sumažina stipraus valdymo formos etape sukeltus artefaktus.
shape_slat_guidance_interval_startneprivalomas
Tipasnumber
Numatytoji reikšmė0.6
0 – 1
Klasifikatoriaus nenaudojančio valdymo aktyvavimo taškas formos tobulinimui 2 etape. Išreikštas triukšmo šalinimo progreso dalimi, jis nustato interval_start; valdymas veikia tik lange tarp interval_start ir interval_end.
shape_slat_guidance_interval_endneprivalomas
Tipasnumber
Numatytoji reikšmė1
0 – 1
2 etapo valdymo pabaiga (formos tobulinimas): pasirinkite reikšmę, bent lygią shape_slat_guidance_interval_start. Reikšmė nurodo triukšmo šalinimo dalį, kurią pasiekus klasifikatoriaus nenaudojantis valdymas sustoja.
shape_slat_sampling_stepsneprivalomas
Tipasinteger
Numatytoji reikšmė12
1 – 50
Formos tobulinimo triukšmo šalinimo žingsnių skaičius: papildomi žingsniai gali sukurti tolygesnę geometriją, bet mažina spartą.
shape_slat_rescale_tneprivalomas
Tipasnumber
Numatytoji reikšmė3
1 – 6
Nustatykite geometrinių detalių ryškumą pagal formos tobulinimo triukšmo tvarkaraštį; didesnė reikšmė suteikia ryškesnių detalių.
tex_slat_guidance_strengthneprivalomas
Tipasnumber
Numatytoji reikšmė1
0 – 10
Tekstūros spalvų tikslumo valdymas: didesnė reikšmė geriau išlaiko įvesties vaizdo spalvas ir didina sodrumą, tačiau gali sukelti persotinimą.
tex_slat_guidance_rescaleneprivalomas
Tipasnumber
Numatytoji reikšmė0
0 – 1
Padidinkite šią reikšmę, jei tekstūros triukšmingos arba matomos spalvų juostos: tai sumažina stipraus valdymo tekstūros etape sukeltus artefaktus.
tex_slat_guidance_interval_startneprivalomas
Tipasnumber
Numatytoji reikšmė0.6
0 – 1
Klasifikatoriaus nenaudojančio valdymo aktyvavimo taškas tekstūrai generuoti 3 etape. Išreikštas triukšmo šalinimo progreso dalimi, jis nustato interval_start; valdymas veikia tik lange tarp interval_start ir interval_end.
tex_slat_guidance_interval_endneprivalomas
Tipasnumber
Numatytoji reikšmė0.9
0 – 1
3 etapo valdymo pabaiga (tekstūra): pasirinkite reikšmę, bent lygią tex_slat_guidance_interval_start. Reikšmė nurodo triukšmo šalinimo dalį, kurią pasiekus klasifikatoriaus nenaudojantis valdymas sustoja.
tex_slat_sampling_stepsneprivalomas
Tipasinteger
Numatytoji reikšmė12
1 – 50
Tekstūroms generuoti naudojamų triukšmo šalinimo žingsnių skaičius. Didesnis skaičius užtrunka ilgiau, bet gali suteikti švaresnes tekstūras.
tex_slat_rescale_tneprivalomas
Tipasnumber
Numatytoji reikšmė3
1 – 6
Nustatykite tekstūros detalių ryškumą pagal tekstūros generavimo triukšmo tvarkaraštį; didesnė reikšmė suteikia ryškesnių detalių.
decimation_targetneprivalomas
Tipasinteger
Numatytoji reikšmė500000
5 000 – 2 000 000
Tinklelio viršūnių skaičiaus tikslas: bendrajai paskirčiai rekomenduojama 500k, o žiniatinkliui ir mobiliesiems įrenginiams – 20k–50k. Sumažinus tikslą, sumažėja tinklelio detalių ir failai tampa mažesni.
texture_sizeneprivalomas
Tipasenum
Numatytoji reikšmė2048
102420484096
Tinklo tekstūros kepimo raiška. Didinant raišką gaunama daugiau paviršiaus detalių, bet failai tampa didesni.
remeshneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Topologijos atkūrimas, sukuriantis tvarkingesnius tinklelio trikampius ir paprastai pagerinantis tinkamumą vėlesniam naudojimui, pvz., animacijai ar 3D spausdinimui, tačiau pailginantis apdorojimą.
remesh_bandneprivalomas
Tipasnumber
Numatytoji reikšmė1
0 – 4
Perdarymo judėjimo leidžiamas dydis: padidinus šią reikšmę, papildus glodinimas gali paaukoti smulkias detales. Nuostata riboja viršūnių poslinkį, palyginti su pradiniu paviršiumi.
remesh_projectneprivalomas
Tipasnumber
Numatytoji reikšmė0
0 – 1
Perdarytų viršūnių grąžinimo į pradinį paviršių projekcijos stiprumas: 1 išlaiko detales per visą projekciją, o 0 išjungia projekciją ir sukuria lygesnį rezultatą.
uv_unwrap_angle_threshold_degneprivalomas
Tipasnumber
Numatytoji reikšmė90
0 – 180
UV diagramos kampo riba laipsniais, ribojanti gretimų paviršių normalių skirtumą vienoje diagramoje. Padidinus ribą pasirenkama mažiau didesnių diagramų, tačiau gali atsirasti tempimas; ją sumažinus pasirenkama daugiau diagramų ir mažiau iškraipymų.
uv_unwrap_refine_iterationsneprivalomas
Tipasinteger
Numatytoji reikšmė0
0 – 10
Vietinio tobulinimo etapų, naudojamų UV diagramoms apskaičiuoti, skaičius.
uv_unwrap_global_iterationsneprivalomas
Tipasinteger
Numatytoji reikšmė1
1 – 10
UV diagramų balansą galima pagerinti padidinus globaliojo grupavimo etapų, naudojamų diagramoms apskaičiuoti, skaičių.
uv_unwrap_smooth_strengthneprivalomas
Tipasnumber
Numatytoji reikšmė1
0 – 10
Koreguokite, kaip stipriai glodinami UV diagramos kraštai; didesnės nuostatos mažina matomų siūlių skaičių, tačiau gali iškraipyti UV.
image_urlprivaloma image
Tipasurl · image
3D konvertavimui naudojamo šaltinio vaizdo URL.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
model_glb
object {url, content_type, file_name, file_size}GLB formatu sugeneruotas 3D modelis.

Daugiau modelių: Vaizdas į 3D

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/trellis-2.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt