Pāriet uz saturu

Trellis 2

Integrēt

Modeļa id 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"

Šis pieprasījums: 0,30 $ 300 API kredītu Izpildīt šajā lapā

Iegūt API atslēgu
Microsoft Attēls uz 3D #image-to-3d

Pārvērš vienu attēlu teksturētā GLB 3D tīklā ar regulējamiem struktūras, formas, tekstūras un UV iestatījumiem

Microsoft · 3D

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts image_url
Nometiet failu vai

Avota attēla URL 3D pārveidei.

resolution noklusējums 1024

Izvades izšķirtspēja; tās palielināšana pievieno detalizāciju, bet aizņem vairāk laika.

Papildu 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 noklusējums 2048

Režģa tekstūras izšķirtspēja cepšanai. Palielinot izšķirtspēju, virsmas detaļas kļūst smalkākas, bet faili lielāki.

noklusējums 7.5

Sākotnējās 3D struktūras precizitātes vadība: palielināšana veicina lielāku atbilstību ievades attēlam, taču var radīt papildu troksni.

noklusējums 0.7

1. posma vadības artefaktu kontrole: zemas vērtības pastiprina vadības efektus, bet augstas nodrošina stabilāku izvadi.

noklusējums 0.6

Klasifikatora brīvās vadības loga sākuma robeža 1. posmā (retā struktūra), izteikta kā trokšņu samazināšanas daļa. Zemākas vērtības sāk vadību agrāk; tikai intervāls no interval_start līdz interval_end izmanto vadību, bet citur apstrāde notiek bez vadības.

noklusējums 1

1. posma (retās struktūras) vadības beigu robeža: izvēlieties vērtību, kas ir vismaz tikpat liela kā ss_guidance_interval_start. Vērtība norāda sasniegto trokšņu samazināšanas daļu, kad klasifikatora brīvā vadība apstājas.

noklusējums 12

Sākotnējās struktūras trokšņa noņemšanas soļu skaits: papildu soļi var uzlabot kvalitāti, bet palēnina apstrādi.

noklusējums 5

Iestatiet pārejas asumu, izmantojot struktūras ģenerēšanas trokšņa grafiku: palielinot šo vērtību, pārejas kļūst asākas.

noklusējums 7.5

Detalizētās ģeometrijas precizitātes vadība: lielāka atbilstība ievades attēlam nodrošina papildu detalizāciju, taču var radīt troksni.

noklusējums 0.5

Palieliniet šo iestatījumu, ja ģeometrija izskatās trokšņaina: tas samazina spēcīgas vadības radītos artefaktus formas posmā.

noklusējums 0.6

Klasifikatora brīvās vadības aktivizēšanas punkts formas precizēšanai 2. posmā. Izteikts kā trokšņu samazināšanas progresa daļa; tas iestata interval_start, un vadība darbojas tikai logā starp interval_start un interval_end.

noklusējums 1

2. posma (formas precizēšanas) vadības beigu robeža: izvēlieties vērtību, kas ir vismaz tikpat liela kā shape_slat_guidance_interval_start. Vērtība norāda sasniegto trokšņu samazināšanas daļu, kad klasifikatora brīvā vadība apstājas.

noklusējums 12

Formas precizēšanas trokšņa noņemšanas soļu skaits: papildu soļi var nodrošināt vienmērīgāku ģeometriju, bet samazina ātrumu.

noklusējums 3

Iestatiet ģeometrisko detaļu asumu, izmantojot formas precizēšanas trokšņa grafiku; palielinot šo vērtību, detaļas kļūst asākas.

noklusējums 1

Tekstūras krāsu precizitātes vadība: lielāka atbilstība ievades attēla krāsām pie augstākām vērtībām palielina košumu, bet var izraisīt pārsātinājumu.

noklusējums 0

Palieliniet šo iestatījumu, lai novērstu trokšņainas tekstūras vai krāsu joslojumu: tas samazina spēcīgas vadības radītos artefaktus tekstūras posmā.

noklusējums 0.6

Klasifikatora brīvās vadības aktivizēšanas punkts tekstūras ģenerēšanai 3. posmā. Izteikts kā trokšņu samazināšanas progresa daļa; tas iestata interval_start, un vadība darbojas tikai logā starp interval_start un interval_end.

noklusējums 0.9

3. posma (tekstūras) vadības beigu robeža: izvēlieties vērtību, kas ir vismaz tikpat liela kā tex_slat_guidance_interval_start. Vērtība norāda sasniegto trokšņu samazināšanas daļu, kad klasifikatora brīvā vadība apstājas.

noklusējums 12

Tekstūru ģenerēšanai izmantoto trokšņa noņemšanas soļu skaits. Palielinot soļu skaitu, apstrāde kļūst ilgāka, bet tekstūras var būt tīrākas.

noklusējums 3

Iestatiet tekstūras detaļu asumu, izmantojot tekstūras ģenerēšanas trokšņa grafiku; palielinot šo vērtību, detaļas kļūst asākas.

noklusējums 500000

Režģa virsotņu skaita mērķis: vispārējai lietošanai ieteicams 500k, bet tīmeklim un mobilajām ierīcēm — 20k–50k. Mērķa samazināšana samazina failu izmērus uz režģa detaļu rēķina.

noklusējums 1

Pārrēžošanas kustības pielaide: papildu izlīdzināšana var upurēt smalkas detaļas, palielinot šo vērtību. Iestatījums ierobežo virsotņu nobīdi attiecībā pret sākotnējo virsmu.

noklusējums 0

Pārrēžoto virsotņu projekcijas stiprums atpakaļ uz sākotnējo virsmu: 1 saglabā detaļas ar pilnu projekciju, bet 0 izslēdz projekciju, nodrošinot gludāku rezultātu.

noklusējums 90

UV diagrammas leņķa ierobežojums grādos, kas ierobežo blakus esošo skaldņu normāļu atšķirību vienā diagrammā. Palielināšana dod priekšroku mazākam skaitam lielāku diagrammu, riskējot ar izstiepšanu; samazināšana dod priekšroku vairāk diagrammām un mazākiem kropļojumiem.

noklusējums 0

Lokālās precizēšanas caurlaižu skaits, ko izmanto UV diagrammu aprēķināšanai.

noklusējums 1

UV diagrammu līdzsvaru var uzlabot, palielinot globālās klasterizācijas caurlaižu skaitu, ko izmanto diagrammu aprēķināšanai.

noklusējums 1

Pielāgojiet, cik stipri tiek izlīdzinātas UV diagrammu malas; mazāk redzamas šuves pie augstākiem iestatījumiem rada UV kropļojumu risku.

Sākumvērtība atkārtojamai nejaušai ģenerēšanai.

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

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Trellis 2

Izveido 3D resursu no viena attēla (`image_url`) un atgriež GLB failu. `resolution` ir 512, 1024 vai 1536, bet `texture_size` — 1024, 2048 vai 4096. Katrai no trim stadijām (struktūrai, formai, tekstūrai) ir atsevišķas vadības un paraugošanas soļu vadīklas. `decimation_target` nosaka tīkla virsotņu skaitu (5,000 līdz 2,000,000), un ir pieejamas pārveidošanas tīklā un UV izklāšanas opcijas.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
seedneobligāts
Tipsinteger | null
Sākumvērtība atkārtojamai nejaušai ģenerēšanai.
resolutionneobligāts
Tipsenum
Noklusējums1024
51210241536
Izvades izšķirtspēja; tās palielināšana pievieno detalizāciju, bet aizņem vairāk laika.
ss_guidance_strengthneobligāts
Tipsnumber
Noklusējums7.5
0 – 10
Sākotnējās 3D struktūras precizitātes vadība: palielināšana veicina lielāku atbilstību ievades attēlam, taču var radīt papildu troksni.
ss_guidance_rescaleneobligāts
Tipsnumber
Noklusējums0.7
0 – 1
1. posma vadības artefaktu kontrole: zemas vērtības pastiprina vadības efektus, bet augstas nodrošina stabilāku izvadi.
ss_guidance_interval_startneobligāts
Tipsnumber
Noklusējums0.6
0 – 1
Klasifikatora brīvās vadības loga sākuma robeža 1. posmā (retā struktūra), izteikta kā trokšņu samazināšanas daļa. Zemākas vērtības sāk vadību agrāk; tikai intervāls no interval_start līdz interval_end izmanto vadību, bet citur apstrāde notiek bez vadības.
ss_guidance_interval_endneobligāts
Tipsnumber
Noklusējums1
0 – 1
1. posma (retās struktūras) vadības beigu robeža: izvēlieties vērtību, kas ir vismaz tikpat liela kā ss_guidance_interval_start. Vērtība norāda sasniegto trokšņu samazināšanas daļu, kad klasifikatora brīvā vadība apstājas.
ss_sampling_stepsneobligāts
Tipsinteger
Noklusējums12
1 – 50
Sākotnējās struktūras trokšņa noņemšanas soļu skaits: papildu soļi var uzlabot kvalitāti, bet palēnina apstrādi.
ss_rescale_tneobligāts
Tipsnumber
Noklusējums5
1 – 6
Iestatiet pārejas asumu, izmantojot struktūras ģenerēšanas trokšņa grafiku: palielinot šo vērtību, pārejas kļūst asākas.
shape_slat_guidance_strengthneobligāts
Tipsnumber
Noklusējums7.5
0 – 10
Detalizētās ģeometrijas precizitātes vadība: lielāka atbilstība ievades attēlam nodrošina papildu detalizāciju, taču var radīt troksni.
shape_slat_guidance_rescaleneobligāts
Tipsnumber
Noklusējums0.5
0 – 1
Palieliniet šo iestatījumu, ja ģeometrija izskatās trokšņaina: tas samazina spēcīgas vadības radītos artefaktus formas posmā.
shape_slat_guidance_interval_startneobligāts
Tipsnumber
Noklusējums0.6
0 – 1
Klasifikatora brīvās vadības aktivizēšanas punkts formas precizēšanai 2. posmā. Izteikts kā trokšņu samazināšanas progresa daļa; tas iestata interval_start, un vadība darbojas tikai logā starp interval_start un interval_end.
shape_slat_guidance_interval_endneobligāts
Tipsnumber
Noklusējums1
0 – 1
2. posma (formas precizēšanas) vadības beigu robeža: izvēlieties vērtību, kas ir vismaz tikpat liela kā shape_slat_guidance_interval_start. Vērtība norāda sasniegto trokšņu samazināšanas daļu, kad klasifikatora brīvā vadība apstājas.
shape_slat_sampling_stepsneobligāts
Tipsinteger
Noklusējums12
1 – 50
Formas precizēšanas trokšņa noņemšanas soļu skaits: papildu soļi var nodrošināt vienmērīgāku ģeometriju, bet samazina ātrumu.
shape_slat_rescale_tneobligāts
Tipsnumber
Noklusējums3
1 – 6
Iestatiet ģeometrisko detaļu asumu, izmantojot formas precizēšanas trokšņa grafiku; palielinot šo vērtību, detaļas kļūst asākas.
tex_slat_guidance_strengthneobligāts
Tipsnumber
Noklusējums1
0 – 10
Tekstūras krāsu precizitātes vadība: lielāka atbilstība ievades attēla krāsām pie augstākām vērtībām palielina košumu, bet var izraisīt pārsātinājumu.
tex_slat_guidance_rescaleneobligāts
Tipsnumber
Noklusējums0
0 – 1
Palieliniet šo iestatījumu, lai novērstu trokšņainas tekstūras vai krāsu joslojumu: tas samazina spēcīgas vadības radītos artefaktus tekstūras posmā.
tex_slat_guidance_interval_startneobligāts
Tipsnumber
Noklusējums0.6
0 – 1
Klasifikatora brīvās vadības aktivizēšanas punkts tekstūras ģenerēšanai 3. posmā. Izteikts kā trokšņu samazināšanas progresa daļa; tas iestata interval_start, un vadība darbojas tikai logā starp interval_start un interval_end.
tex_slat_guidance_interval_endneobligāts
Tipsnumber
Noklusējums0.9
0 – 1
3. posma (tekstūras) vadības beigu robeža: izvēlieties vērtību, kas ir vismaz tikpat liela kā tex_slat_guidance_interval_start. Vērtība norāda sasniegto trokšņu samazināšanas daļu, kad klasifikatora brīvā vadība apstājas.
tex_slat_sampling_stepsneobligāts
Tipsinteger
Noklusējums12
1 – 50
Tekstūru ģenerēšanai izmantoto trokšņa noņemšanas soļu skaits. Palielinot soļu skaitu, apstrāde kļūst ilgāka, bet tekstūras var būt tīrākas.
tex_slat_rescale_tneobligāts
Tipsnumber
Noklusējums3
1 – 6
Iestatiet tekstūras detaļu asumu, izmantojot tekstūras ģenerēšanas trokšņa grafiku; palielinot šo vērtību, detaļas kļūst asākas.
decimation_targetneobligāts
Tipsinteger
Noklusējums500000
5000 – 2 000 000
Režģa virsotņu skaita mērķis: vispārējai lietošanai ieteicams 500k, bet tīmeklim un mobilajām ierīcēm — 20k–50k. Mērķa samazināšana samazina failu izmērus uz režģa detaļu rēķina.
texture_sizeneobligāts
Tipsenum
Noklusējums2048
102420484096
Režģa tekstūras izšķirtspēja cepšanai. Palielinot izšķirtspēju, virsmas detaļas kļūst smalkākas, bet faili lielāki.
remeshneobligāts
Tipsboolean
Noklusējumstrue
Topoloģijas pārbūve, kas izveido tīrākus režģa trijstūrus un parasti uzlabo piemērotību turpmākiem lietojumiem, piemēram, animācijai vai 3D drukai, taču palēnina apstrādi.
remesh_bandneobligāts
Tipsnumber
Noklusējums1
0 – 4
Pārrēžošanas kustības pielaide: papildu izlīdzināšana var upurēt smalkas detaļas, palielinot šo vērtību. Iestatījums ierobežo virsotņu nobīdi attiecībā pret sākotnējo virsmu.
remesh_projectneobligāts
Tipsnumber
Noklusējums0
0 – 1
Pārrēžoto virsotņu projekcijas stiprums atpakaļ uz sākotnējo virsmu: 1 saglabā detaļas ar pilnu projekciju, bet 0 izslēdz projekciju, nodrošinot gludāku rezultātu.
uv_unwrap_angle_threshold_degneobligāts
Tipsnumber
Noklusējums90
0 – 180
UV diagrammas leņķa ierobežojums grādos, kas ierobežo blakus esošo skaldņu normāļu atšķirību vienā diagrammā. Palielināšana dod priekšroku mazākam skaitam lielāku diagrammu, riskējot ar izstiepšanu; samazināšana dod priekšroku vairāk diagrammām un mazākiem kropļojumiem.
uv_unwrap_refine_iterationsneobligāts
Tipsinteger
Noklusējums0
0 – 10
Lokālās precizēšanas caurlaižu skaits, ko izmanto UV diagrammu aprēķināšanai.
uv_unwrap_global_iterationsneobligāts
Tipsinteger
Noklusējums1
1 – 10
UV diagrammu līdzsvaru var uzlabot, palielinot globālās klasterizācijas caurlaižu skaitu, ko izmanto diagrammu aprēķināšanai.
uv_unwrap_smooth_strengthneobligāts
Tipsnumber
Noklusējums1
0 – 10
Pielāgojiet, cik stipri tiek izlīdzinātas UV diagrammu malas; mazāk redzamas šuves pie augstākiem iestatījumiem rada UV kropļojumu risku.
image_urlobligāts image
Tipsurl · image
Avota attēla URL 3D pārveidei.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
model_glb
object {url, content_type, file_name, file_size}GLB formātā ģenerēts 3D modelis.

Vairāk modeļu: Attēls uz 3D

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/trellis-2.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt