Sleppa yfir í efni

Trellis 2

Tengja

Auðkenni líkans 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"

Þessi beiðni: 0,30 $ 300 API-inneignir · ≈ 31,64 ₽ Keyra á þessari síðu

Fá API-lykil
Microsoft Mynd í 3D #image-to-3d

Breytir einni mynd í áferðarsett GLB-þrívíddarform með stillingum fyrir byggingu, lögun, áferð og UV

Microsoft · 3D

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

•áskilið image_url
Slepptu skrá eða

Vefslóð sem vísar á upprunamyndina fyrir 3D-umbreytingu.

resolution sjálfgefið 1024

Upplausn úttaksins; hærri upplausn bætir við smáatriðum en tekur lengri tíma.

Ítarlegt 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 sjálfgefið 2048

Upplausn möskvaáferðar fyrir baksetningu. Nákvæmari yfirborðssmáatriði skila stærri skrám þegar upplausnin er hækkuð.

sjálfgefið 7.5

Stýring á trúverðugleika upphaflegrar 3D-byggingar: hærra gildi samræmist inntaksmyndinni betur en getur aukið hávaða.

sjálfgefið 0.7

Stýring leiðsagnarmynda í stigi 1; lægri gildi gefa sterkari leiðsagnaráhrif en hærri gildi stöðugra úttak.

sjálfgefið 0.6

Upphafsmörk classifier-free guidance-gluggans á stigi 1 (gisin bygging), gefin upp sem hlutfall af afeitrun. Lægri stillingar hefja leiðsögn fyrr; aðeins bilið frá interval_start til interval_end notar leiðsögn, en vinnsla utan þess er án leiðsagnar.

sjálfgefið 1

Leiðsagnarmörk fyrir stig 1 (gisin bygging): veldu gildi sem er að minnsta kosti jafn stórt og ss_guidance_interval_start. Gildið tilgreinir það hlutfall af afeitrun þar sem classifier-free guidance stöðvast.

sjálfgefið 12

Fjöldi hávaðahreinsunarskrefa fyrir upphafsbyggingu: möguleg gæðabót af viðbótarskrefum kostar hægari vinnslu.

sjálfgefið 5

Stilltu skerpu umskipta með hávaðatímaáætlun byggingargerðar: hærra gildi gerir umskipti skarpari.

sjálfgefið 7.5

Stýring á trúverðugleika nákvæmrar rúmfræði: aukið samræmi við inntaksmyndina bætir við smáatriðum en getur aukið hávaða.

sjálfgefið 0.5

Hækkaðu þessa stillingu þegar rúmfræðin lítur út fyrir að vera hávær: hún dregur úr göllum sem sterk leiðsögn veldur á lögunarstiginu.

sjálfgefið 0.6

Virkjunarpunktur classifier-free guidance fyrir formfínun á stigi 2. Hann er gefinn upp sem hlutfall af framvindu afeitrunar og stillir interval_start; leiðsögn er aðeins virk innan gluggans sem interval_start og interval_end afmarka.

sjálfgefið 1

Leiðsagnarmörk fyrir stig 2 (formfínun): veldu gildi sem er að minnsta kosti jafn stórt og shape_slat_guidance_interval_start. Gildið tilgreinir það hlutfall af afeitrun þar sem classifier-free guidance stöðvast.

sjálfgefið 12

Fjöldi hávaðahreinsunarskrefa fyrir lögunarhreinsun: viðbótarskref geta gefið mýkri rúmfræði en á kostnað hraða.

sjálfgefið 3

Stilltu skerpu rúmfræðilegra smáatriða með hávaðatímaáætlun lögunarhreinsunar; hærra gildi skilar skarpari smáatriðum.

sjálfgefið 1

Stýring á litaáreiðanleika áferðar: meira samræmi við liti inntaksmyndarinnar við hærri gildi eykur litstyrk en getur valdið ofmettun.

sjálfgefið 0

Hækkaðu þessa stillingu til að bregðast við háværum áferðum eða litaböndum: hún dregur úr göllum sem sterk leiðsögn veldur á áferðarstiginu.

sjálfgefið 0.6

Virkjunarpunktur classifier-free guidance fyrir áferðargerð á stigi 3. Hann er gefinn upp sem hlutfall af framvindu afeitrunar og stillir interval_start; leiðsögn er aðeins virk innan gluggans sem interval_start og interval_end afmarka.

sjálfgefið 0.9

Leiðsagnarmörk fyrir stig 3 (áferð): veldu gildi sem er að minnsta kosti jafn stórt og tex_slat_guidance_interval_start. Gildið tilgreinir það hlutfall af afeitrun þar sem classifier-free guidance stöðvast.

sjálfgefið 12

Fjöldi hávaðahreinsunarskrefa sem notaður er til að búa til áferð. Hærri fjöldi tekur lengri tíma en getur skilað hreinni áferð.

sjálfgefið 3

Stilltu skerpu áferðarsmáatriða með hávaðatímaáætlun áferðargerðar; hærra gildi skilar skarpari smáatriðum.

sjálfgefið 500000

Markfjöldi hornpunkta möskva, þar sem 500k er ráðlagt fyrir almenna notkun og 20k–50k fyrir vef og farsíma. Lækkun marksins skiptir möskvasmáatriðum út fyrir minni skrár.

sjálfgefið 1

Hreyfisvigrúm við endurgerð möskva: aukin sléttun getur fórnað fínni smáatriðum þegar gildið hækkar. Stillingin takmarkar tilfærslu hornpunkta miðað við upprunalegt yfirborð.

sjálfgefið 0

Vörpunarstyrkur við að færa endurgerða hornpunkta aftur á upprunalegt yfirborð: 1 varðveitir smáatriði með fullri vörpun, en 0 slekkur á vörpun fyrir mýkri niðurstöðu.

sjálfgefið 90

Hornmörk UV-korts í gráðum sem takmarka muninn á normalvigurum nágrannaflata innan eins korts. Hækkun marksins styður færri og stærri kort með hættu á teygju; lækkun þess styður fleiri kort og minni bjögun.

sjálfgefið 0

Fjöldi staðbundinna fínunarlota sem notaðar eru til að reikna UV-kort.

sjálfgefið 1

Jafnvægi UV-korta má bæta með því að auka þennan fjölda hnattrænna klasalota sem notaðar eru til að reikna kortin.

sjálfgefið 1

Stilltu hversu sterkt brúnir UV-korta eru sléttaðar; minna sýnilegir samskeyti við hærri stillingar fylgja hætta á UV-bjögun.

Fræ notað fyrir endurtekningarhæfa slembna efnisgerð.

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

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um Trellis 2

Byggir þrívíddareign úr einni mynd (`image_url`) og skilar GLB-skrá. `resolution` er 512, 1024 eða 1536 og `texture_size` er 1024, 2048 eða 4096. Hvert þriggja stiga (bygging, lögun, áferð) hefur eigin stýringar fyrir leiðbeiningar og sýnatökuskref. `decimation_target` stillir fjölda hornpunkta formsins (5,000 til 2,000,000) og valkostir fyrir endurformun og UV-afvindingu eru í boði.

Færibreytur

Sendu annaðhvort samræmda heitið eða upprunalega heitið, ekki bæði. Samræmd heiti

HeitiGerð SjálfgefiðLeyfilegt Lýsing
seedvalfrjálst
Gerðinteger | null
Fræ notað fyrir endurtekningarhæfa slembna efnisgerð.
resolutionvalfrjálst
Gerðenum
Sjálfgefið1024
51210241536
Upplausn úttaksins; hærri upplausn bætir við smáatriðum en tekur lengri tíma.
ss_guidance_strengthvalfrjálst
Gerðnumber
Sjálfgefið7.5
0 – 10
Stýring á trúverðugleika upphaflegrar 3D-byggingar: hærra gildi samræmist inntaksmyndinni betur en getur aukið hávaða.
ss_guidance_rescalevalfrjálst
Gerðnumber
Sjálfgefið0.7
0 – 1
Stýring leiðsagnarmynda í stigi 1; lægri gildi gefa sterkari leiðsagnaráhrif en hærri gildi stöðugra úttak.
ss_guidance_interval_startvalfrjálst
Gerðnumber
Sjálfgefið0.6
0 – 1
Upphafsmörk classifier-free guidance-gluggans á stigi 1 (gisin bygging), gefin upp sem hlutfall af afeitrun. Lægri stillingar hefja leiðsögn fyrr; aðeins bilið frá interval_start til interval_end notar leiðsögn, en vinnsla utan þess er án leiðsagnar.
ss_guidance_interval_endvalfrjálst
Gerðnumber
Sjálfgefið1
0 – 1
Leiðsagnarmörk fyrir stig 1 (gisin bygging): veldu gildi sem er að minnsta kosti jafn stórt og ss_guidance_interval_start. Gildið tilgreinir það hlutfall af afeitrun þar sem classifier-free guidance stöðvast.
ss_sampling_stepsvalfrjálst
Gerðinteger
Sjálfgefið12
1 – 50
Fjöldi hávaðahreinsunarskrefa fyrir upphafsbyggingu: möguleg gæðabót af viðbótarskrefum kostar hægari vinnslu.
ss_rescale_tvalfrjálst
Gerðnumber
Sjálfgefið5
1 – 6
Stilltu skerpu umskipta með hávaðatímaáætlun byggingargerðar: hærra gildi gerir umskipti skarpari.
shape_slat_guidance_strengthvalfrjálst
Gerðnumber
Sjálfgefið7.5
0 – 10
Stýring á trúverðugleika nákvæmrar rúmfræði: aukið samræmi við inntaksmyndina bætir við smáatriðum en getur aukið hávaða.
shape_slat_guidance_rescalevalfrjálst
Gerðnumber
Sjálfgefið0.5
0 – 1
Hækkaðu þessa stillingu þegar rúmfræðin lítur út fyrir að vera hávær: hún dregur úr göllum sem sterk leiðsögn veldur á lögunarstiginu.
shape_slat_guidance_interval_startvalfrjálst
Gerðnumber
Sjálfgefið0.6
0 – 1
Virkjunarpunktur classifier-free guidance fyrir formfínun á stigi 2. Hann er gefinn upp sem hlutfall af framvindu afeitrunar og stillir interval_start; leiðsögn er aðeins virk innan gluggans sem interval_start og interval_end afmarka.
shape_slat_guidance_interval_endvalfrjálst
Gerðnumber
Sjálfgefið1
0 – 1
Leiðsagnarmörk fyrir stig 2 (formfínun): veldu gildi sem er að minnsta kosti jafn stórt og shape_slat_guidance_interval_start. Gildið tilgreinir það hlutfall af afeitrun þar sem classifier-free guidance stöðvast.
shape_slat_sampling_stepsvalfrjálst
Gerðinteger
Sjálfgefið12
1 – 50
Fjöldi hávaðahreinsunarskrefa fyrir lögunarhreinsun: viðbótarskref geta gefið mýkri rúmfræði en á kostnað hraða.
shape_slat_rescale_tvalfrjálst
Gerðnumber
Sjálfgefið3
1 – 6
Stilltu skerpu rúmfræðilegra smáatriða með hávaðatímaáætlun lögunarhreinsunar; hærra gildi skilar skarpari smáatriðum.
tex_slat_guidance_strengthvalfrjálst
Gerðnumber
Sjálfgefið1
0 – 10
Stýring á litaáreiðanleika áferðar: meira samræmi við liti inntaksmyndarinnar við hærri gildi eykur litstyrk en getur valdið ofmettun.
tex_slat_guidance_rescalevalfrjálst
Gerðnumber
Sjálfgefið0
0 – 1
Hækkaðu þessa stillingu til að bregðast við háværum áferðum eða litaböndum: hún dregur úr göllum sem sterk leiðsögn veldur á áferðarstiginu.
tex_slat_guidance_interval_startvalfrjálst
Gerðnumber
Sjálfgefið0.6
0 – 1
Virkjunarpunktur classifier-free guidance fyrir áferðargerð á stigi 3. Hann er gefinn upp sem hlutfall af framvindu afeitrunar og stillir interval_start; leiðsögn er aðeins virk innan gluggans sem interval_start og interval_end afmarka.
tex_slat_guidance_interval_endvalfrjálst
Gerðnumber
Sjálfgefið0.9
0 – 1
Leiðsagnarmörk fyrir stig 3 (áferð): veldu gildi sem er að minnsta kosti jafn stórt og tex_slat_guidance_interval_start. Gildið tilgreinir það hlutfall af afeitrun þar sem classifier-free guidance stöðvast.
tex_slat_sampling_stepsvalfrjálst
Gerðinteger
Sjálfgefið12
1 – 50
Fjöldi hávaðahreinsunarskrefa sem notaður er til að búa til áferð. Hærri fjöldi tekur lengri tíma en getur skilað hreinni áferð.
tex_slat_rescale_tvalfrjálst
Gerðnumber
Sjálfgefið3
1 – 6
Stilltu skerpu áferðarsmáatriða með hávaðatímaáætlun áferðargerðar; hærra gildi skilar skarpari smáatriðum.
decimation_targetvalfrjálst
Gerðinteger
Sjálfgefið500000
5.000 – 2.000.000
Markfjöldi hornpunkta möskva, þar sem 500k er ráðlagt fyrir almenna notkun og 20k–50k fyrir vef og farsíma. Lækkun marksins skiptir möskvasmáatriðum út fyrir minni skrár.
texture_sizevalfrjálst
Gerðenum
Sjálfgefið2048
102420484096
Upplausn möskvaáferðar fyrir baksetningu. Nákvæmari yfirborðssmáatriði skila stærri skrám þegar upplausnin er hækkuð.
remeshvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Endurbygging grannfræði sem býr til hreinni möskvaþríhyrninga og bætir yfirleitt hæfi fyrir síðari notkun, svo sem hreyfimyndir eða 3D-prentun, á kostnað hægari vinnslu.
remesh_bandvalfrjálst
Gerðnumber
Sjálfgefið1
0 – 4
Hreyfisvigrúm við endurgerð möskva: aukin sléttun getur fórnað fínni smáatriðum þegar gildið hækkar. Stillingin takmarkar tilfærslu hornpunkta miðað við upprunalegt yfirborð.
remesh_projectvalfrjálst
Gerðnumber
Sjálfgefið0
0 – 1
Vörpunarstyrkur við að færa endurgerða hornpunkta aftur á upprunalegt yfirborð: 1 varðveitir smáatriði með fullri vörpun, en 0 slekkur á vörpun fyrir mýkri niðurstöðu.
uv_unwrap_angle_threshold_degvalfrjálst
Gerðnumber
Sjálfgefið90
0 – 180
Hornmörk UV-korts í gráðum sem takmarka muninn á normalvigurum nágrannaflata innan eins korts. Hækkun marksins styður færri og stærri kort með hættu á teygju; lækkun þess styður fleiri kort og minni bjögun.
uv_unwrap_refine_iterationsvalfrjálst
Gerðinteger
Sjálfgefið0
0 – 10
Fjöldi staðbundinna fínunarlota sem notaðar eru til að reikna UV-kort.
uv_unwrap_global_iterationsvalfrjálst
Gerðinteger
Sjálfgefið1
1 – 10
Jafnvægi UV-korta má bæta með því að auka þennan fjölda hnattrænna klasalota sem notaðar eru til að reikna kortin.
uv_unwrap_smooth_strengthvalfrjálst
Gerðnumber
Sjálfgefið1
0 – 10
Stilltu hversu sterkt brúnir UV-korta eru sléttaðar; minna sýnilegir samskeyti við hærri stillingar fylgja hætta á UV-bjögun.
image_urláskilið image
Gerðurl · image
Vefslóð sem vísar á upprunamyndina fyrir 3D-umbreytingu.
áskilið Samræmt heiti, einnig samþykkt

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

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"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
model_glb
object {url, content_type, file_name, file_size}3D-líkan gert á GLB-sniði.

Fleiri líkön: Mynd í 3D

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/trellis-2.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt