Peke ki ngā ihirangi

Trellis 2

Whakauru

id tauira 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"

Tēnei tono: $ 0.30 300 whiwhinga API Whakahaerehia ki tēnei whārangi

Tikina he kī API
Microsoft Atahanga ki te 3D #image-to-3d

Ka huri i tētahi atahanga kotahi hei mata GLB 3D kakano, me ngā tautuhinga hanganga, āhua, kakano me UV ka taea te whakatika

Microsoft · 3D

Kei konei tō hua tuatahi

Hangaia he tono ki raro nei, ka whakahaere mā tō kī API. Ka tāruatia ngā putanga ki tō mātou rokiroki, ka puritia mō ake tonu atu, mō rānei 7 rā mō te kore utu.

Hangaia he tono

Ka hangaia ngā mana whakahaere mai i te aronuinga o te tauira. Ka whakahoungia te waehere me te utu ina whakarerekē koe.

•e hiahiatia ana image_url
Whakataka he kōnae,

Te URL e tohu ana ki te atahanga pūtake mō te panoni 3D.

resolution taunoa 1024

Te taumira o te putanga; mā te whakanui ake ka tāpirihia he taipitopito, engari ka roa ake.

Arā atu 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 taunoa 2048

Te taumira kakano mata mō te baking. Mā te whakanui i tēnei taumira ka tino taipitopito ake te mata, engari ka nui ake ngā kōnae.

taunoa 7.5

Te whakahaere pono o te hanganga 3D tuatahi: mā te whakanui ake ka tino rite ake ki te atahanga tāuru, engari ka nui ake pea te haruru.

taunoa 0.7

Te whakahaere ārahi-hanga-kino o te wāhanga 1, e whakawhiti ana i ngā pānga ārahi kaha i ngā tautuhinga iti ki te putanga pūmau ake i ngā tautuhinga nui.

taunoa 0.6

Tāhawhā tīmatanga o te matapihi aratohu classifier-free i te wāhanga 1 (hanganga kōrere), hei hautanga tango-haruru. Mā ngā tautuhinga iti ake e tīmata wawe ai te aratohu; ko te wāhanga anake mai i interval_start ki interval_end ka whakamahi aratohu, ā, he tukatuka kore-aratohu kei wāhi kē.

taunoa 1

Tapahi aratohu mō te wāhanga 1 (hanganga kōrere): kōwhiria he uara kia nui ake, kia ōrite rānei ki ss_guidance_interval_start. Ka tohu te uara i te hautanga o te tango-haruru kua tae atu ina mutu te aratohu classifier-free.

taunoa 12

Te tatau denoising o te hanganga tuatahi: ka taea te whakanui kounga mā ngā hipanga tāpiri, engari ka pōturi ake te tukatuka.

taunoa 5

Tautuhia te koi o te whakawhitinga mā te wātaka haruru whakaputa-hanganga: mā te whakanui ake ka koi ake ngā whakawhitinga.

taunoa 7.5

Te whakahaere pono o te āhuahanga taipitopito: mā te piri ake ki te atahanga tāuru ka tāpirihia he taipitopito, engari ka nui ake pea te haruru.

taunoa 0.5

Whakanuia tēnei tautuhinga ina haruru te āhuahanga: ka whakaiti i ngā hanga-kino nā te ārahi kaha i te wāhanga hanga.

taunoa 0.6

Pūwāhi whakahohe aratohu classifier-free mō te whakamahine āhua i te wāhanga 2. Hei hautanga o te ahunga whakamua tango-haruru, ka whakarite i interval_start; ka mahi te aratohu i roto anake i te matapihi kei waenga i interval_start me interval_end.

taunoa 1

Tapahi aratohu mō te wāhanga 2 (whakamahine āhua): kōwhiria he uara kia nui ake, kia ōrite rānei ki shape_slat_guidance_interval_start. Ka tohu te uara i te hautanga o te tango-haruru kua tae atu ina mutu te aratohu classifier-free.

taunoa 12

Te tatau denoising whakamahine-hanga: ka pai ake pea te māeneene o te āhuahanga, engari ka heke te tere ina whakamahia ngā hipanga tāpiri.

taunoa 3

Tautuhia te koi taipitopito āhuahanga mā te wātaka haruru whakamahine-hanga; mā te whakanui ake ka koi ake ngā taipitopito.

taunoa 1

Te whakahaere pono tae kakano: mā te piri ake ki ngā tae o te atahanga tāuru i ngā tautuhinga nui ka kaha ake te kanapa, engari ka nui rawa pea te kukū.

taunoa 0

Whakanuia tēnei tautuhinga hei whakatika i ngā kakano haruru, i te tāhei tae rānei: ka whakaiti i ngā hanga-kino nā te ārahi kaha i te wāhanga kakano.

taunoa 0.6

Pūwāhi whakahohe aratohu classifier-free mō te whakaputa kakano i te wāhanga 3. Hei hautanga o te ahunga whakamua tango-haruru, ka whakarite i interval_start; ka mahi te aratohu i roto anake i te matapihi kei waenga i interval_start me interval_end.

taunoa 0.9

Tapahi aratohu mō te wāhanga 3 (kakano): kōwhiria he uara kia nui ake, kia ōrite rānei ki tex_slat_guidance_interval_start. Ka tohu te uara i te hautanga o te tango-haruru kua tae atu ina mutu te aratohu classifier-free.

taunoa 12

Te maha o ngā hipanga denoising hei whakaputa kakano. Mā te whakanui i te tatau hipanga ka roa ake, engari ka mā ake pea ngā kakano.

taunoa 3

Tautuhia te koi taipitopito kakano mā te wātaka haruru whakaputa-kakano; mā te whakanui ake ka koi ake ngā taipitopito.

taunoa 500000

Ūnga tatau pūwāhi kupenga, 500k e tūtohua ana mō te whakamahinga whānui, 20k–50k mō te tukutuku/pūkoro. Mā te whakaiti i te ūnga ka whakawhiti taipitopito kupenga mō ngā kōnae iti ake.

taunoa 1

Whakaaetanga nekehanga hanga anō: ka nui ake te māeneene, engari ka ngaro pea ngā taipitopito pai ina whakanuia tēnei uara. Ka herea e te tautuhinga te nekehanga pūwāhi ki te mata taketake.

taunoa 0

Kaha matapae mō te whakahoki i ngā pūwāhi kua hanga anō ki te mata taketake: mā te 1 ka pupuri taipitopito mā te matapae katoa, mā te 0 ka whakaweto te matapae mō te putanga māeneene ake.

taunoa 90

Tepe koki UV chart i ngā nekehanga, hei here i te rerekētanga o ngā pūtoro mata pātata i roto i tētahi chart. Mā te whakanui ka pai ake ngā chart iti ake, nui ake, engari ka tūpono totoro; mā te whakaiti ka pai ake ngā chart maha ake me te iti o te kōaro.

taunoa 0

Te tatau o ngā paahitanga whakamahine ā-rohe hei tātai i ngā UV charts.

taunoa 1

Ka taea te whakapai i te taurite UV chart mā te whakanui i tēnei tatau o ngā paahitanga whakarōpū ā-ao hei tātai i ngā charts.

taunoa 1

Whakaritea te kaha whakaene i ngā tapa UV chart; he iti ake ngā tui kitea ki ngā tautuhinga teitei, engari ka tūpono kōaro te UV.

Te kākano e whakamahia ana mō te whakaputa matapōkere tukurua.

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

Whakahaerehia tēnei tono

Ka noho tō kī ki tēnei pūtirotiro: ka tukuna ki te Doitong API anake, ā, ka tiakina ki te localStorage anake ina tohua e koe te Mahara. Tikina he kī API

Mō Trellis 2

Ka hanga rawa 3D mai i tētahi atahanga (`image_url`) ka whakahoki i tētahi kōnae GLB. Ko `resolution` he 512, 1024, 1536 rānei, ā, ko `texture_size` he 1024, 2048, 4096 rānei. Kei ia o ngā wāhanga e toru (hanganga, āhua, kakano) ōna ake arataki me ngā mana hipanga tīpako. Mā `decimation_target` e whakarite te tatau pūwāhi o te mātiti (5,000 ki te 2,000,000), ā, kei te wātea ngā kōwhiringa remeshing me UV-unwrapping.

Ngā tawhā

Tukuna te ingoa tōmua, te ingoa taketake rānei, kaua e rua. Ngā ingoa tōmua

IngoaMomo TaunoaE whakaaetia ana Whakamārama
seedkōwhiringa
Momointeger | null
Te kākano e whakamahia ana mō te whakaputa matapōkere tukurua.
resolutionkōwhiringa
Momoenum
Taunoa1024
51210241536
Te taumira o te putanga; mā te whakanui ake ka tāpirihia he taipitopito, engari ka roa ake.
ss_guidance_strengthkōwhiringa
Momonumber
Taunoa7.5
0 – 10
Te whakahaere pono o te hanganga 3D tuatahi: mā te whakanui ake ka tino rite ake ki te atahanga tāuru, engari ka nui ake pea te haruru.
ss_guidance_rescalekōwhiringa
Momonumber
Taunoa0.7
0 – 1
Te whakahaere ārahi-hanga-kino o te wāhanga 1, e whakawhiti ana i ngā pānga ārahi kaha i ngā tautuhinga iti ki te putanga pūmau ake i ngā tautuhinga nui.
ss_guidance_interval_startkōwhiringa
Momonumber
Taunoa0.6
0 – 1
Tāhawhā tīmatanga o te matapihi aratohu classifier-free i te wāhanga 1 (hanganga kōrere), hei hautanga tango-haruru. Mā ngā tautuhinga iti ake e tīmata wawe ai te aratohu; ko te wāhanga anake mai i interval_start ki interval_end ka whakamahi aratohu, ā, he tukatuka kore-aratohu kei wāhi kē.
ss_guidance_interval_endkōwhiringa
Momonumber
Taunoa1
0 – 1
Tapahi aratohu mō te wāhanga 1 (hanganga kōrere): kōwhiria he uara kia nui ake, kia ōrite rānei ki ss_guidance_interval_start. Ka tohu te uara i te hautanga o te tango-haruru kua tae atu ina mutu te aratohu classifier-free.
ss_sampling_stepskōwhiringa
Momointeger
Taunoa12
1 – 50
Te tatau denoising o te hanganga tuatahi: ka taea te whakanui kounga mā ngā hipanga tāpiri, engari ka pōturi ake te tukatuka.
ss_rescale_tkōwhiringa
Momonumber
Taunoa5
1 – 6
Tautuhia te koi o te whakawhitinga mā te wātaka haruru whakaputa-hanganga: mā te whakanui ake ka koi ake ngā whakawhitinga.
shape_slat_guidance_strengthkōwhiringa
Momonumber
Taunoa7.5
0 – 10
Te whakahaere pono o te āhuahanga taipitopito: mā te piri ake ki te atahanga tāuru ka tāpirihia he taipitopito, engari ka nui ake pea te haruru.
shape_slat_guidance_rescalekōwhiringa
Momonumber
Taunoa0.5
0 – 1
Whakanuia tēnei tautuhinga ina haruru te āhuahanga: ka whakaiti i ngā hanga-kino nā te ārahi kaha i te wāhanga hanga.
shape_slat_guidance_interval_startkōwhiringa
Momonumber
Taunoa0.6
0 – 1
Pūwāhi whakahohe aratohu classifier-free mō te whakamahine āhua i te wāhanga 2. Hei hautanga o te ahunga whakamua tango-haruru, ka whakarite i interval_start; ka mahi te aratohu i roto anake i te matapihi kei waenga i interval_start me interval_end.
shape_slat_guidance_interval_endkōwhiringa
Momonumber
Taunoa1
0 – 1
Tapahi aratohu mō te wāhanga 2 (whakamahine āhua): kōwhiria he uara kia nui ake, kia ōrite rānei ki shape_slat_guidance_interval_start. Ka tohu te uara i te hautanga o te tango-haruru kua tae atu ina mutu te aratohu classifier-free.
shape_slat_sampling_stepskōwhiringa
Momointeger
Taunoa12
1 – 50
Te tatau denoising whakamahine-hanga: ka pai ake pea te māeneene o te āhuahanga, engari ka heke te tere ina whakamahia ngā hipanga tāpiri.
shape_slat_rescale_tkōwhiringa
Momonumber
Taunoa3
1 – 6
Tautuhia te koi taipitopito āhuahanga mā te wātaka haruru whakamahine-hanga; mā te whakanui ake ka koi ake ngā taipitopito.
tex_slat_guidance_strengthkōwhiringa
Momonumber
Taunoa1
0 – 10
Te whakahaere pono tae kakano: mā te piri ake ki ngā tae o te atahanga tāuru i ngā tautuhinga nui ka kaha ake te kanapa, engari ka nui rawa pea te kukū.
tex_slat_guidance_rescalekōwhiringa
Momonumber
Taunoa0
0 – 1
Whakanuia tēnei tautuhinga hei whakatika i ngā kakano haruru, i te tāhei tae rānei: ka whakaiti i ngā hanga-kino nā te ārahi kaha i te wāhanga kakano.
tex_slat_guidance_interval_startkōwhiringa
Momonumber
Taunoa0.6
0 – 1
Pūwāhi whakahohe aratohu classifier-free mō te whakaputa kakano i te wāhanga 3. Hei hautanga o te ahunga whakamua tango-haruru, ka whakarite i interval_start; ka mahi te aratohu i roto anake i te matapihi kei waenga i interval_start me interval_end.
tex_slat_guidance_interval_endkōwhiringa
Momonumber
Taunoa0.9
0 – 1
Tapahi aratohu mō te wāhanga 3 (kakano): kōwhiria he uara kia nui ake, kia ōrite rānei ki tex_slat_guidance_interval_start. Ka tohu te uara i te hautanga o te tango-haruru kua tae atu ina mutu te aratohu classifier-free.
tex_slat_sampling_stepskōwhiringa
Momointeger
Taunoa12
1 – 50
Te maha o ngā hipanga denoising hei whakaputa kakano. Mā te whakanui i te tatau hipanga ka roa ake, engari ka mā ake pea ngā kakano.
tex_slat_rescale_tkōwhiringa
Momonumber
Taunoa3
1 – 6
Tautuhia te koi taipitopito kakano mā te wātaka haruru whakaputa-kakano; mā te whakanui ake ka koi ake ngā taipitopito.
decimation_targetkōwhiringa
Momointeger
Taunoa500000
5,000 – 2,000,000
Ūnga tatau pūwāhi kupenga, 500k e tūtohua ana mō te whakamahinga whānui, 20k–50k mō te tukutuku/pūkoro. Mā te whakaiti i te ūnga ka whakawhiti taipitopito kupenga mō ngā kōnae iti ake.
texture_sizekōwhiringa
Momoenum
Taunoa2048
102420484096
Te taumira kakano mata mō te baking. Mā te whakanui i tēnei taumira ka tino taipitopito ake te mata, engari ka nui ake ngā kōnae.
remeshkōwhiringa
Momoboolean
Taunoatrue
Hanga anō topology hei waihanga tapatoru kupenga mā, he pai ake mō ngā whakamahinga whai muri pērā i te hākoritanga, te tā 3D rānei, engari ka pōturi ake te tukatuka.
remesh_bandkōwhiringa
Momonumber
Taunoa1
0 – 4
Whakaaetanga nekehanga hanga anō: ka nui ake te māeneene, engari ka ngaro pea ngā taipitopito pai ina whakanuia tēnei uara. Ka herea e te tautuhinga te nekehanga pūwāhi ki te mata taketake.
remesh_projectkōwhiringa
Momonumber
Taunoa0
0 – 1
Kaha matapae mō te whakahoki i ngā pūwāhi kua hanga anō ki te mata taketake: mā te 1 ka pupuri taipitopito mā te matapae katoa, mā te 0 ka whakaweto te matapae mō te putanga māeneene ake.
uv_unwrap_angle_threshold_degkōwhiringa
Momonumber
Taunoa90
0 – 180
Tepe koki UV chart i ngā nekehanga, hei here i te rerekētanga o ngā pūtoro mata pātata i roto i tētahi chart. Mā te whakanui ka pai ake ngā chart iti ake, nui ake, engari ka tūpono totoro; mā te whakaiti ka pai ake ngā chart maha ake me te iti o te kōaro.
uv_unwrap_refine_iterationskōwhiringa
Momointeger
Taunoa0
0 – 10
Te tatau o ngā paahitanga whakamahine ā-rohe hei tātai i ngā UV charts.
uv_unwrap_global_iterationskōwhiringa
Momointeger
Taunoa1
1 – 10
Ka taea te whakapai i te taurite UV chart mā te whakanui i tēnei tatau o ngā paahitanga whakarōpū ā-ao hei tātai i ngā charts.
uv_unwrap_smooth_strengthkōwhiringa
Momonumber
Taunoa1
0 – 10
Whakaritea te kaha whakaene i ngā tapa UV chart; he iti ake ngā tui kitea ki ngā tautuhinga teitei, engari ka tūpono kōaro te UV.
image_urle hiahiatia ana image
Momourl · image
Te URL e tohu ana ki te atahanga pūtake mō te panoni 3D.
e hiahiatia ana Ingoa tōmua, e whakaaetia ana hoki

Mō ngā tawhā kōnae, whakamahia he URL tūmatanui https://, he URI data: tae atu ki te 10 MB, he file_url rānei o tētahi tukuake. Ngā kōnae

Putanga

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"
  }
}
Ō kōnae, māu e whiriwhiriKo ia url o outputs[] he tārua kei tō mātou rokiroki: ka puritia mō ake tonu atu (ka utua ia GB-marama) mō rānei 7 rā mō te kore utu, e ai ki ngā tautuhinga o tō pūkete, ki te ?storage= rānei.
He ōrite te hanga ki ia tauiratype, url, content_type, width, height me duration, mō ngā pikitia, ataata me te oro. Ko output te ahanoa hua ake o te tauira.
Ngā āpure o te putanga
model_glb
object {url, content_type, file_name, file_size}He tauira 3D kua whakaputaina ki te hōputu GLB.

Ētahi atu tauira: Atahanga ki te 3D

Mō ngā āpiha AI: kei te wātea tēnei whārangi hei Markdown ki https://doitong.com/mi/developers/models/trellis-2.md. Ngā tauira me ngā aratohu katoa: https://doitong.com/developers/llms.txt