Trellis 2

I-integrate

ID ng modelo 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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/fil/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "trellis-2",
  "input": {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }
}

Tawagin ang modelong Trellis 2 (trellis-2) sa pamamagitan ng Doitong API. Dokumentasyon para sa mga agent: https://doitong.com/fil/developers/models/trellis-2.md

POST https://api.doitong.com/v1/run/trellis-2?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}

Kung ang response status ay "queued" o "running", i-poll ang GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 hanggang maging "succeeded"; nasa outputs[].url ang mga file. Ang POST https://api.doitong.com/v1/quote/trellis-2 na may parehong body ay nagbabalik ng eksaktong presyo bago patakbuhin.

Kahilingang ito: $0.30 300 kredito ng API Patakbuhin ito sa page na ito

Kumuha ng API key

Microsoft Larawan patungong 3D #image-to-3d

Ginagawang textured na GLB 3D mesh ang isang larawan, na may naaayos na mga setting para sa structure, shape, texture at UV

OpenAPI Markdown

Microsoft · 3D

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

image •kinakailangan image_url

Mag-drop ng file, o

URL na tumuturo sa source larawan para sa 3D conversion.

resolution default na 1024

Resolution ng output; nagdaragdag ng detalye ang pagtaas nito ngunit mas tumatagal.

advanced 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 default na 2048

Resolution ng mesh texture para sa baking. Mas malalaki ang file kapag tinaasan ang resolution kapalit ng mas pinong detalye sa surface.

ss_guidance_strength default na 7.5

Kontrol sa fidelity ng paunang 3D structure: mas pinapaboran ng pagtaas nito ang mas malapit na pagtutugma sa input larawan kapalit ng posibilidad ng dagdag na noise.

ss_guidance_rescale default na 0.7

Kontrol sa guidance artifact ng Stage 1, kung saan mas malakas ang epekto ng guidance sa mababang setting at mas stable ang output sa mataas na setting.

ss_guidance_interval_start default na 0.6

Simulang boundary ng classifier-free guidance window sa stage 1 (sparse structure), na ipinapahayag bilang fraction ng denoising. Mas maagang nagsisimula ang guidance sa mas mababang setting; interval_start hanggang interval_end lamang ang gumagamit nito, at unguided ang pagproseso sa labas ng interval.

ss_guidance_interval_end default na 1

Cutoff ng guidance para sa stage 1 (sparse structure): pumili ng value na hindi bababa sa ss_guidance_interval_start. Tinutukoy ng value ang fraction ng denoising kung kailan hihinto ang classifier-free guidance.

ss_sampling_steps default na 12

Bilang ng denoising para sa paunang structure: maaaring tumaas ang kalidad sa dagdag na step ngunit mas mabagal ang processing.

ss_rescale_t default na 5

Itakda ang sharpness ng transition sa noise schedule ng structure pagbuo: mas nagiging matalas ang transition kapag tinaasan ang value na ito.

shape_slat_guidance_strength default na 7.5

Kontrol sa fidelity ng detalyadong geometry: mas maraming detalye ang nagmumula sa mas mahigpit na pagsunod sa input larawan, ngunit may panganib ng dagdag na noise.

shape_slat_guidance_rescale default na 0.5

Taasan ang setting na ito kapag maingay ang geometry: binabawasan nito ang mga artifact na dulot ng malakas na guidance sa shape stage.

shape_slat_guidance_interval_start default na 0.6

Activation point ng classifier-free guidance para sa shape refinement sa stage 2. Bilang fraction ng progreso ng denoising, itinatakda nito ang interval_start; gumagana lamang ang guidance sa window sa pagitan ng interval_start at interval_end.

shape_slat_guidance_interval_end default na 1

Cutoff ng guidance para sa stage 2 (shape refinement): pumili ng value na hindi bababa sa shape_slat_guidance_interval_start. Tinutukoy ng value ang fraction ng denoising kung kailan hihinto ang classifier-free guidance.

shape_slat_sampling_steps default na 12

Bilang ng denoising para sa shape refinement: maaaring maging mas makinis ang geometry ngunit bumabagal kapag nagdagdag ng step.

shape_slat_rescale_t default na 3

Itakda ang sharpness ng geometric detail sa noise schedule ng shape refinement; mas nagiging matalas ang mga detalye kapag tinaasan ang value na ito.

tex_slat_guidance_strength default na 1

Kontrol sa fidelity ng kulay ng texture: mas nagiging matingkad ang mas mahigpit na pagsunod sa mga kulay ng input larawan sa mataas na setting, ngunit maaaring magdulot ng oversaturation.

tex_slat_guidance_rescale default na 0

Taasan ang setting na ito para tugunan ang maingay na texture o color banding: binabawasan nito ang mga artifact na dulot ng malakas na guidance sa texture stage.

tex_slat_guidance_interval_start default na 0.6

Classifier-free guidance activation point para sa texture pagbuo sa stage 3. Bilang fraction ng progreso ng denoising, itinatakda nito ang interval_start; gumagana lamang ang guidance sa window sa pagitan ng interval_start at interval_end.

tex_slat_guidance_interval_end default na 0.9

Cutoff ng guidance para sa stage 3 (texture): pumili ng value na hindi bababa sa tex_slat_guidance_interval_start. Tinutukoy ng value ang fraction ng denoising kung kailan hihinto ang classifier-free guidance.

tex_slat_sampling_steps default na 12

Bilang ng denoising step na ginagamit sa pagbuo ng mga texture. Mas tumatagal kapag tinaasan ang bilang ngunit maaaring maging mas malinis ang mga texture.

tex_slat_rescale_t default na 3

Itakda ang sharpness ng texture detail sa noise schedule ng texture pagbuo; mas nagiging matalas ang mga detalye kapag tinaasan ang value na ito.

decimation_target default na 500000

Target na bilang ng vertex ng mesh; inirerekomenda ang 500k para sa pangkalahatang gamit at 20k–50k para sa web/mobile. Kapag binawasan ang target, nababawasan ang detalye ng mesh kapalit ng mas maliliit na file.

remesh_band default na 1

Allowance ng galaw sa remeshing: maaaring isakripisyo ang pinong detalye sa dagdag na smoothing kapag tinaasan ang value na ito. Nililimitahan ng setting ang paggalaw ng vertex kaugnay ng orihinal na surface.

remesh_project default na 0

Lakas ng projection para ibalik ang mga remeshed vertex sa orihinal na surface: pinananatili ng 1 ang detalye sa pamamagitan ng full projection, habang hindi gumagamit ng projection ang 0 para sa mas makinis na resulta.

uv_unwrap_angle_threshold_deg default na 90

Limitasyon ng anggulo ng UV chart sa degrees, na naglilimita sa pagkakaiba ng mga normal ng magkatabing face sa loob ng isang chart. Mas malalaki at mas kaunting chart ang pinapaboran ng mas mataas na limit, ngunit may panganib ng stretching; mas maraming chart at mas kaunting distortion ang pinapaboran ng mas mababang limit.

uv_unwrap_refine_iterations default na 0

Bilang ng local refinement pass na ginagamit sa pag-compute ng mga UV chart.

uv_unwrap_global_iterations default na 1

Mapapahusay ang balanse ng UV chart sa pamamagitan ng pagtaas sa bilang ng global clustering pass na ginagamit sa pag-compute ng mga chart.

uv_unwrap_smooth_strength default na 1

Ayusin kung gaano kalakas ang smoothing sa mga edge ng UV chart; ang mas hindi kapansin-pansing seam sa mas mataas na setting ay may panganib ng UV distortion.

seed

Seed na ginagamit para sa reproducible na random pagbuo.

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

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/trellis-2?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/trellis-2", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "trellis-2",
      "input": {
        "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}

Patakbuhin ang kahilingang ito

API key

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Tandaan sa browser na ito Kumuha ng API key

Tungkol sa Trellis 2

Bumubuo ng 3D asset mula sa isang larawan (`image_url`) at nagbabalik ng GLB file. Ang `resolution` ay 512, 1024 o 1536, at ang `texture_size` ay 1024, 2048 o 4096. May sariling mga kontrol sa guidance at sampling-step ang bawat isa sa tatlong stage (structure, shape, texture). Itinatakda ng `decimation_target` ang bilang ng vertex ng mesh (5,000 hanggang 2,000,000), at available ang mga opsyon sa remeshing at UV-unwrapping.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan

seedopsyonal

Uriinteger | null

Seed na ginagamit para sa reproducible na random pagbuo.

resolutionopsyonal

Urienum

default1024

51210241536

Resolution ng output; nagdaragdag ng detalye ang pagtaas nito ngunit mas tumatagal.

ss_guidance_strengthopsyonal

Urinumber

default7.5

0 – 10

Kontrol sa fidelity ng paunang 3D structure: mas pinapaboran ng pagtaas nito ang mas malapit na pagtutugma sa input larawan kapalit ng posibilidad ng dagdag na noise.

ss_guidance_rescaleopsyonal

Urinumber

default0.7

0 – 1

Kontrol sa guidance artifact ng Stage 1, kung saan mas malakas ang epekto ng guidance sa mababang setting at mas stable ang output sa mataas na setting.

ss_guidance_interval_startopsyonal

Urinumber

default0.6

0 – 1

ss_guidance_interval_endopsyonal

Urinumber

default1

0 – 1

ss_sampling_stepsopsyonal

Uriinteger

default12

1 – 50

Bilang ng denoising para sa paunang structure: maaaring tumaas ang kalidad sa dagdag na step ngunit mas mabagal ang processing.

ss_rescale_topsyonal

Urinumber

default5

1 – 6

Itakda ang sharpness ng transition sa noise schedule ng structure pagbuo: mas nagiging matalas ang transition kapag tinaasan ang value na ito.

shape_slat_guidance_strengthopsyonal

Urinumber

default7.5

0 – 10

Kontrol sa fidelity ng detalyadong geometry: mas maraming detalye ang nagmumula sa mas mahigpit na pagsunod sa input larawan, ngunit may panganib ng dagdag na noise.

shape_slat_guidance_rescaleopsyonal

Urinumber

default0.5

0 – 1

Taasan ang setting na ito kapag maingay ang geometry: binabawasan nito ang mga artifact na dulot ng malakas na guidance sa shape stage.

shape_slat_guidance_interval_startopsyonal

Urinumber

default0.6

0 – 1

shape_slat_guidance_interval_endopsyonal

Urinumber

default1

0 – 1

shape_slat_sampling_stepsopsyonal

Uriinteger

default12

1 – 50

Bilang ng denoising para sa shape refinement: maaaring maging mas makinis ang geometry ngunit bumabagal kapag nagdagdag ng step.

shape_slat_rescale_topsyonal

Urinumber

default3

1 – 6

Itakda ang sharpness ng geometric detail sa noise schedule ng shape refinement; mas nagiging matalas ang mga detalye kapag tinaasan ang value na ito.

tex_slat_guidance_strengthopsyonal

Urinumber

default1

0 – 10

Kontrol sa fidelity ng kulay ng texture: mas nagiging matingkad ang mas mahigpit na pagsunod sa mga kulay ng input larawan sa mataas na setting, ngunit maaaring magdulot ng oversaturation.

tex_slat_guidance_rescaleopsyonal

Urinumber

default0

0 – 1

Taasan ang setting na ito para tugunan ang maingay na texture o color banding: binabawasan nito ang mga artifact na dulot ng malakas na guidance sa texture stage.

tex_slat_guidance_interval_startopsyonal

Urinumber

default0.6

0 – 1

tex_slat_guidance_interval_endopsyonal

Urinumber

default0.9

0 – 1

tex_slat_sampling_stepsopsyonal

Uriinteger

default12

1 – 50

Bilang ng denoising step na ginagamit sa pagbuo ng mga texture. Mas tumatagal kapag tinaasan ang bilang ngunit maaaring maging mas malinis ang mga texture.

tex_slat_rescale_topsyonal

Urinumber

default3

1 – 6

Itakda ang sharpness ng texture detail sa noise schedule ng texture pagbuo; mas nagiging matalas ang mga detalye kapag tinaasan ang value na ito.

decimation_targetopsyonal

Uriinteger

default500000

5,000 – 2,000,000

texture_sizeopsyonal

Urienum

default2048

102420484096

Resolution ng mesh texture para sa baking. Mas malalaki ang file kapag tinaasan ang resolution kapalit ng mas pinong detalye sa surface.

remeshopsyonal

Uriboolean

defaulttrue

Topology rebuilding na lumilikha ng mas malilinis na triangle ng mesh, karaniwang nagpapahusay sa pagiging angkop para sa mga susunod na gamit gaya ng animation o 3D printing, kapalit ng mas mabagal na pagproseso.

remesh_bandopsyonal

Urinumber

default1

0 – 4

remesh_projectopsyonal

Urinumber

default0

0 – 1

uv_unwrap_angle_threshold_degopsyonal

Urinumber

default90

0 – 180

uv_unwrap_refine_iterationsopsyonal

Uriinteger

default0

0 – 10

Bilang ng local refinement pass na ginagamit sa pag-compute ng mga UV chart.

uv_unwrap_global_iterationsopsyonal

Uriinteger

default1

1 – 10

Mapapahusay ang balanse ng UV chart sa pamamagitan ng pagtaas sa bilang ng global clustering pass na ginagamit sa pag-compute ng mga chart.

uv_unwrap_smooth_strengthopsyonal

Urinumber

default1

0 – 10

Ayusin kung gaano kalakas ang smoothing sa mga edge ng UV chart; ang mas hindi kapansin-pansing seam sa mas mataas na setting ay may panganib ng UV distortion.

image_urlkinakailangan image

Uriurl · image

URL na tumuturo sa source larawan para sa 3D conversion.

kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga file

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

Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.

Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.

Mga field ng output

model_glb: object {url, content_type, file_name, file_size}3D modelo na nabuo sa GLB format.

Higit pang modelo: Larawan patungong 3D

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/trellis-2.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan

Patakbuhin ang kahilingang ito

Tungkol sa Trellis 2

Mga parameter

Output

Iba pang variant ng Trellis 2

Trellis 2 · Retexture Mga variant: 2

Higit pang modelo: Larawan patungong 3D

Trellis Mga variant: 2

Trellis · Multi Mga variant: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Mga variant: 6