Ruka hadi kwenye maudhui
Kiswahili
Pata ufunguo wa API

Trellis 2

Unganisha

Kitambulisho cha modeli 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"

Ombi hili: $ 0.30 salio za API 300 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Microsoft Picha hadi 3D #image-to-3d

Hubadilisha picha moja kuwa mesh ya 3D ya GLB yenye tekstura, ikiwa na mipangilio inayoweza kurekebishwa ya muundo, umbo, tekstura na UV

OpenAPI Markdown
Microsoft · 3D

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

•inahitajika image_url
Dondosha faili, au

URL inayoelekeza kwenye picha chanzo kwa ubadilishaji wa 3D.

resolution chaguomsingi 1024

Mwonekano wa tokeo; kuuongeza huongeza maelezo lakini huchukua muda zaidi.

Ya kina 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 chaguomsingi 2048

Mwonekano wa texture ya mesh kwa baking. Maelezo bora ya uso huja na faili kubwa zaidi mwonekano huu unapoongezwa.

chaguomsingi 7.5

Udhibiti wa uaminifu wa muundo wa awali wa 3D: kuuongeza hupendelea ulinganifu wa karibu na picha ya ingizo, kwa hatari ya noise zaidi.

chaguomsingi 0.7

Udhibiti wa vizalia vya mwongozo wa hatua ya 1, ukibadilisha athari thabiti za mwongozo katika mipangilio ya chini kwa tokeo thabiti zaidi katika mipangilio ya juu.

chaguomsingi 0.6

Mpaka wa kuanzia wa dirisha la mwongozo wa classifier-free katika hatua ya 1 (muundo adimu), unaoonyeshwa kama sehemu ya kuondoa kelele. Setting ndogo huanza mwongozo mapema; ni kipindi cha interval_start hadi interval_end pekee kinachotumia mwongozo, huku uchakataji mwingine ukikosa mwongozo.

chaguomsingi 1

Kikomo cha mwongozo cha hatua ya 1 (muundo adimu): chagua thamani iliyo angalau sawa na ss_guidance_interval_start. Thamani hii huonyesha sehemu ya kuondoa kelele iliyofikiwa wakati mwongozo wa classifier-free unasitishwa.

chaguomsingi 12

Idadi ya hatua za kuondoa noise ya muundo wa awali: maboresho yanayowezekana ya ubora kutokana na hatua za ziada huambatana na uchakataji wa polepole.

chaguomsingi 5

Weka ukali wa mabadiliko kupitia ratiba ya noise ya uzalishaji wa muundo: kuongeza thamani hii hufanya mabadiliko kuwa makali zaidi.

chaguomsingi 7.5

Udhibiti wa uaminifu wa jiometri ya kina: kuongeza ufuasi wa picha ya ingizo huleta maelezo zaidi, kwa hatari ya noise iliyoongezwa.

chaguomsingi 0.5

Ongeza mpangilio huu jiometri inapoonekana kuwa na noise: hupunguza vizalia vinavyosababishwa na mwongozo thabiti wakati wa hatua ya umbo.

chaguomsingi 0.6

Sehemu ya kuamilisha mwongozo wa classifier-free kwa uboreshaji wa umbo katika hatua ya 2. Ikiwasilishwa kama sehemu ya maendeleo ya kuondoa kelele, huweka interval_start; mwongozo hufanya kazi ndani ya dirisha la interval_start na interval_end pekee.

chaguomsingi 1

Kikomo cha mwongozo cha hatua ya 2 (uboreshaji wa umbo): chagua thamani iliyo angalau sawa na shape_slat_guidance_interval_start. Thamani hii huonyesha sehemu ya kuondoa kelele iliyofikiwa wakati mwongozo wa classifier-free unasitishwa.

chaguomsingi 12

Idadi ya hatua za kuondoa noise za uboreshaji wa umbo: jiometri laini zaidi inayowezekana hugharimu kasi wakati wa kutumia hatua za ziada.

chaguomsingi 3

Weka ukali wa maelezo ya jiometri kupitia ratiba ya noise ya uboreshaji wa umbo; kuongeza thamani hii hutoa maelezo makali zaidi.

chaguomsingi 1

Udhibiti wa uaminifu wa rangi ya texture: ufuasi wa karibu zaidi wa rangi katika picha ya ingizo kwenye mipangilio ya juu huongeza uangavu lakini unaweza kusababisha rangi kuzidi.

chaguomsingi 0

Ongeza mpangilio huu kushughulikia textures zenye noise au color banding: hupunguza vizalia vinavyosababishwa na mwongozo thabiti wakati wa hatua ya texture.

chaguomsingi 0.6

Sehemu ya kuamilisha mwongozo wa classifier-free kwa uzalishaji wa umbile katika hatua ya 3. Ikiwasilishwa kama sehemu ya maendeleo ya kuondoa kelele, huweka interval_start; mwongozo hufanya kazi ndani ya dirisha la interval_start na interval_end pekee.

chaguomsingi 0.9

Kikomo cha mwongozo cha hatua ya 3 (umbile): chagua thamani iliyo angalau sawa na tex_slat_guidance_interval_start. Thamani hii huonyesha sehemu ya kuondoa kelele iliyofikiwa wakati mwongozo wa classifier-free unasitishwa.

chaguomsingi 12

Idadi ya hatua za kuondoa noise zinazotumika kuzalisha textures. Kuongeza idadi ya hatua huchukua muda zaidi lakini kunaweza kutoa textures safi zaidi.

chaguomsingi 3

Weka ukali wa maelezo ya texture kupitia ratiba ya noise ya uzalishaji wa texture; kuongeza thamani hii hutoa maelezo makali zaidi.

chaguomsingi 500000

Lengo la idadi ya vertex za mesh, ambapo 500k inapendekezwa kwa matumizi ya jumla na 20k–50k kwa wavuti/simu. Kupunguza lengo hubadilisha maelezo ya mesh kwa faili ndogo.

chaguomsingi 1

Kiwango cha kusogeza wakati wa kujenga mesh upya: ulainishaji wa ziada unaweza kupunguza maelezo madogo thamani hii inapoongezwa. Setting hii hupunguza uhamishaji wa vertex kulingana na uso wa awali.

chaguomsingi 0

Nguvu ya projection ya kurudisha vertex zilizoundwa upya kwenye uso wa awali: 1 huhifadhi maelezo kupitia projection kamili, huku 0 ikizima projection kwa tokeo laini zaidi.

chaguomsingi 90

Kikomo cha pembe ya chati ya UV kwa digrii, kinachozuia tofauti ya normals za nyuso jirani ndani ya chati moja. Kuongeza kikomo hupendelea chati chache kubwa, kwa hatari ya kunyoosha; kukipunguza hupendelea chati nyingi na upotoshaji mdogo.

chaguomsingi 0

Idadi ya hatua za uboreshaji wa ndani zinazotumika kukokotoa chati za UV.

chaguomsingi 1

Usawazishaji wa chati za UV unaweza kuboreshwa kwa kuongeza idadi hii ya hatua za clustering za kimataifa zinazotumika kukokotoa chati.

chaguomsingi 1

Rekebisha kiwango cha kulainisha kingo za chati za UV; mipasuko inayoonekana kidogo zaidi katika setting za juu huambatana na hatari ya upotoshaji wa UV.

Seed inayotumika kwa uzalishaji wa nasibu unaoweza kurudiwa.

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

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Trellis 2

Hujenga rasilimali ya 3D kutoka kwa picha moja (`image_url`) na kurudisha faili la GLB. `resolution` ni 512, 1024 au 1536, na `texture_size` ni 1024, 2048 au 4096. Kila moja ya hatua tatu (muundo, umbo, tekstura) ina vidhibiti vyake vya mwongozo na hatua za usampulishaji. `decimation_target` huweka idadi ya vipeo vya mesh (5,000 hadi 2,000,000), na chaguo za kurekebisha mesh pamoja na kufungua UV zinapatikana.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo
seedsi lazima
Ainainteger | null
Seed inayotumika kwa uzalishaji wa nasibu unaoweza kurudiwa.
resolutionsi lazima
Ainaenum
Chaguomsingi1024
51210241536
Mwonekano wa tokeo; kuuongeza huongeza maelezo lakini huchukua muda zaidi.
ss_guidance_strengthsi lazima
Ainanumber
Chaguomsingi7.5
0 – 10
Udhibiti wa uaminifu wa muundo wa awali wa 3D: kuuongeza hupendelea ulinganifu wa karibu na picha ya ingizo, kwa hatari ya noise zaidi.
ss_guidance_rescalesi lazima
Ainanumber
Chaguomsingi0.7
0 – 1
Udhibiti wa vizalia vya mwongozo wa hatua ya 1, ukibadilisha athari thabiti za mwongozo katika mipangilio ya chini kwa tokeo thabiti zaidi katika mipangilio ya juu.
ss_guidance_interval_startsi lazima
Ainanumber
Chaguomsingi0.6
0 – 1
Mpaka wa kuanzia wa dirisha la mwongozo wa classifier-free katika hatua ya 1 (muundo adimu), unaoonyeshwa kama sehemu ya kuondoa kelele. Setting ndogo huanza mwongozo mapema; ni kipindi cha interval_start hadi interval_end pekee kinachotumia mwongozo, huku uchakataji mwingine ukikosa mwongozo.
ss_guidance_interval_endsi lazima
Ainanumber
Chaguomsingi1
0 – 1
Kikomo cha mwongozo cha hatua ya 1 (muundo adimu): chagua thamani iliyo angalau sawa na ss_guidance_interval_start. Thamani hii huonyesha sehemu ya kuondoa kelele iliyofikiwa wakati mwongozo wa classifier-free unasitishwa.
ss_sampling_stepssi lazima
Ainainteger
Chaguomsingi12
1 – 50
Idadi ya hatua za kuondoa noise ya muundo wa awali: maboresho yanayowezekana ya ubora kutokana na hatua za ziada huambatana na uchakataji wa polepole.
ss_rescale_tsi lazima
Ainanumber
Chaguomsingi5
1 – 6
Weka ukali wa mabadiliko kupitia ratiba ya noise ya uzalishaji wa muundo: kuongeza thamani hii hufanya mabadiliko kuwa makali zaidi.
shape_slat_guidance_strengthsi lazima
Ainanumber
Chaguomsingi7.5
0 – 10
Udhibiti wa uaminifu wa jiometri ya kina: kuongeza ufuasi wa picha ya ingizo huleta maelezo zaidi, kwa hatari ya noise iliyoongezwa.
shape_slat_guidance_rescalesi lazima
Ainanumber
Chaguomsingi0.5
0 – 1
Ongeza mpangilio huu jiometri inapoonekana kuwa na noise: hupunguza vizalia vinavyosababishwa na mwongozo thabiti wakati wa hatua ya umbo.
shape_slat_guidance_interval_startsi lazima
Ainanumber
Chaguomsingi0.6
0 – 1
Sehemu ya kuamilisha mwongozo wa classifier-free kwa uboreshaji wa umbo katika hatua ya 2. Ikiwasilishwa kama sehemu ya maendeleo ya kuondoa kelele, huweka interval_start; mwongozo hufanya kazi ndani ya dirisha la interval_start na interval_end pekee.
shape_slat_guidance_interval_endsi lazima
Ainanumber
Chaguomsingi1
0 – 1
Kikomo cha mwongozo cha hatua ya 2 (uboreshaji wa umbo): chagua thamani iliyo angalau sawa na shape_slat_guidance_interval_start. Thamani hii huonyesha sehemu ya kuondoa kelele iliyofikiwa wakati mwongozo wa classifier-free unasitishwa.
shape_slat_sampling_stepssi lazima
Ainainteger
Chaguomsingi12
1 – 50
Idadi ya hatua za kuondoa noise za uboreshaji wa umbo: jiometri laini zaidi inayowezekana hugharimu kasi wakati wa kutumia hatua za ziada.
shape_slat_rescale_tsi lazima
Ainanumber
Chaguomsingi3
1 – 6
Weka ukali wa maelezo ya jiometri kupitia ratiba ya noise ya uboreshaji wa umbo; kuongeza thamani hii hutoa maelezo makali zaidi.
tex_slat_guidance_strengthsi lazima
Ainanumber
Chaguomsingi1
0 – 10
Udhibiti wa uaminifu wa rangi ya texture: ufuasi wa karibu zaidi wa rangi katika picha ya ingizo kwenye mipangilio ya juu huongeza uangavu lakini unaweza kusababisha rangi kuzidi.
tex_slat_guidance_rescalesi lazima
Ainanumber
Chaguomsingi0
0 – 1
Ongeza mpangilio huu kushughulikia textures zenye noise au color banding: hupunguza vizalia vinavyosababishwa na mwongozo thabiti wakati wa hatua ya texture.
tex_slat_guidance_interval_startsi lazima
Ainanumber
Chaguomsingi0.6
0 – 1
Sehemu ya kuamilisha mwongozo wa classifier-free kwa uzalishaji wa umbile katika hatua ya 3. Ikiwasilishwa kama sehemu ya maendeleo ya kuondoa kelele, huweka interval_start; mwongozo hufanya kazi ndani ya dirisha la interval_start na interval_end pekee.
tex_slat_guidance_interval_endsi lazima
Ainanumber
Chaguomsingi0.9
0 – 1
Kikomo cha mwongozo cha hatua ya 3 (umbile): chagua thamani iliyo angalau sawa na tex_slat_guidance_interval_start. Thamani hii huonyesha sehemu ya kuondoa kelele iliyofikiwa wakati mwongozo wa classifier-free unasitishwa.
tex_slat_sampling_stepssi lazima
Ainainteger
Chaguomsingi12
1 – 50
Idadi ya hatua za kuondoa noise zinazotumika kuzalisha textures. Kuongeza idadi ya hatua huchukua muda zaidi lakini kunaweza kutoa textures safi zaidi.
tex_slat_rescale_tsi lazima
Ainanumber
Chaguomsingi3
1 – 6
Weka ukali wa maelezo ya texture kupitia ratiba ya noise ya uzalishaji wa texture; kuongeza thamani hii hutoa maelezo makali zaidi.
decimation_targetsi lazima
Ainainteger
Chaguomsingi500000
5,000 – 2,000,000
Lengo la idadi ya vertex za mesh, ambapo 500k inapendekezwa kwa matumizi ya jumla na 20k–50k kwa wavuti/simu. Kupunguza lengo hubadilisha maelezo ya mesh kwa faili ndogo.
texture_sizesi lazima
Ainaenum
Chaguomsingi2048
102420484096
Mwonekano wa texture ya mesh kwa baking. Maelezo bora ya uso huja na faili kubwa zaidi mwonekano huu unapoongezwa.
remeshsi lazima
Ainaboolean
Chaguomsingitrue
Ujenzi upya wa topolojia unaounda pembetatu safi zaidi za mesh, kwa kawaida ukiboresha ufaafu kwa matumizi ya baadaye kama uhuishaji au uchapishaji wa 3D, kwa gharama ya uchakataji wa polepole.
remesh_bandsi lazima
Ainanumber
Chaguomsingi1
0 – 4
Kiwango cha kusogeza wakati wa kujenga mesh upya: ulainishaji wa ziada unaweza kupunguza maelezo madogo thamani hii inapoongezwa. Setting hii hupunguza uhamishaji wa vertex kulingana na uso wa awali.
remesh_projectsi lazima
Ainanumber
Chaguomsingi0
0 – 1
Nguvu ya projection ya kurudisha vertex zilizoundwa upya kwenye uso wa awali: 1 huhifadhi maelezo kupitia projection kamili, huku 0 ikizima projection kwa tokeo laini zaidi.
uv_unwrap_angle_threshold_degsi lazima
Ainanumber
Chaguomsingi90
0 – 180
Kikomo cha pembe ya chati ya UV kwa digrii, kinachozuia tofauti ya normals za nyuso jirani ndani ya chati moja. Kuongeza kikomo hupendelea chati chache kubwa, kwa hatari ya kunyoosha; kukipunguza hupendelea chati nyingi na upotoshaji mdogo.
uv_unwrap_refine_iterationssi lazima
Ainainteger
Chaguomsingi0
0 – 10
Idadi ya hatua za uboreshaji wa ndani zinazotumika kukokotoa chati za UV.
uv_unwrap_global_iterationssi lazima
Ainainteger
Chaguomsingi1
1 – 10
Usawazishaji wa chati za UV unaweza kuboreshwa kwa kuongeza idadi hii ya hatua za clustering za kimataifa zinazotumika kukokotoa chati.
uv_unwrap_smooth_strengthsi lazima
Ainanumber
Chaguomsingi1
0 – 10
Rekebisha kiwango cha kulainisha kingo za chati za UV; mipasuko inayoonekana kidogo zaidi katika setting za juu huambatana na hatari ya upotoshaji wa UV.
image_urlinahitajika image
Ainaurl · image
URL inayoelekeza kwenye picha chanzo kwa ubadilishaji wa 3D.
inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
model_glb
object {url, content_type, file_name, file_size}Modeli ya 3D inayozalishwa katika muundo wa GLB.

Miundo zaidi: Picha hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/trellis-2.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt