Njuolgga sisdollui

Trellis 2

Integrere

Modealla-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"

Dát ohcamuš: 0,30 $ 300 API-kreditta Vuodje dán siiddu alde

Oza API-čoavdaga
Microsoft Govas 3D #image-to-3d

Dahká ovtta gova tekstuvrahttojuvvon GLB 3D-meshin, heivehahtti struktuvra-, hámi-, tekstuvra- ja UV-heivehusain

Microsoft · 3D

Dát lea du vuosttaš bohtos

Daga jearaldaga vuolábealde ja vuodje dan iežat API-čoavddain. Boađusat kopierejuvvojit min vurkemii, bisuhuvvojit álo dahje 7 beaivvi nuvttá.

Ráhkat jearaldaga

Kontrollat ráhkaduvvojit modealla skeama vuođul. Koda ja haddi ođasmahttojuvvojit go rievddadat daid.

•gáibiduvvo image_url
Luoitte fiilla, dahje

URL mii čájeha gáldu-govvagii 3D-nuppástuhttima várás.

resolution standárda 1024

Boađusa resolušuvdna; stuoridemiin lasiha detaljjá, muhto gáibida guhkit áiggi.

Viiddiduvvon 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 standárda 2048

Mesh-tekstuvrra resolušuvdna bakinga várás. Dárkilut báikkálaš detaljja dahká fiillaid stuorit go resolušuvdna stuoriduvvo.

standárda 7.5

Álggahus 3D-struktuvrra luondduvuođa stivren: stuoridemiin deattuha lagabuidda heiveheami sisa-addi govvagii, muhto sáhttá lasihit ruovttudávdda.

standárda 0.7

1. láđi stivren stivren-artefaktaide: vuollegis heivehusat addet nannoset stivrema váikkuhusaid, alla heivehusat stabiilabut boađusa.

standárda 0.6

Classifier-free guidance álggahanrádji 1. stádii, čájehuvvon duohtavuođa háddenfrákšuvnnan. Unnit árvu álggaha jođáneappot; guidance geavahuvvo dušše interval_start ja interval_end gaskkas.

standárda 1

Guidance-heaitin 1. stádii. Árvu galgá leat unnimusat ss_guidance_interval_start; dat mearrida goas guidance heaitá.

standárda 12

Álggahus-struktuvrra denoising-láhkiid lohku: lassi láhkit sáhttet buoridit kvalitehta, muhto dahket barggu njoazebut.

standárda 5

Mearrit gaskkaid čiehkašvuođa struktuvrra-ráhkadeami ruovttudávda-gaskkain: árvvu stuoridemiin gaskkat šaddet čiehkašeappot.

standárda 7.5

Dárkilis geometrialaš luondduvuođa stivren: sisa-addi govvagii čuovvuma stuoridemiin boahtá lasi detaljjá, muhto sáhttá lasihit ruovttudávdda.

standárda 0.5

Stuorit dán heivehusa jus geometria lea ruovttudávda: dat unnida artefaktaid mat bohtet garras stivremis hámi-láđis.

standárda 0.6

Classifier-free guidance álggahančuokkis hámi dárkilastimii 2. stádii; guidance doaibmá dušše interval_start ja interval_end gaskkas.

standárda 1

Guidance-heaitin 2. stádii; árvu galgá leat unnimusat shape_slat_guidance_interval_start.

standárda 12

Hámi-čájeheami denoising-láhkiid lohku: lassi láhkit sáhttet šaddat čoakkideabbon, muhto gáibidit eanet áiggi.

standárda 3

Mearrit geometrialaš detaljja čiehkašvuođa hámi-čájeheami ruovttudávda-gaskkain; árvvu stuoridemiin detaljját šaddet čiehkašeappot.

standárda 1

Tekstuvrra ivdni-luondduvuođa stivren: alla heivehusain govvagi ivnniide čuovvun stuorida ivnni čielggasvuođa, muhto sáhttá dagahit badjelmearálaš ivnniid.

standárda 0

Stuorit dán heivehusa jus tekstuvrrat dahje ivdne-bánddat leat ruovttudávda: dat unnida artefaktaid mat bohtet garras stivremis tekstuvrra-láđis.

standárda 0.6

Classifier-free guidance álggahančuokkis tekstuvrra ráhkadeapmái 3. stádii.

standárda 0.9

Guidance-heaitin 3. stádii; árvu galgá leat unnimusat tex_slat_guidance_interval_start.

standárda 12

Denoising-láhkiid lohku tekstuvrraid ráhkadeamis. Stuoridemiin bargu bistá guhkit, muhto tekstuvrrat sáhttet šaddat čorgat.

standárda 3

Mearrit tekstuvrra detaljja čiehkašvuođa tekstuvrra-ráhkadeami ruovttudávda-gaskkain; stuoriduvvon árvu addá čiehkašeappot detaljjáid.

standárda 500000

Mesh-vertexlohku; 500k heive dábálaččat, 20k–50k web/mobile-geavaheapmái. Unnit mearri ráhkada unnit fiillaid.

standárda 1

Remesh-lihkadusdoarjja; stuorit árvu sáhttá váldit eret unnidetailla. Geahpida vertex-lihkadusa vuođđodahkii.

standárda 0

Remesh-vertexaid projekšuvdnafákta vuođđodahkii: 1 seailluha detailla, 0 heaitá projekšuvnna.

standárda 90

UV-chart vugge­goalládat gearduin, mii ráddje ráhkadusaid erohusa. Stuorit árvu addá unnit ja stuorit chartaid, muhto eambbo gearduma.

standárda 0

Lokal refinement-lávkkuid lohku UV-chartaid rehkenastimii.

standárda 1

Globála clustering-lávkkuid lohku UV-chartaid dárkilastimii.

standárda 1

Heive mo čavgga UV-chart-ravddaid njulgestuvvojit; stuorit árvu unnida seams, muhto sáhttá dagahit UV-gearduma.

Sieda geardduhahtti sluččadan ráhkadeapmái.

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

Geavat dán ohcamuša

Du key báhcá dán fierpmádatlogan: dat sáddejuvvo dušše Doitong API:ii ja vurkejuvvo (localStorage) dušše jos válljet Remember. Viečča API-keya

Dát lea Trellis 2 birra

Dahká 3D-ávdnasa ovtta govas (`image_url`) ja máhcaha GLB-fiilla. `resolution` lea 512, 1024 dahje 1536, ja `texture_size` lea 1024, 2048 dahje 4096. Juohke golmma ceahkis (struktuvra, hápmi, tekstuvra) leat iežas stivrema ja sampling-ceahkkiid stivrenvejolašvuođat. `decimation_target` mearrida mesh-vertexlogu (5,000 gitta 2,000,000), ja remeshing ja UV-čájehanmolssaeavttut leat olamuttus.

Parametterat

Sádde kanonala nama dahje iežas nama, ii goappašiid. Kanonala namat

NammaŠládja StandárdaDohkkehuvvon Govvádus
seedeaktodáhtolaš
Šládjainteger | null
Sieda geardduhahtti sluččadan ráhkadeapmái.
resolutioneaktodáhtolaš
Šládjaenum
Standárda1024
51210241536
Boađusa resolušuvdna; stuoridemiin lasiha detaljjá, muhto gáibida guhkit áiggi.
ss_guidance_strengtheaktodáhtolaš
Šládjanumber
Standárda7.5
0 – 10
Álggahus 3D-struktuvrra luondduvuođa stivren: stuoridemiin deattuha lagabuidda heiveheami sisa-addi govvagii, muhto sáhttá lasihit ruovttudávdda.
ss_guidance_rescaleeaktodáhtolaš
Šládjanumber
Standárda0.7
0 – 1
1. láđi stivren stivren-artefaktaide: vuollegis heivehusat addet nannoset stivrema váikkuhusaid, alla heivehusat stabiilabut boađusa.
ss_guidance_interval_starteaktodáhtolaš
Šládjanumber
Standárda0.6
0 – 1
Classifier-free guidance álggahanrádji 1. stádii, čájehuvvon duohtavuođa háddenfrákšuvnnan. Unnit árvu álggaha jođáneappot; guidance geavahuvvo dušše interval_start ja interval_end gaskkas.
ss_guidance_interval_endeaktodáhtolaš
Šládjanumber
Standárda1
0 – 1
Guidance-heaitin 1. stádii. Árvu galgá leat unnimusat ss_guidance_interval_start; dat mearrida goas guidance heaitá.
ss_sampling_stepseaktodáhtolaš
Šládjainteger
Standárda12
1 – 50
Álggahus-struktuvrra denoising-láhkiid lohku: lassi láhkit sáhttet buoridit kvalitehta, muhto dahket barggu njoazebut.
ss_rescale_teaktodáhtolaš
Šládjanumber
Standárda5
1 – 6
Mearrit gaskkaid čiehkašvuođa struktuvrra-ráhkadeami ruovttudávda-gaskkain: árvvu stuoridemiin gaskkat šaddet čiehkašeappot.
shape_slat_guidance_strengtheaktodáhtolaš
Šládjanumber
Standárda7.5
0 – 10
Dárkilis geometrialaš luondduvuođa stivren: sisa-addi govvagii čuovvuma stuoridemiin boahtá lasi detaljjá, muhto sáhttá lasihit ruovttudávdda.
shape_slat_guidance_rescaleeaktodáhtolaš
Šládjanumber
Standárda0.5
0 – 1
Stuorit dán heivehusa jus geometria lea ruovttudávda: dat unnida artefaktaid mat bohtet garras stivremis hámi-láđis.
shape_slat_guidance_interval_starteaktodáhtolaš
Šládjanumber
Standárda0.6
0 – 1
Classifier-free guidance álggahančuokkis hámi dárkilastimii 2. stádii; guidance doaibmá dušše interval_start ja interval_end gaskkas.
shape_slat_guidance_interval_endeaktodáhtolaš
Šládjanumber
Standárda1
0 – 1
Guidance-heaitin 2. stádii; árvu galgá leat unnimusat shape_slat_guidance_interval_start.
shape_slat_sampling_stepseaktodáhtolaš
Šládjainteger
Standárda12
1 – 50
Hámi-čájeheami denoising-láhkiid lohku: lassi láhkit sáhttet šaddat čoakkideabbon, muhto gáibidit eanet áiggi.
shape_slat_rescale_teaktodáhtolaš
Šládjanumber
Standárda3
1 – 6
Mearrit geometrialaš detaljja čiehkašvuođa hámi-čájeheami ruovttudávda-gaskkain; árvvu stuoridemiin detaljját šaddet čiehkašeappot.
tex_slat_guidance_strengtheaktodáhtolaš
Šládjanumber
Standárda1
0 – 10
Tekstuvrra ivdni-luondduvuođa stivren: alla heivehusain govvagi ivnniide čuovvun stuorida ivnni čielggasvuođa, muhto sáhttá dagahit badjelmearálaš ivnniid.
tex_slat_guidance_rescaleeaktodáhtolaš
Šládjanumber
Standárda0
0 – 1
Stuorit dán heivehusa jus tekstuvrrat dahje ivdne-bánddat leat ruovttudávda: dat unnida artefaktaid mat bohtet garras stivremis tekstuvrra-láđis.
tex_slat_guidance_interval_starteaktodáhtolaš
Šládjanumber
Standárda0.6
0 – 1
Classifier-free guidance álggahančuokkis tekstuvrra ráhkadeapmái 3. stádii.
tex_slat_guidance_interval_endeaktodáhtolaš
Šládjanumber
Standárda0.9
0 – 1
Guidance-heaitin 3. stádii; árvu galgá leat unnimusat tex_slat_guidance_interval_start.
tex_slat_sampling_stepseaktodáhtolaš
Šládjainteger
Standárda12
1 – 50
Denoising-láhkiid lohku tekstuvrraid ráhkadeamis. Stuoridemiin bargu bistá guhkit, muhto tekstuvrrat sáhttet šaddat čorgat.
tex_slat_rescale_teaktodáhtolaš
Šládjanumber
Standárda3
1 – 6
Mearrit tekstuvrra detaljja čiehkašvuođa tekstuvrra-ráhkadeami ruovttudávda-gaskkain; stuoriduvvon árvu addá čiehkašeappot detaljjáid.
decimation_targeteaktodáhtolaš
Šládjainteger
Standárda500000
5 000 – 2 000 000
Mesh-vertexlohku; 500k heive dábálaččat, 20k–50k web/mobile-geavaheapmái. Unnit mearri ráhkada unnit fiillaid.
texture_sizeeaktodáhtolaš
Šládjaenum
Standárda2048
102420484096
Mesh-tekstuvrra resolušuvdna bakinga várás. Dárkilut báikkálaš detaljja dahká fiillaid stuorit go resolušuvdna stuoriduvvo.
remesheaktodáhtolaš
Šládjaboolean
Standárdatrue
Topologiija ođasteapmi čábbas mesh-triángeliid ráhkadeapmái, muhto guhkit gieđahallanáigái.
remesh_bandeaktodáhtolaš
Šládjanumber
Standárda1
0 – 4
Remesh-lihkadusdoarjja; stuorit árvu sáhttá váldit eret unnidetailla. Geahpida vertex-lihkadusa vuođđodahkii.
remesh_projecteaktodáhtolaš
Šládjanumber
Standárda0
0 – 1
Remesh-vertexaid projekšuvdnafákta vuođđodahkii: 1 seailluha detailla, 0 heaitá projekšuvnna.
uv_unwrap_angle_threshold_degeaktodáhtolaš
Šládjanumber
Standárda90
0 – 180
UV-chart vugge­goalládat gearduin, mii ráddje ráhkadusaid erohusa. Stuorit árvu addá unnit ja stuorit chartaid, muhto eambbo gearduma.
uv_unwrap_refine_iterationseaktodáhtolaš
Šládjainteger
Standárda0
0 – 10
Lokal refinement-lávkkuid lohku UV-chartaid rehkenastimii.
uv_unwrap_global_iterationseaktodáhtolaš
Šládjainteger
Standárda1
1 – 10
Globála clustering-lávkkuid lohku UV-chartaid dárkilastimii.
uv_unwrap_smooth_strengtheaktodáhtolaš
Šládjanumber
Standárda1
0 – 10
Heive mo čavgga UV-chart-ravddaid njulgestuvvojit; stuorit árvu unnida seams, muhto sáhttá dagahit UV-gearduma.
image_urlgáibiduvvo image
Šládjaurl · image
URL mii čájeha gáldu-govvagii 3D-nuppástuhttima várás.
gáibiduvvo Kanonala namma, maid sáhttá geavahit

Fiilaparametterat váldet almmolaš https:// URL:a, data: URI:a gitta 10 MB, dahje uploada file_url:a. Fiillat

Boađus

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"
  }
}
Du fiillat, du válljenJuohke outputs[].url lea kopia min vurkemis: bisuhuvvo álo (mákso GB-mánu mielde) dahje 7 beaivvi nuvttá, du konto­o heiveheami dahje ?storage= mielde.
Seammá hápmi juohke modeallastype, url, content_type, width, height ja duration, govvii, videoii ja jienai seammá ládje. output lea modealla iežas boađusobjekta.
Outputa giettit
model_glb
object {url, content_type, file_name, file_size}3D-modealla ráhkaduvvon GLB-hámis.

Eanet modeallat: Govas 3D

AI-agenttaide: dán siidu Markdowna lea dáppe https://doitong.com/se/developers/models/trellis-2.md. Buot modeallat ja ráđit: https://doitong.com/developers/llms.txt