Léim chuig an ábhar

Trellis 2

Comhtháthú

Aitheantas na samhla trellis-2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

An t-iarratas seo: $0.30 300 gcreidmheas API · ≈ ₽31.64 Rith ar an leathanach seo

Faigh eochair API
Microsoft Íomhá go 3D #image-to-3d

Tiontaíonn sé íomhá aonair ina mogall GLB 3D uigeach le socruithe inchoigeartaithe do struchtúr, cruth, uigeacht agus UV

Microsoft · 3D

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach image_url
Scaoil comhad, nó

URL a dhíríonn ar an íomhá foinse le haghaidh tiontú 3D.

resolution réamhshocrú 1024

Taifeach an aschuir; cuireann méadú air sonraí leis ach tógann sé níos faide.

Ardleibhéal 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 réamhshocrú 2048

Taifeach uigeachta na mogalra le haghaidh bácála. Cruthaíonn mionsonraí dromchla níos míne comhaid níos mó nuair a mhéadaítear an taifeach seo.

réamhshocrú 7.5

Rialú ar dhílseacht na struchtúir 3D tosaigh: cuireann méadú leis an gcomhaontú leis an íomhá ionchuir, ach d’fhéadfadh torann breise tarlú.

réamhshocrú 0.7

Rialú déantán treorach Chéim 1, agus éifeachtaí treorach níos láidre ag socruithe ísle á malartú ar aschur níos cobhsaí ag socruithe arda.

réamhshocrú 0.6

Teorainn tosaigh fhuinneog na treorach saor ó aicmitheoir i gcéim 1 (struchtúr tanaí), sainráite mar chodán de laghdú torainn. Tosaíonn socruithe níos ísle an treoir níos luaithe; ní úsáideann ach an t-eatramh ó interval_start go interval_end treoir, agus déantar próiseáil gan treoir in áiteanna eile.

réamhshocrú 1

Gearradh treorach do chéim 1 (struchtúr tanaí): roghnaigh luach atá ar a laghad chomh mór le ss_guidance_interval_start. Aithníonn an luach an codán den laghdú torainn a sroichtear nuair a stopann an treoir saor ó aicmitheoir.

réamhshocrú 12

Líon na gcéimeanna dí-íslithe torainn don struchtúr tosaigh: tagann gnóthachain fhéideartha cáilíochta ó chéimeanna breise ar chostas próiseála níos moille.

réamhshocrú 5

Socraigh géire an aistrithe trí sceideal torainn ghiniúint na struchtúir: déanann méadú ar an luach seo na haistrithe níos géire.

réamhshocrú 7.5

Rialú dílseachta na céimseata mionsonraithe: cruthaíonn cloí níos fearr leis an íomhá ionchuir tuilleadh sonraí, agus baol torainn bhreise ann.

réamhshocrú 0.5

Méadaigh an socrú seo nuair a bhíonn an chéimseata torannach: laghdaíonn sé déantáin de bharr treorach láidre le linn chéim na crutha.

réamhshocrú 0.6

Pointe gníomhachtaithe treorach saor ó aicmitheoir le haghaidh scagadh crutha i gcéim 2. Sainráite mar chodán de dhul chun cinn an laghdaithe torainn, socraíonn sé interval_start; ní oibríonn an treoir ach laistigh den fhuinneog idir interval_start agus interval_end.

réamhshocrú 1

Gearradh treorach do chéim 2 (scagadh crutha): roghnaigh luach atá ar a laghad chomh mór le shape_slat_guidance_interval_start. Aithníonn an luach an codán den laghdú torainn a sroichtear nuair a stopann an treoir saor ó aicmitheoir.

réamhshocrú 12

Líon na gcéimeanna dí-íslithe torainn le haghaidh mionchoigeartú na crutha: d’fhéadfadh céimseata níos míne teacht ar chostas luais nuair a úsáidtear céimeanna breise.

réamhshocrú 3

Socraigh géire mhionsonraí na céimseata trí sceideal torainn mhionchoigeartaithe na crutha; cruthaíonn méadú ar an luach seo sonraí níos géire.

réamhshocrú 1

Rialú dílseachta dathanna na huigeachta: méadaíonn cloí níos dlúithe le dathanna na híomhá ionchuir ag socruithe níos airde beogacht, ach d’fhéadfadh sé rósháithiú a chruthú.

réamhshocrú 0

Méadaigh an socrú seo chun uigeachtaí torannacha nó bandáil dathanna a cheartú: laghdaíonn sé déantáin de bharr treorach láidre le linn chéim na huigeachta.

réamhshocrú 0.6

Pointe gníomhachtaithe treorach saor ó aicmitheoir le haghaidh giniúint uigeachta i gcéim 3. Sainráite mar chodán de dhul chun cinn an laghdaithe torainn, socraíonn sé interval_start; ní oibríonn an treoir ach laistigh den fhuinneog idir interval_start agus interval_end.

réamhshocrú 0.9

Gearradh treorach do chéim 3 (uigeacht): roghnaigh luach atá ar a laghad chomh mór le tex_slat_guidance_interval_start. Aithníonn an luach an codán den laghdú torainn a sroichtear nuair a stopann an treoir saor ó aicmitheoir.

réamhshocrú 12

Líon na gcéimeanna dí-íslithe torainn a úsáidtear chun uigeachtaí a ghiniúint. Tógann méadú ar an líon níos faide ach d’fhéadfadh uigeachtaí níos glaine a bheith mar thoradh air.

réamhshocrú 3

Socraigh géire mhionsonraí na huigeachta trí sceideal torainn ghiniúint na huigeachta; cruthaíonn méadú ar an luach seo sonraí níos géire.

réamhshocrú 500000

Sprioc líon rinn an mhogalra, agus 500k molta le haghaidh úsáide ginearálta agus 20k–50k don ghréasán/soghluaiste. Déanann an sprioc a laghdú mionsonraí an mhogalra a mhalartú ar chomhaid níos lú.

réamhshocrú 1

Lamáltas gluaiseachta athmhúnlaithe: féadfaidh smúdáil bhreise mionsonraí míne a íobairt nuair a mhéadaítear an luach seo. Cuireann an socrú teorainn le díláithriú rinn i gcoibhneas leis an dromchla bunaidh.

réamhshocrú 0

Neart teilgin chun na rinn athmhúnlaithe a thabhairt ar ais chuig an dromchla bunaidh: coinníonn 1 mionsonraí trí theilgin iomlán, agus fágann 0 an teilgin múchta le haghaidh toradh níos míne.

réamhshocrú 90

Teorainn uillinne cairte UV i gcéimeanna, a chuireann srian leis an difríocht idir gnáthóga aghaidheanna comharsanacha laistigh de chairt amháin. Is fearr le teorainn níos airde níos lú cairteacha níos mó, agus baol sínte leis; is fearr le teorainn níos ísle níos mó cairteacha agus níos lú saobhadh.

réamhshocrú 0

Líon na bpasanna scagtha logánta a úsáidtear chun cairteacha UV a ríomh.

réamhshocrú 1

Is féidir cothromaíocht chairte UV a fheabhsú tríd an líon seo de phasanna cnuasaithe domhanda a úsáidtear chun na cairteacha a ríomh a mhéadú.

réamhshocrú 1

Coigeartaigh cé chomh láidir agus a smúdaítear imill chairte UV; bíonn níos lú seams infheicthe ag socruithe níos airde, ach tá baol saobhadh UV ann.

Síol a úsáidtear le haghaidh giniúint randamach in-atáirgthe.

POST /run/trellis-2?wait=20 luachan → $0.30
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Trellis 2

Tógann sé sócmhainn 3D ó íomhá amháin (`image_url`) agus cuireann sé comhad GLB ar ais. Is é `resolution` 512, 1024 nó 1536, agus is é `texture_size` 1024, 2048 nó 4096. Tá rialuithe treorach agus céimeanna samplála dá gcuid féin ag gach ceann de na trí chéim (struchtúr, cruth, uigeacht). Socraíonn `decimation_target` líon rinní an mhogaill (5,000 go 2,000,000), agus tá roghanna athmhogallaithe agus dífhilleadh UV ar fáil.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
seedroghnach
Cineálinteger | null
Síol a úsáidtear le haghaidh giniúint randamach in-atáirgthe.
resolutionroghnach
Cineálenum
Réamhshocrú1024
51210241536
Taifeach an aschuir; cuireann méadú air sonraí leis ach tógann sé níos faide.
ss_guidance_strengthroghnach
Cineálnumber
Réamhshocrú7.5
0 – 10
Rialú ar dhílseacht na struchtúir 3D tosaigh: cuireann méadú leis an gcomhaontú leis an íomhá ionchuir, ach d’fhéadfadh torann breise tarlú.
ss_guidance_rescaleroghnach
Cineálnumber
Réamhshocrú0.7
0 – 1
Rialú déantán treorach Chéim 1, agus éifeachtaí treorach níos láidre ag socruithe ísle á malartú ar aschur níos cobhsaí ag socruithe arda.
ss_guidance_interval_startroghnach
Cineálnumber
Réamhshocrú0.6
0 – 1
Teorainn tosaigh fhuinneog na treorach saor ó aicmitheoir i gcéim 1 (struchtúr tanaí), sainráite mar chodán de laghdú torainn. Tosaíonn socruithe níos ísle an treoir níos luaithe; ní úsáideann ach an t-eatramh ó interval_start go interval_end treoir, agus déantar próiseáil gan treoir in áiteanna eile.
ss_guidance_interval_endroghnach
Cineálnumber
Réamhshocrú1
0 – 1
Gearradh treorach do chéim 1 (struchtúr tanaí): roghnaigh luach atá ar a laghad chomh mór le ss_guidance_interval_start. Aithníonn an luach an codán den laghdú torainn a sroichtear nuair a stopann an treoir saor ó aicmitheoir.
ss_sampling_stepsroghnach
Cineálinteger
Réamhshocrú12
1 – 50
Líon na gcéimeanna dí-íslithe torainn don struchtúr tosaigh: tagann gnóthachain fhéideartha cáilíochta ó chéimeanna breise ar chostas próiseála níos moille.
ss_rescale_troghnach
Cineálnumber
Réamhshocrú5
1 – 6
Socraigh géire an aistrithe trí sceideal torainn ghiniúint na struchtúir: déanann méadú ar an luach seo na haistrithe níos géire.
shape_slat_guidance_strengthroghnach
Cineálnumber
Réamhshocrú7.5
0 – 10
Rialú dílseachta na céimseata mionsonraithe: cruthaíonn cloí níos fearr leis an íomhá ionchuir tuilleadh sonraí, agus baol torainn bhreise ann.
shape_slat_guidance_rescaleroghnach
Cineálnumber
Réamhshocrú0.5
0 – 1
Méadaigh an socrú seo nuair a bhíonn an chéimseata torannach: laghdaíonn sé déantáin de bharr treorach láidre le linn chéim na crutha.
shape_slat_guidance_interval_startroghnach
Cineálnumber
Réamhshocrú0.6
0 – 1
Pointe gníomhachtaithe treorach saor ó aicmitheoir le haghaidh scagadh crutha i gcéim 2. Sainráite mar chodán de dhul chun cinn an laghdaithe torainn, socraíonn sé interval_start; ní oibríonn an treoir ach laistigh den fhuinneog idir interval_start agus interval_end.
shape_slat_guidance_interval_endroghnach
Cineálnumber
Réamhshocrú1
0 – 1
Gearradh treorach do chéim 2 (scagadh crutha): roghnaigh luach atá ar a laghad chomh mór le shape_slat_guidance_interval_start. Aithníonn an luach an codán den laghdú torainn a sroichtear nuair a stopann an treoir saor ó aicmitheoir.
shape_slat_sampling_stepsroghnach
Cineálinteger
Réamhshocrú12
1 – 50
Líon na gcéimeanna dí-íslithe torainn le haghaidh mionchoigeartú na crutha: d’fhéadfadh céimseata níos míne teacht ar chostas luais nuair a úsáidtear céimeanna breise.
shape_slat_rescale_troghnach
Cineálnumber
Réamhshocrú3
1 – 6
Socraigh géire mhionsonraí na céimseata trí sceideal torainn mhionchoigeartaithe na crutha; cruthaíonn méadú ar an luach seo sonraí níos géire.
tex_slat_guidance_strengthroghnach
Cineálnumber
Réamhshocrú1
0 – 10
Rialú dílseachta dathanna na huigeachta: méadaíonn cloí níos dlúithe le dathanna na híomhá ionchuir ag socruithe níos airde beogacht, ach d’fhéadfadh sé rósháithiú a chruthú.
tex_slat_guidance_rescaleroghnach
Cineálnumber
Réamhshocrú0
0 – 1
Méadaigh an socrú seo chun uigeachtaí torannacha nó bandáil dathanna a cheartú: laghdaíonn sé déantáin de bharr treorach láidre le linn chéim na huigeachta.
tex_slat_guidance_interval_startroghnach
Cineálnumber
Réamhshocrú0.6
0 – 1
Pointe gníomhachtaithe treorach saor ó aicmitheoir le haghaidh giniúint uigeachta i gcéim 3. Sainráite mar chodán de dhul chun cinn an laghdaithe torainn, socraíonn sé interval_start; ní oibríonn an treoir ach laistigh den fhuinneog idir interval_start agus interval_end.
tex_slat_guidance_interval_endroghnach
Cineálnumber
Réamhshocrú0.9
0 – 1
Gearradh treorach do chéim 3 (uigeacht): roghnaigh luach atá ar a laghad chomh mór le tex_slat_guidance_interval_start. Aithníonn an luach an codán den laghdú torainn a sroichtear nuair a stopann an treoir saor ó aicmitheoir.
tex_slat_sampling_stepsroghnach
Cineálinteger
Réamhshocrú12
1 – 50
Líon na gcéimeanna dí-íslithe torainn a úsáidtear chun uigeachtaí a ghiniúint. Tógann méadú ar an líon níos faide ach d’fhéadfadh uigeachtaí níos glaine a bheith mar thoradh air.
tex_slat_rescale_troghnach
Cineálnumber
Réamhshocrú3
1 – 6
Socraigh géire mhionsonraí na huigeachta trí sceideal torainn ghiniúint na huigeachta; cruthaíonn méadú ar an luach seo sonraí níos géire.
decimation_targetroghnach
Cineálinteger
Réamhshocrú500000
5,000 – 2,000,000
Sprioc líon rinn an mhogalra, agus 500k molta le haghaidh úsáide ginearálta agus 20k–50k don ghréasán/soghluaiste. Déanann an sprioc a laghdú mionsonraí an mhogalra a mhalartú ar chomhaid níos lú.
texture_sizeroghnach
Cineálenum
Réamhshocrú2048
102420484096
Taifeach uigeachta na mogalra le haghaidh bácála. Cruthaíonn mionsonraí dromchla níos míne comhaid níos mó nuair a mhéadaítear an taifeach seo.
remeshroghnach
Cineálboolean
Réamhshocrútrue
Atógáil topolaíochta a chruthaíonn triantáin mhogalra níos glaine, rud a fheabhsaíonn de ghnáth a oiriúnacht d’úsáidí ina dhiaidh sin amhail beochan nó priontáil 3D, ar chostas próiseála níos moille.
remesh_bandroghnach
Cineálnumber
Réamhshocrú1
0 – 4
Lamáltas gluaiseachta athmhúnlaithe: féadfaidh smúdáil bhreise mionsonraí míne a íobairt nuair a mhéadaítear an luach seo. Cuireann an socrú teorainn le díláithriú rinn i gcoibhneas leis an dromchla bunaidh.
remesh_projectroghnach
Cineálnumber
Réamhshocrú0
0 – 1
Neart teilgin chun na rinn athmhúnlaithe a thabhairt ar ais chuig an dromchla bunaidh: coinníonn 1 mionsonraí trí theilgin iomlán, agus fágann 0 an teilgin múchta le haghaidh toradh níos míne.
uv_unwrap_angle_threshold_degroghnach
Cineálnumber
Réamhshocrú90
0 – 180
Teorainn uillinne cairte UV i gcéimeanna, a chuireann srian leis an difríocht idir gnáthóga aghaidheanna comharsanacha laistigh de chairt amháin. Is fearr le teorainn níos airde níos lú cairteacha níos mó, agus baol sínte leis; is fearr le teorainn níos ísle níos mó cairteacha agus níos lú saobhadh.
uv_unwrap_refine_iterationsroghnach
Cineálinteger
Réamhshocrú0
0 – 10
Líon na bpasanna scagtha logánta a úsáidtear chun cairteacha UV a ríomh.
uv_unwrap_global_iterationsroghnach
Cineálinteger
Réamhshocrú1
1 – 10
Is féidir cothromaíocht chairte UV a fheabhsú tríd an líon seo de phasanna cnuasaithe domhanda a úsáidtear chun na cairteacha a ríomh a mhéadú.
uv_unwrap_smooth_strengthroghnach
Cineálnumber
Réamhshocrú1
0 – 10
Coigeartaigh cé chomh láidir agus a smúdaítear imill chairte UV; bíonn níos lú seams infheicthe ag socruithe níos airde, ach tá baol saobhadh UV ann.
image_urlriachtanach image
Cineálurl · image
URL a dhíríonn ar an íomhá foinse le haghaidh tiontú 3D.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
model_glb
object {url, content_type, file_name, file_size}Samhail 3D ginte i bhformáid GLB.

Tuilleadh samhlacha: Íomhá go 3D

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/trellis-2.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt