Neidio i'r cynnwys

Trellis 2

Integreiddio

ID y model 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"

Y cais hwn: $0.30 300 o gredydau API Ei redeg ar y dudalen hon

Cael allwedd API
Microsoft Delwedd i 3D #image-to-3d

Yn troi un ddelwedd yn rhwyll 3D GLB â gwead, gyda gosodiadau addasadwy ar gyfer strwythur, siâp, gwead ac UV

Microsoft · 3D

Mae eich canlyniad cyntaf yn mynd yma

Adeiladwch gais isod a'i redeg gyda'ch allwedd API. Mae allbynnau'n cael eu copïo i'n storio, wedi'u cadw am byth neu am 7 diwrnod am ddim.

Adeiladu cais

Cynhyrchir rheolyddion o sgema'r model. Mae'r cod a'r pris yn diweddaru wrth i chi eu newid.

•gofynnol image_url
Gollyngwch ffeil, neu

URL sy'n pwyntio at y ddelwedd ffynhonnell ar gyfer trosi 3D.

resolution rhagosodedig 1024

Cydraniad yr allbwn; mae ei gynyddu'n ychwanegu manylion ond yn cymryd mwy o amser.

Uwch 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 rhagosodedig 2048

Cydraniad gwead y rhwyll ar gyfer pobi. Mae manylion wyneb mwy manwl yn cynhyrchu ffeiliau mwy pan gynyddir y cydraniad hwn.

rhagosodedig 7.5

Rheolaeth ffyddlondeb strwythur 3D cychwynnol: mae ei chynyddu'n ffafrio cyfatebiaeth agosach â'r ddelwedd fewnbwn ar draul sŵn ychwanegol posibl.

rhagosodedig 0.7

Rheolaeth arteffactau arweiniad cam 1, gan gyfnewid effeithiau arweiniad cryfach mewn gosodiadau is am allbwn mwy sefydlog mewn gosodiadau uchel.

rhagosodedig 0.6

Ffin gychwyn ffenestr arweiniad di-ddosbarthwr yng ngham 1 (strwythur gwasgaredig), wedi'i mynegi fel ffracsiwn dad-sŵnio. Mae gosodiadau is yn cychwyn arweiniad yn gynt; dim ond yr egwyl o interval_start i interval_end sy'n defnyddio arweiniad, gyda phrosesu heb arweiniad mewn mannau eraill.

rhagosodedig 1

Terfyn arweiniad ar gyfer cam 1 (strwythur gwasgaredig): dewiswch werth sydd o leiaf mor fawr â ss_guidance_interval_start. Mae'r gwerth yn nodi'r ffracsiwn o ddad-sŵnio a gyrhaeddir pan fydd arweiniad di-ddosbarthwr yn dod i ben.

rhagosodedig 12

Nifer camau tynnu sŵn y strwythur cychwynnol: daw enillion ansawdd posibl o gamau ychwanegol gyda phrosesu arafach.

rhagosodedig 5

Gosodwch eglurder y trawsnewidiad drwy amserlen sŵn cynhyrchu'r strwythur: mae cynyddu'r gwerth hwn yn gwneud trawsnewidiadau'n fwy eglur.

rhagosodedig 7.5

Rheolaeth ffyddlondeb geometreg fanwl: mae cynyddu'r ymlyniad wrth y ddelwedd fewnbwn yn ychwanegu manylion, gyda risg o sŵn ychwanegol.

rhagosodedig 0.5

Cynyddwch y gosodiad hwn pan fo'r geometreg yn edrych yn swnllyd: mae'n lleihau arteffactau a achosir gan arweiniad cryf yn ystod y cam siâp.

rhagosodedig 0.6

Pwynt actifadu arweiniad di-ddosbarthwr ar gyfer mireinio siâp yng ngham 2. Wedi'i fynegi fel ffracsiwn o gynnydd dad-sŵnio, mae'n gosod interval_start; dim ond o fewn y ffenestr rhwng interval_start ac interval_end y mae arweiniad yn gweithredu.

rhagosodedig 1

Terfyn arweiniad ar gyfer cam 2 (mireinio siâp): dewiswch werth sydd o leiaf mor fawr â shape_slat_guidance_interval_start. Mae'r gwerth yn nodi'r ffracsiwn o ddad-sŵnio a gyrhaeddir pan fydd arweiniad di-ddosbarthwr yn dod i ben.

rhagosodedig 12

Nifer camau tynnu sŵn mireinio'r siâp: gall geometreg esmwythach gostio cyflymder pan ddefnyddir camau ychwanegol.

rhagosodedig 3

Gosodwch eglurder manylion geometrig drwy amserlen sŵn mireinio'r siâp; mae cynyddu'r gwerth hwn yn cynhyrchu manylion mwy eglur.

rhagosodedig 1

Rheolaeth ffyddlondeb lliw gwead: mae ymlyniad agosach at liwiau'r ddelwedd fewnbwn mewn gosodiadau uwch yn cynyddu bywiogrwydd ond gall achosi gor-dirlawnder.

rhagosodedig 0

Cynyddwch y gosodiad hwn i fynd i'r afael â gweadau swnllyd neu fandio lliw: mae'n lleihau arteffactau a achosir gan arweiniad cryf yn ystod y cam gwead.

rhagosodedig 0.6

Pwynt actifadu arweiniad di-ddosbarthwr ar gyfer cynhyrchu gwead yng ngham 3. Wedi'i fynegi fel ffracsiwn o gynnydd dad-sŵnio, mae'n gosod interval_start; dim ond o fewn y ffenestr rhwng interval_start ac interval_end y mae arweiniad yn gweithredu.

rhagosodedig 0.9

Terfyn arweiniad ar gyfer cam 3 (gwead): dewiswch werth sydd o leiaf mor fawr â tex_slat_guidance_interval_start. Mae'r gwerth yn nodi'r ffracsiwn o ddad-sŵnio a gyrhaeddir pan fydd arweiniad di-ddosbarthwr yn dod i ben.

rhagosodedig 12

Nifer y camau tynnu sŵn a ddefnyddir i gynhyrchu gweadau. Mae cynyddu nifer y camau'n cymryd mwy o amser ond gall gynhyrchu gweadau glanach.

rhagosodedig 3

Gosodwch eglurder manylion gwead drwy amserlen sŵn cynhyrchu'r gwead; mae cynyddu'r gwerth hwn yn cynhyrchu manylion mwy eglur.

rhagosodedig 500000

Targed cyfrif fertigau'r rhwyll, gyda 500k wedi'i argymell ar gyfer defnydd cyffredinol a 20k–50k ar gyfer y we/ffôn symudol. Mae lleihau'r targed yn cyfnewid manylion y rhwyll am ffeiliau llai.

rhagosodedig 1

Lwfans symud ail-rwyllo: gall llyfnhau ychwanegol aberthu manylion mân pan gynyddir y gwerth hwn. Mae'r gosodiad yn cyfyngu ar ddadleoli fertigau o'i gymharu â'r arwyneb gwreiddiol.

rhagosodedig 0

Cryfder taflunio ar gyfer dychwelyd fertigau wedi'u hail-rwyllo i'r arwyneb gwreiddiol: mae 1 yn cadw manylion drwy daflunio llawn, tra bod 0 yn gadael taflunio i ffwrdd ar gyfer canlyniad llyfnach.

rhagosodedig 90

Terfyn ongl siart UV mewn graddau, gan gyfyngu ar faint y gall normalau wynebau cyfagos wahaniaethu o fewn un siart. Mae codi'r terfyn yn ffafrio llai o siartiau mwy, gan beryglu ymestyn; mae ei leihau yn ffafrio mwy o siartiau a llai o ystumio.

rhagosodedig 0

Nifer y pasys mireinio lleol a ddefnyddir i gyfrifo siartiau UV.

rhagosodedig 1

Gellir gwella cydbwysedd siartiau UV drwy gynyddu'r nifer hwn o basys clystyru byd-eang a ddefnyddir i gyfrifo'r siartiau.

rhagosodedig 1

Addaswch pa mor gryf y caiff ymylon siartiau UV eu llyfnhau; mae llai o wythiennau gweladwy mewn gosodiadau uwch yn dod â risg o ystumio UV.

Hedyn a ddefnyddir ar gyfer cynhyrchu ar hap atgynhyrchadwy.

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

Rhedeg y cais hwn

Mae'ch allwedd yn aros yn y porwr hwn: caiff ei hanfon at Doitong API yn unig a'i chadw (localStorage) dim ond os ticiwch Cofio. Cael allwedd API

Ynglŷn â Trellis 2

Yn adeiladu ased 3D o un ddelwedd (`image_url`) ac yn dychwelyd ffeil GLB. Mae `resolution` yn 512, 1024 neu 1536, ac mae `texture_size` yn 1024, 2048 neu 4096. Mae gan bob un o'r tri cham (strwythur, siâp, gwead) ei reolyddion arweiniad a chamau samplu ei hun. Mae `decimation_target` yn gosod nifer fertigau'r rhwyll (5,000 i 2,000,000), ac mae opsiynau ail-rwyllo a datblygu UV ar gael.

Paramedrau

Anfonwch naill ai'r enw canonaidd neu'r enw brodorol, nid y ddau. Enwau canonaidd

EnwMath RhagosodedigCaniateir Disgrifiad
seeddewisol
Mathinteger | null
Hedyn a ddefnyddir ar gyfer cynhyrchu ar hap atgynhyrchadwy.
resolutiondewisol
Mathenum
Rhagosodedig1024
51210241536
Cydraniad yr allbwn; mae ei gynyddu'n ychwanegu manylion ond yn cymryd mwy o amser.
ss_guidance_strengthdewisol
Mathnumber
Rhagosodedig7.5
0 – 10
Rheolaeth ffyddlondeb strwythur 3D cychwynnol: mae ei chynyddu'n ffafrio cyfatebiaeth agosach â'r ddelwedd fewnbwn ar draul sŵn ychwanegol posibl.
ss_guidance_rescaledewisol
Mathnumber
Rhagosodedig0.7
0 – 1
Rheolaeth arteffactau arweiniad cam 1, gan gyfnewid effeithiau arweiniad cryfach mewn gosodiadau is am allbwn mwy sefydlog mewn gosodiadau uchel.
ss_guidance_interval_startdewisol
Mathnumber
Rhagosodedig0.6
0 – 1
Ffin gychwyn ffenestr arweiniad di-ddosbarthwr yng ngham 1 (strwythur gwasgaredig), wedi'i mynegi fel ffracsiwn dad-sŵnio. Mae gosodiadau is yn cychwyn arweiniad yn gynt; dim ond yr egwyl o interval_start i interval_end sy'n defnyddio arweiniad, gyda phrosesu heb arweiniad mewn mannau eraill.
ss_guidance_interval_enddewisol
Mathnumber
Rhagosodedig1
0 – 1
Terfyn arweiniad ar gyfer cam 1 (strwythur gwasgaredig): dewiswch werth sydd o leiaf mor fawr â ss_guidance_interval_start. Mae'r gwerth yn nodi'r ffracsiwn o ddad-sŵnio a gyrhaeddir pan fydd arweiniad di-ddosbarthwr yn dod i ben.
ss_sampling_stepsdewisol
Mathinteger
Rhagosodedig12
1 – 50
Nifer camau tynnu sŵn y strwythur cychwynnol: daw enillion ansawdd posibl o gamau ychwanegol gyda phrosesu arafach.
ss_rescale_tdewisol
Mathnumber
Rhagosodedig5
1 – 6
Gosodwch eglurder y trawsnewidiad drwy amserlen sŵn cynhyrchu'r strwythur: mae cynyddu'r gwerth hwn yn gwneud trawsnewidiadau'n fwy eglur.
shape_slat_guidance_strengthdewisol
Mathnumber
Rhagosodedig7.5
0 – 10
Rheolaeth ffyddlondeb geometreg fanwl: mae cynyddu'r ymlyniad wrth y ddelwedd fewnbwn yn ychwanegu manylion, gyda risg o sŵn ychwanegol.
shape_slat_guidance_rescaledewisol
Mathnumber
Rhagosodedig0.5
0 – 1
Cynyddwch y gosodiad hwn pan fo'r geometreg yn edrych yn swnllyd: mae'n lleihau arteffactau a achosir gan arweiniad cryf yn ystod y cam siâp.
shape_slat_guidance_interval_startdewisol
Mathnumber
Rhagosodedig0.6
0 – 1
Pwynt actifadu arweiniad di-ddosbarthwr ar gyfer mireinio siâp yng ngham 2. Wedi'i fynegi fel ffracsiwn o gynnydd dad-sŵnio, mae'n gosod interval_start; dim ond o fewn y ffenestr rhwng interval_start ac interval_end y mae arweiniad yn gweithredu.
shape_slat_guidance_interval_enddewisol
Mathnumber
Rhagosodedig1
0 – 1
Terfyn arweiniad ar gyfer cam 2 (mireinio siâp): dewiswch werth sydd o leiaf mor fawr â shape_slat_guidance_interval_start. Mae'r gwerth yn nodi'r ffracsiwn o ddad-sŵnio a gyrhaeddir pan fydd arweiniad di-ddosbarthwr yn dod i ben.
shape_slat_sampling_stepsdewisol
Mathinteger
Rhagosodedig12
1 – 50
Nifer camau tynnu sŵn mireinio'r siâp: gall geometreg esmwythach gostio cyflymder pan ddefnyddir camau ychwanegol.
shape_slat_rescale_tdewisol
Mathnumber
Rhagosodedig3
1 – 6
Gosodwch eglurder manylion geometrig drwy amserlen sŵn mireinio'r siâp; mae cynyddu'r gwerth hwn yn cynhyrchu manylion mwy eglur.
tex_slat_guidance_strengthdewisol
Mathnumber
Rhagosodedig1
0 – 10
Rheolaeth ffyddlondeb lliw gwead: mae ymlyniad agosach at liwiau'r ddelwedd fewnbwn mewn gosodiadau uwch yn cynyddu bywiogrwydd ond gall achosi gor-dirlawnder.
tex_slat_guidance_rescaledewisol
Mathnumber
Rhagosodedig0
0 – 1
Cynyddwch y gosodiad hwn i fynd i'r afael â gweadau swnllyd neu fandio lliw: mae'n lleihau arteffactau a achosir gan arweiniad cryf yn ystod y cam gwead.
tex_slat_guidance_interval_startdewisol
Mathnumber
Rhagosodedig0.6
0 – 1
Pwynt actifadu arweiniad di-ddosbarthwr ar gyfer cynhyrchu gwead yng ngham 3. Wedi'i fynegi fel ffracsiwn o gynnydd dad-sŵnio, mae'n gosod interval_start; dim ond o fewn y ffenestr rhwng interval_start ac interval_end y mae arweiniad yn gweithredu.
tex_slat_guidance_interval_enddewisol
Mathnumber
Rhagosodedig0.9
0 – 1
Terfyn arweiniad ar gyfer cam 3 (gwead): dewiswch werth sydd o leiaf mor fawr â tex_slat_guidance_interval_start. Mae'r gwerth yn nodi'r ffracsiwn o ddad-sŵnio a gyrhaeddir pan fydd arweiniad di-ddosbarthwr yn dod i ben.
tex_slat_sampling_stepsdewisol
Mathinteger
Rhagosodedig12
1 – 50
Nifer y camau tynnu sŵn a ddefnyddir i gynhyrchu gweadau. Mae cynyddu nifer y camau'n cymryd mwy o amser ond gall gynhyrchu gweadau glanach.
tex_slat_rescale_tdewisol
Mathnumber
Rhagosodedig3
1 – 6
Gosodwch eglurder manylion gwead drwy amserlen sŵn cynhyrchu'r gwead; mae cynyddu'r gwerth hwn yn cynhyrchu manylion mwy eglur.
decimation_targetdewisol
Mathinteger
Rhagosodedig500000
5,000 – 2,000,000
Targed cyfrif fertigau'r rhwyll, gyda 500k wedi'i argymell ar gyfer defnydd cyffredinol a 20k–50k ar gyfer y we/ffôn symudol. Mae lleihau'r targed yn cyfnewid manylion y rhwyll am ffeiliau llai.
texture_sizedewisol
Mathenum
Rhagosodedig2048
102420484096
Cydraniad gwead y rhwyll ar gyfer pobi. Mae manylion wyneb mwy manwl yn cynhyrchu ffeiliau mwy pan gynyddir y cydraniad hwn.
remeshdewisol
Mathboolean
Rhagosodedigtrue
Ailadeiladu topoleg sy'n creu trionglau rhwyll glanach, gan wella fel arfer addasrwydd ar gyfer defnyddiau diweddarach megis animeiddio neu argraffu 3D, ar draul prosesu arafach.
remesh_banddewisol
Mathnumber
Rhagosodedig1
0 – 4
Lwfans symud ail-rwyllo: gall llyfnhau ychwanegol aberthu manylion mân pan gynyddir y gwerth hwn. Mae'r gosodiad yn cyfyngu ar ddadleoli fertigau o'i gymharu â'r arwyneb gwreiddiol.
remesh_projectdewisol
Mathnumber
Rhagosodedig0
0 – 1
Cryfder taflunio ar gyfer dychwelyd fertigau wedi'u hail-rwyllo i'r arwyneb gwreiddiol: mae 1 yn cadw manylion drwy daflunio llawn, tra bod 0 yn gadael taflunio i ffwrdd ar gyfer canlyniad llyfnach.
uv_unwrap_angle_threshold_degdewisol
Mathnumber
Rhagosodedig90
0 – 180
Terfyn ongl siart UV mewn graddau, gan gyfyngu ar faint y gall normalau wynebau cyfagos wahaniaethu o fewn un siart. Mae codi'r terfyn yn ffafrio llai o siartiau mwy, gan beryglu ymestyn; mae ei leihau yn ffafrio mwy o siartiau a llai o ystumio.
uv_unwrap_refine_iterationsdewisol
Mathinteger
Rhagosodedig0
0 – 10
Nifer y pasys mireinio lleol a ddefnyddir i gyfrifo siartiau UV.
uv_unwrap_global_iterationsdewisol
Mathinteger
Rhagosodedig1
1 – 10
Gellir gwella cydbwysedd siartiau UV drwy gynyddu'r nifer hwn o basys clystyru byd-eang a ddefnyddir i gyfrifo'r siartiau.
uv_unwrap_smooth_strengthdewisol
Mathnumber
Rhagosodedig1
0 – 10
Addaswch pa mor gryf y caiff ymylon siartiau UV eu llyfnhau; mae llai o wythiennau gweladwy mewn gosodiadau uwch yn dod â risg o ystumio UV.
image_urlgofynnol image
Mathurl · image
URL sy'n pwyntio at y ddelwedd ffynhonnell ar gyfer trosi 3D.
gofynnol Enw canonaidd, derbyniol hefyd

Mae paramedrau ffeil yn derbyn URL cyhoeddus https://, URI data: hyd at 10 MB, neu file_url uwchlwythiad. Ffeiliau

Allbwn

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"
  }
}
Eich ffeiliau, eich dewisMae pob outputs[].url yn gopi ar ein storio: wedi'i gadw am byth (telir fesul GB-mis) neu am 7 diwrnod am ddim, yn ôl gosodiad eich cyfrif neu ?storage=.
Yr un siâp ar bob modeltype, url, content_type, width, height a duration, ar gyfer delweddau, fideo a sain fel ei gilydd. Gwrthrych canlyniad y model ei hun yw output.
Meysydd yr allbwn
model_glb
object {url, content_type, file_name, file_size}Model 3D a gynhyrchir ar ffurf GLB.

Mwy o fodelau: Delwedd i 3D

Ar gyfer asiantau AI: mae'r dudalen hon fel Markdown ar gael yn https://doitong.com/cy/developers/models/trellis-2.md. Pob model a chanllaw: https://doitong.com/developers/llms.txt