Aqbeż għall-kontenut

Trellis 2

Integra

Id tal-mudell 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"

Din it-talba: $0.30 300 krediti tal-API Ħaddmu f’din il-paġna

Ikseb ċavetta API
Microsoft Immaġni għal 3D #image-to-3d

Jibdel immaġni waħda f’mesh 3D GLB b’tessut, b’settings aġġustabbli għall-istruttura, il-forma, it-tessut u l-UV

Microsoft · 3D

L-ewwel riżultat tiegħek jidher hawn

Ibni talba hawn taħt u ħaddimha biċ-ċavetta API tiegħek. L-outputs jiġu kkupjati fil-ħażna tagħna, miżmuma għal dejjem jew 7 ijiem b’xejn.

Ibni talba

Il-kontrolli jiġu ġġenerati mill-iskema tal-mudell. Il-kodiċi u l-prezz jaġġornaw hekk kif tibdilhom.

•meħtieġ image_url
Waqqa’ fajl, jew

URL li jindika l-immaġni sors għall-konverżjoni 3D.

resolution prestabbilit 1024

Riżoluzzjoni tal-output; iż-żieda tagħha żżid id-dettall iżda tieħu aktar ħin.

Avvanzat 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 prestabbilit 2048

Riżoluzzjoni tan-nisġa tal-mesh għall-baking. Daqs akbar ta’ fajl jirriżulta minn dettall tal-wiċċ aktar fin meta tiżdied din ir-riżoluzzjoni.

prestabbilit 7.5

Kontroll tal-fedeltà tal-istruttura 3D inizjali: iż-żieda tagħha tiffavorixxi qbil eqreb mal-immaġni input bir-riskju ta’ aktar storbju.

prestabbilit 0.7

Kontroll tal-artifacts tal-gwida fl-istadju 1, li jibbilanċja effetti ta’ gwida aktar b’saħħithom f’settings baxxi ma’ output aktar stabbli f’settings għoljin.

prestabbilit 0.6

Il-konfini tal-bidu tat-tieqa tal-gwida mingħajr klassifikatur fl-istadju 1 (struttura skarsa), espressa bħala frazzjoni tad-denoising. Settings aktar baxxi jibdew il-gwida qabel; l-intervall biss minn interval_start sa interval_end juża l-gwida, filwaqt li l-ipproċessar x'imkien ieħor isir mingħajrha.

prestabbilit 1

Limitu tal-gwida għall-istadju 1 (struttura skarsa): agħżel valur mill-inqas daqs ss_guidance_interval_start. Il-valur jidentifika l-frazzjoni tad-denoising li tintlaħaq meta tieqaf il-gwida mingħajr klassifikatur.

prestabbilit 12

Għadd tad-denoising tal-istruttura inizjali: titjib potenzjali fil-kwalità minn passi addizzjonali jġib ipproċessar aktar bil-mod.

prestabbilit 5

Issettja l-qawwa tat-tranżizzjoni permezz tal-iskeda tal-istorbju tal-ġenerazzjoni tal-istruttura: iż-żieda ta’ dan il-valur tagħmel it-tranżizzjonijiet aktar qawwija.

prestabbilit 7.5

Kontroll tal-fedeltà tal-ġeometrija dettaljata: aderenza akbar mal-immaġni input iżżid id-dettall, bir-riskju ta’ aktar storbju.

prestabbilit 0.5

Żid dan l-issettjar meta l-ġeometrija tidher storbjuża: inaqqas l-artifacts ikkawżati minn gwida qawwija matul l-istadju tal-forma.

prestabbilit 0.6

Punt ta' attivazzjoni tal-gwida mingħajr klassifikatur għar-raffinar tal-forma fl-istadju 2. Espress bħala frazzjoni tal-progress tad-denoising, jistabbilixxi interval_start; il-gwida topera biss fit-tieqa delimitata minn interval_start u interval_end.

prestabbilit 1

Limitu tal-gwida għall-istadju 2 (raffinar tal-forma): agħżel valur mill-inqas daqs shape_slat_guidance_interval_start. Il-valur jidentifika l-frazzjoni tad-denoising li tintlaħaq meta tieqaf il-gwida mingħajr klassifikatur.

prestabbilit 12

Għadd tad-denoising tar-raffinament tal-forma: ġeometrija potenzjalment aktar lixxa tiġi bi spiża fil-veloċità meta jintużaw passi addizzjonali.

prestabbilit 3

Issettja l-qawwa tad-dettall ġeometriku permezz tal-iskeda tal-istorbju tar-raffinament tal-forma; iż-żieda ta’ dan il-valur tagħti dettalji aktar qawwija.

prestabbilit 1

Kontroll tal-fedeltà tal-kulur tan-nisġa: aderenza eqreb mal-kuluri fl-immaġni input f’settings ogħla żżid il-vividità iżda tista’ tikkawża saturazzjoni żejda.

prestabbilit 0

Żid dan l-issettjar biex tindirizza nisġiet storbjużi jew banding tal-kulur: inaqqas l-artifacts ikkawżati minn gwida qawwija matul l-istadju tan-nisġa.

prestabbilit 0.6

Punt ta' attivazzjoni tal-gwida mingħajr klassifikatur għall-ġenerazzjoni tan-nisġa fl-istadju 3. Espress bħala frazzjoni tal-progress tad-denoising, jistabbilixxi interval_start; il-gwida topera biss fit-tieqa delimitata minn interval_start u interval_end.

prestabbilit 0.9

Limitu tal-gwida għall-istadju 3 (nisġa): agħżel valur mill-inqas daqs tex_slat_guidance_interval_start. Il-valur jidentifika l-frazzjoni tad-denoising li tintlaħaq meta tieqaf il-gwida mingħajr klassifikatur.

prestabbilit 12

Għadd tal-passi tad-denoising użati biex jinħolqu n-nisġiet. Iż-żieda tal-għadd tal-passi tieħu aktar ħin iżda tista’ tagħti nisġiet aktar nodfa.

prestabbilit 3

Issettja l-qawwa tad-dettall tan-nisġa permezz tal-iskeda tal-istorbju tal-ġenerazzjoni tan-nisġa; iż-żieda ta’ dan il-valur tagħti dettalji aktar qawwija.

prestabbilit 500000

Mira għall-għadd tal-vertiċi tal-malja, b'500k rakkomandat għall-użu ġenerali u 20k–50k għall-web/mowbajl. It-tnaqqis tal-mira jiskambja d-dettall tal-malja ma' fajls iżgħar.

prestabbilit 1

Allowance għall-moviment tar-remeshing: smoothing addizzjonali jista' jissagrifika d-dettall fin meta jiżdied dan il-valur. Is-setting jillimita l-ispostament tal-vertiċi relattiv għall-wiċċ oriġinali.

prestabbilit 0

Qawwa tal-projezzjoni biex il-vertiċi remeshed jerġgħu lura għall-wiċċ oriġinali: 1 iżomm id-dettall permezz ta' projezzjoni sħiħa, filwaqt li 0 iħalli l-projezzjoni mitfija għal riżultat aktar lixx.

prestabbilit 90

Limitu tal-angolu tal-grafika UV fi gradi, li jirrestrinġi kemm jistgħu jvarjaw in-normali tal-uċuħ ġirien fi grafika waħda. Żieda fil-limitu tiffavorixxi grafiċi inqas u akbar bir-riskju ta' stretching; tnaqqis tiegħu jiffavorixxi aktar grafiċi u inqas distorsjoni.

prestabbilit 0

Għadd ta' passes ta' raffinar lokali użati biex jiġu kkalkulati l-grafiċi UV.

prestabbilit 1

Il-bilanċ tal-grafika UV jista' jitjieb billi jiżdied dan l-għadd ta' passes ta' clustering globali użati biex jiġu kkalkulati l-grafiċi.

prestabbilit 1

Aġġusta kemm jittaffew b'mod qawwi t-truf tal-grafika UV; ħjatat inqas viżibbli f'settings ogħla jġibu magħhom riskju ta' distorsjoni UV.

Seed użat għall-ġenerazzjoni każwali riproduċibbli.

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

Ħaddem din it-talba

Iċ-ċavetta tiegħek tibqa’ f’dan il-browser: tintbagħat biss lid-Doitong API u tiġi ssejvjata (localStorage) biss jekk timmarka Ftakar. Ikseb ċavetta API

Dwar Trellis 2

Jibni asset 3D minn immaġni waħda (`image_url`) u jirritorna fajl GLB. `resolution` huwa 512, 1024 jew 1536, u `texture_size` huwa 1024, 2048 jew 4096. Kull wieħed mit-tliet stadji (structure, shape, texture) għandu kontrolli tiegħu għall-guidance u l-passi tat-teħid tal-kampjuni. `decimation_target` jistabbilixxi l-għadd ta’ vertiċi tal-mesh (5,000 sa 2,000,000), u huma esposti għażliet għar-remeshing u l-UV-unwrapping.

Parametri

Ibgħat jew l-isem kanoniku jew l-isem nattiv, mhux it-tnejn. Ismijiet kanoniċi

IsemTip PrestabbilitPermess Deskrizzjoni
seedmhux obbligatorju
Tipinteger | null
Seed użat għall-ġenerazzjoni każwali riproduċibbli.
resolutionmhux obbligatorju
Tipenum
Prestabbilit1024
51210241536
Riżoluzzjoni tal-output; iż-żieda tagħha żżid id-dettall iżda tieħu aktar ħin.
ss_guidance_strengthmhux obbligatorju
Tipnumber
Prestabbilit7.5
0 – 10
Kontroll tal-fedeltà tal-istruttura 3D inizjali: iż-żieda tagħha tiffavorixxi qbil eqreb mal-immaġni input bir-riskju ta’ aktar storbju.
ss_guidance_rescalemhux obbligatorju
Tipnumber
Prestabbilit0.7
0 – 1
Kontroll tal-artifacts tal-gwida fl-istadju 1, li jibbilanċja effetti ta’ gwida aktar b’saħħithom f’settings baxxi ma’ output aktar stabbli f’settings għoljin.
ss_guidance_interval_startmhux obbligatorju
Tipnumber
Prestabbilit0.6
0 – 1
Il-konfini tal-bidu tat-tieqa tal-gwida mingħajr klassifikatur fl-istadju 1 (struttura skarsa), espressa bħala frazzjoni tad-denoising. Settings aktar baxxi jibdew il-gwida qabel; l-intervall biss minn interval_start sa interval_end juża l-gwida, filwaqt li l-ipproċessar x'imkien ieħor isir mingħajrha.
ss_guidance_interval_endmhux obbligatorju
Tipnumber
Prestabbilit1
0 – 1
Limitu tal-gwida għall-istadju 1 (struttura skarsa): agħżel valur mill-inqas daqs ss_guidance_interval_start. Il-valur jidentifika l-frazzjoni tad-denoising li tintlaħaq meta tieqaf il-gwida mingħajr klassifikatur.
ss_sampling_stepsmhux obbligatorju
Tipinteger
Prestabbilit12
1 – 50
Għadd tad-denoising tal-istruttura inizjali: titjib potenzjali fil-kwalità minn passi addizzjonali jġib ipproċessar aktar bil-mod.
ss_rescale_tmhux obbligatorju
Tipnumber
Prestabbilit5
1 – 6
Issettja l-qawwa tat-tranżizzjoni permezz tal-iskeda tal-istorbju tal-ġenerazzjoni tal-istruttura: iż-żieda ta’ dan il-valur tagħmel it-tranżizzjonijiet aktar qawwija.
shape_slat_guidance_strengthmhux obbligatorju
Tipnumber
Prestabbilit7.5
0 – 10
Kontroll tal-fedeltà tal-ġeometrija dettaljata: aderenza akbar mal-immaġni input iżżid id-dettall, bir-riskju ta’ aktar storbju.
shape_slat_guidance_rescalemhux obbligatorju
Tipnumber
Prestabbilit0.5
0 – 1
Żid dan l-issettjar meta l-ġeometrija tidher storbjuża: inaqqas l-artifacts ikkawżati minn gwida qawwija matul l-istadju tal-forma.
shape_slat_guidance_interval_startmhux obbligatorju
Tipnumber
Prestabbilit0.6
0 – 1
Punt ta' attivazzjoni tal-gwida mingħajr klassifikatur għar-raffinar tal-forma fl-istadju 2. Espress bħala frazzjoni tal-progress tad-denoising, jistabbilixxi interval_start; il-gwida topera biss fit-tieqa delimitata minn interval_start u interval_end.
shape_slat_guidance_interval_endmhux obbligatorju
Tipnumber
Prestabbilit1
0 – 1
Limitu tal-gwida għall-istadju 2 (raffinar tal-forma): agħżel valur mill-inqas daqs shape_slat_guidance_interval_start. Il-valur jidentifika l-frazzjoni tad-denoising li tintlaħaq meta tieqaf il-gwida mingħajr klassifikatur.
shape_slat_sampling_stepsmhux obbligatorju
Tipinteger
Prestabbilit12
1 – 50
Għadd tad-denoising tar-raffinament tal-forma: ġeometrija potenzjalment aktar lixxa tiġi bi spiża fil-veloċità meta jintużaw passi addizzjonali.
shape_slat_rescale_tmhux obbligatorju
Tipnumber
Prestabbilit3
1 – 6
Issettja l-qawwa tad-dettall ġeometriku permezz tal-iskeda tal-istorbju tar-raffinament tal-forma; iż-żieda ta’ dan il-valur tagħti dettalji aktar qawwija.
tex_slat_guidance_strengthmhux obbligatorju
Tipnumber
Prestabbilit1
0 – 10
Kontroll tal-fedeltà tal-kulur tan-nisġa: aderenza eqreb mal-kuluri fl-immaġni input f’settings ogħla żżid il-vividità iżda tista’ tikkawża saturazzjoni żejda.
tex_slat_guidance_rescalemhux obbligatorju
Tipnumber
Prestabbilit0
0 – 1
Żid dan l-issettjar biex tindirizza nisġiet storbjużi jew banding tal-kulur: inaqqas l-artifacts ikkawżati minn gwida qawwija matul l-istadju tan-nisġa.
tex_slat_guidance_interval_startmhux obbligatorju
Tipnumber
Prestabbilit0.6
0 – 1
Punt ta' attivazzjoni tal-gwida mingħajr klassifikatur għall-ġenerazzjoni tan-nisġa fl-istadju 3. Espress bħala frazzjoni tal-progress tad-denoising, jistabbilixxi interval_start; il-gwida topera biss fit-tieqa delimitata minn interval_start u interval_end.
tex_slat_guidance_interval_endmhux obbligatorju
Tipnumber
Prestabbilit0.9
0 – 1
Limitu tal-gwida għall-istadju 3 (nisġa): agħżel valur mill-inqas daqs tex_slat_guidance_interval_start. Il-valur jidentifika l-frazzjoni tad-denoising li tintlaħaq meta tieqaf il-gwida mingħajr klassifikatur.
tex_slat_sampling_stepsmhux obbligatorju
Tipinteger
Prestabbilit12
1 – 50
Għadd tal-passi tad-denoising użati biex jinħolqu n-nisġiet. Iż-żieda tal-għadd tal-passi tieħu aktar ħin iżda tista’ tagħti nisġiet aktar nodfa.
tex_slat_rescale_tmhux obbligatorju
Tipnumber
Prestabbilit3
1 – 6
Issettja l-qawwa tad-dettall tan-nisġa permezz tal-iskeda tal-istorbju tal-ġenerazzjoni tan-nisġa; iż-żieda ta’ dan il-valur tagħti dettalji aktar qawwija.
decimation_targetmhux obbligatorju
Tipinteger
Prestabbilit500000
5,000 – 2,000,000
Mira għall-għadd tal-vertiċi tal-malja, b'500k rakkomandat għall-użu ġenerali u 20k–50k għall-web/mowbajl. It-tnaqqis tal-mira jiskambja d-dettall tal-malja ma' fajls iżgħar.
texture_sizemhux obbligatorju
Tipenum
Prestabbilit2048
102420484096
Riżoluzzjoni tan-nisġa tal-mesh għall-baking. Daqs akbar ta’ fajl jirriżulta minn dettall tal-wiċċ aktar fin meta tiżdied din ir-riżoluzzjoni.
remeshmhux obbligatorju
Tipboolean
Prestabbilittrue
Bini mill-ġdid tat-topoloġija li joħloq triangoli tal-malja aktar nodfa, u ġeneralment itejjeb l-adegwatezza għal użi sussegwenti bħall-animazzjoni jew l-istampar 3D, bi spiża ta' ipproċessar aktar bil-mod.
remesh_bandmhux obbligatorju
Tipnumber
Prestabbilit1
0 – 4
Allowance għall-moviment tar-remeshing: smoothing addizzjonali jista' jissagrifika d-dettall fin meta jiżdied dan il-valur. Is-setting jillimita l-ispostament tal-vertiċi relattiv għall-wiċċ oriġinali.
remesh_projectmhux obbligatorju
Tipnumber
Prestabbilit0
0 – 1
Qawwa tal-projezzjoni biex il-vertiċi remeshed jerġgħu lura għall-wiċċ oriġinali: 1 iżomm id-dettall permezz ta' projezzjoni sħiħa, filwaqt li 0 iħalli l-projezzjoni mitfija għal riżultat aktar lixx.
uv_unwrap_angle_threshold_degmhux obbligatorju
Tipnumber
Prestabbilit90
0 – 180
Limitu tal-angolu tal-grafika UV fi gradi, li jirrestrinġi kemm jistgħu jvarjaw in-normali tal-uċuħ ġirien fi grafika waħda. Żieda fil-limitu tiffavorixxi grafiċi inqas u akbar bir-riskju ta' stretching; tnaqqis tiegħu jiffavorixxi aktar grafiċi u inqas distorsjoni.
uv_unwrap_refine_iterationsmhux obbligatorju
Tipinteger
Prestabbilit0
0 – 10
Għadd ta' passes ta' raffinar lokali użati biex jiġu kkalkulati l-grafiċi UV.
uv_unwrap_global_iterationsmhux obbligatorju
Tipinteger
Prestabbilit1
1 – 10
Il-bilanċ tal-grafika UV jista' jitjieb billi jiżdied dan l-għadd ta' passes ta' clustering globali użati biex jiġu kkalkulati l-grafiċi.
uv_unwrap_smooth_strengthmhux obbligatorju
Tipnumber
Prestabbilit1
0 – 10
Aġġusta kemm jittaffew b'mod qawwi t-truf tal-grafika UV; ħjatat inqas viżibbli f'settings ogħla jġibu magħhom riskju ta' distorsjoni UV.
image_urlmeħtieġ image
Tipurl · image
URL li jindika l-immaġni sors għall-konverżjoni 3D.
meħtieġ Isem kanoniku, aċċettat ukoll

Il-parametri tal-fajls jaċċettaw URL pubbliku https://, URI data: sa 10 MB, jew file_url ta’ upload. Fajls

Output

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"
  }
}
Il-fajls tiegħek, l-għażla tiegħekKull outputs[].url huwa kopja fil-ħażna tagħna: miżmuma għal dejjem (imħallsa għal kull GB-xahar) jew 7 ijiem b’xejn, skont l-issettjar tal-kont tiegħek jew ?storage=.
L-istess struttura fuq kull mudelltype, url, content_type, width, height u duration, kemm għall-immaġnijiet kif ukoll għall-vidjo u l-awdjo. output huwa l-oġġett tar-riżultat tal-mudell innifsu.
Oqsma tal-output
model_glb
object {url, content_type, file_name, file_size}Mudell 3D iġġenerat f’format GLB.

Aktar mudelli: Immaġni għal 3D

Għall-aġenti tal-AI: din il-paġna bħala Markdown tinsab fuq https://doitong.com/mt/developers/models/trellis-2.md. Il-mudelli u l-gwidi kollha: https://doitong.com/developers/llms.txt