Trellis 2

Integriruj

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

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

Kall o Trellis 2 modelo (trellis-2) vas o Doitong API. Dokumentacia vaš agentura: https://doitong.com/rom/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"
}

Te o response status si "queued" vaj "running", ker polling GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 dži kaj te avel "succeeded"; e fajlo si andro outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 sa jekhe body-esa del o precizno molipen angl-o phiripen.

Kava mangipen: $0.30 300 API krediti Phir les kate

Lel API klidin

Microsoft Kip ko 3D #image-to-3d

Paruvel jekhe kipo andro teksturirime GLB 3D mesh e struktura, forma, tekstura thaj UV ustawenca

OpenAPI Markdown

Microsoft · 3D

Tiro prvo rezultato si kate

Ker tele jekh mangipen thaj phir les tire API klidinosa. E rezultatur si kopirime amare arakhipneste, vično vaj 7 dives bilačhes.

Ker jekh mangipen

O kontrolura kerde si katar e schemaske. O kodo thaj e cena menjinen sar tu len menjines.

image •trubul image_url

Čhiv jekh fajl, vaj

URL savo sikavel o źorako kipo vaš 3D konverzija.

resolution standardno 1024

Rezolucija e rezultatoski; vazdinepe del buter detalja numa mangela buter vreme.

Lučhe 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 standardno 2048

Mesh teksturakiri rezolucija vaš baking. Buter fino površinako detaljo anel bareder fajlo kana vazdines kadja rezolucija.

ss_guidance_strength standardno 7.5

Kontrolo e fidelitetosko e anglune 3D struktura: vazdinepe preferirin buter paša sovipe e inputone kipesa, numa riski e buter noise-esko.

ss_guidance_rescale standardno 0.7

Kontrolo e guidance-artefaktosko ando stage 1, kaj tele settingura den zorale guidance efekto thaj uče settingura den stabilno rezultato.

ss_guidance_interval_start standardno 0.6

Startno granica e classifier-free guidance window-eskiri ando stage 1 (sparse structure), ekspresime sar denoising fraction. Majcikne settingur startinen guidance majsig; numa interval katar interval_start dži interval_end utilizinel guidance, aver thane si bila guidance.

ss_guidance_interval_end standardno 1

Guidance cutoff va stage 1 (sparse structure): alosar jekh qiymeta bareder vaj jekh sar ss_guidance_interval_start. O qiymeta vakerel katar savi denoising fraction ačhel classifier-free guidance.

ss_sampling_steps standardno 12

Gindipe e denoising-eske anglune struktura: šajutne kvalitetskero labaripen e buter stepenca anel lokheder keripe.

ss_rescale_t standardno 5

Thov o tranzicijakero scherpepen prekal o structure-generation noise schedule: vazdinepe kadale vrednostako kerel e tranzicije buter scherpane.

shape_slat_guidance_strength standardno 7.5

Kontrolo e fidelitetosko e detalno geometrijako: buter paša sovipe e inputone kipesa del buter detalja, numa riski e noise-esko.

shape_slat_guidance_rescale standardno 0.5

Vazdin kadja setting kana e geometria dikhel noisy: kerel cikneder e artefakto save keren e zorali guidance ando shape stage.

shape_slat_guidance_interval_start standardno 0.6

Classifier-free guidance activation point va shape refinement ando stage 2. Sar fraction e denoising progress-eskiri, kerdel pes interval_start; guidance kerel pes numa ande window maškar interval_start thaj interval_end.

shape_slat_guidance_interval_end standardno 1

Guidance cutoff va stage 2 (shape refinement): alosar jekh qiymeta bareder vaj jekh sar shape_slat_guidance_interval_start. O qiymeta vakerel katar savi denoising fraction ačhel classifier-free guidance.

shape_slat_sampling_steps standardno 12

Gindipe e denoising-eske shape-refinement-esko: šajutno smootheder geometria anel leneder speed kana istifadin buter step-a.

shape_slat_rescale_t standardno 3

Thov e geometricko detalosko scherpepen prekal o shape-refinement noise schedule; vazdinepe del buter sharp detalja.

tex_slat_guidance_strength standardno 1

Kontrolo e teksturakere rangoskere fidelitetosko: buter paša sovipe e rangenca ando inputo ande uče settingura vazdel e vividnost, numa šaj te kerel oversaturation.

tex_slat_guidance_rescale standardno 0

Vazdin kadja setting vaš noisy tekstura vaj color banding: kerel cikneder e artefakto save keren e zorali guidance ando texture stage.

tex_slat_guidance_interval_start standardno 0.6

O aktiviripesko than e gidipesko bi klasifikatorosko vaš o keripe e teksturako ande etapa 3. Sikavdo sar jekh kotor e progresosko e šumoske tiknjaripe, vov thovel interval_start; o gidipe kerel buti numa andre o intervalo maškar interval_start thaj interval_end.

tex_slat_guidance_interval_end standardno 0.9

Guidance cutoff va stage 3 (texture): alosar jekh qiymeta bareder vaj jekh sar tex_slat_guidance_interval_start. O qiymeta vakerel katar savi denoising fraction ačhel classifier-free guidance.

tex_slat_sampling_steps standardno 12

Gindipe e denoising step-enge save istifadin vaš teksturakero keripe. Buter step-a mangena buter vreme numa šaj te den čisteder tekstura.

tex_slat_rescale_t standardno 3

Thov e teksturakere detalosko scherpepen prekal o texture-generation noise schedule; vazdinepe del buter scherp detalja.

decimation_target standardno 500000

Mesh vertex-count targeto, 500k rekomendime va generalno use thaj 20k–50k va web/mobile. Te ciknederes o targeto, trade-off si majcikno fajlo va mesh detajo.

remesh_band standardno 1

Remeshing movement allowance: te bararel pes kadava, extra smoothing šaj te na rakhel cikno detajo. O setting limitinel vertex displacement le originalno surface-esa.

remesh_project standardno 0

Projection zoripen va te vakerel remeshime vertices pe originalno surface: 1 rakhel detajo le full projection-esa, kana 0 mukel projection off va majglatko rezultato.

uv_unwrap_angle_threshold_deg standardno 90

UV chart angle limit ande degrees, savo limitinel karing but neighboring face normals šaj te avriaven pes ande jekh chart. Te bararel o limit, favorizinel majcikne thaj majbare chartur, ama šaj te del stretching; te ciknederes les, del buter chartur thaj majcikno distortion.

uv_unwrap_refine_iterations standardno 0

Ginenipen e local refinement passesko savo utilizinel pes va te gindil UV chartur.

uv_unwrap_global_iterations standardno 1

O balansos le UV hartengo šaj te avel maj lačho kana barjarel pe akava gin le globalne grupiripnaskere ciklusengo save si len te kalkulirinen le harte.

uv_unwrap_smooth_strength standardno 1

Regulin sar zoralo si UV chart edges smoothing; majcikne seams ande bare settingur anen riski e UV distortion.

seed

Seed istifado vaš reproducibilno randomno keripe.

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

Phandel kava mangipen

API kluč

Tiro kluč ačhel kadale browsereste: bičhalel pes numa ko Doitong API thaj šuvav pes (localStorage) numa te tiknes Remember. Dikh ma andro akava browser Le jekh API ključ

Palal Trellis 2

Kerel 3D asset andar jek kipo (`image_url`) thaj del jek GLB fajlo. `resolution` si 512, 1024 vaj 1536, a `texture_size` si 1024, 2048 vaj 4096. Sako katar trin stage (structure, shape, tekstura) si les pesko lidžaripe thaj sampling-step kontrola. `decimation_target` phenel o mesh vertex gin (5,000 dži 2,000,000), thaj remeshing thaj UV-unwrapping opcije si dikhade.

Parametra

Bičhalav vaj e kanonikano nav vaj e native nav, na duj. Kanonikane nava

NavTip standardnoMuklo Vakeripe

seedopcionalno

Tipinteger | null

Seed istifado vaš reproducibilno randomno keripe.

resolutionopcionalno

Tipenum

standardno1024

51210241536

Rezolucija e rezultatoski; vazdinepe del buter detalja numa mangela buter vreme.

ss_guidance_strengthopcionalno

Tipnumber

standardno7.5

0 – 10

Kontrolo e fidelitetosko e anglune 3D struktura: vazdinepe preferirin buter paša sovipe e inputone kipesa, numa riski e buter noise-esko.

ss_guidance_rescaleopcionalno

Tipnumber

standardno0.7

0 – 1

Kontrolo e guidance-artefaktosko ando stage 1, kaj tele settingura den zorale guidance efekto thaj uče settingura den stabilno rezultato.

ss_guidance_interval_startopcionalno

Tipnumber

standardno0.6

0 – 1

ss_guidance_interval_endopcionalno

Tipnumber

standardno1

0 – 1

Guidance cutoff va stage 1 (sparse structure): alosar jekh qiymeta bareder vaj jekh sar ss_guidance_interval_start. O qiymeta vakerel katar savi denoising fraction ačhel classifier-free guidance.

ss_sampling_stepsopcionalno

Tipinteger

standardno12

1 – 50

Gindipe e denoising-eske anglune struktura: šajutne kvalitetskero labaripen e buter stepenca anel lokheder keripe.

ss_rescale_topcionalno

Tipnumber

standardno5

1 – 6

Thov o tranzicijakero scherpepen prekal o structure-generation noise schedule: vazdinepe kadale vrednostako kerel e tranzicije buter scherpane.

shape_slat_guidance_strengthopcionalno

Tipnumber

standardno7.5

0 – 10

Kontrolo e fidelitetosko e detalno geometrijako: buter paša sovipe e inputone kipesa del buter detalja, numa riski e noise-esko.

shape_slat_guidance_rescaleopcionalno

Tipnumber

standardno0.5

0 – 1

Vazdin kadja setting kana e geometria dikhel noisy: kerel cikneder e artefakto save keren e zorali guidance ando shape stage.

shape_slat_guidance_interval_startopcionalno

Tipnumber

standardno0.6

0 – 1

shape_slat_guidance_interval_endopcionalno

Tipnumber

standardno1

0 – 1

shape_slat_sampling_stepsopcionalno

Tipinteger

standardno12

1 – 50

Gindipe e denoising-eske shape-refinement-esko: šajutno smootheder geometria anel leneder speed kana istifadin buter step-a.

shape_slat_rescale_topcionalno

Tipnumber

standardno3

1 – 6

Thov e geometricko detalosko scherpepen prekal o shape-refinement noise schedule; vazdinepe del buter sharp detalja.

tex_slat_guidance_strengthopcionalno

Tipnumber

standardno1

0 – 10

Kontrolo e teksturakere rangoskere fidelitetosko: buter paša sovipe e rangenca ando inputo ande uče settingura vazdel e vividnost, numa šaj te kerel oversaturation.

tex_slat_guidance_rescaleopcionalno

Tipnumber

standardno0

0 – 1

Vazdin kadja setting vaš noisy tekstura vaj color banding: kerel cikneder e artefakto save keren e zorali guidance ando texture stage.

tex_slat_guidance_interval_startopcionalno

Tipnumber

standardno0.6

0 – 1

tex_slat_guidance_interval_endopcionalno

Tipnumber

standardno0.9

0 – 1

Guidance cutoff va stage 3 (texture): alosar jekh qiymeta bareder vaj jekh sar tex_slat_guidance_interval_start. O qiymeta vakerel katar savi denoising fraction ačhel classifier-free guidance.

tex_slat_sampling_stepsopcionalno

Tipinteger

standardno12

1 – 50

Gindipe e denoising step-enge save istifadin vaš teksturakero keripe. Buter step-a mangena buter vreme numa šaj te den čisteder tekstura.

tex_slat_rescale_topcionalno

Tipnumber

standardno3

1 – 6

Thov e teksturakere detalosko scherpepen prekal o texture-generation noise schedule; vazdinepe del buter scherp detalja.

decimation_targetopcionalno

Tipinteger

standardno500000

5,000 – 2,000,000

Mesh vertex-count targeto, 500k rekomendime va generalno use thaj 20k–50k va web/mobile. Te ciknederes o targeto, trade-off si majcikno fajlo va mesh detajo.

texture_sizeopcionalno

Tipenum

standardno2048

102420484096

Mesh teksturakiri rezolucija vaš baking. Buter fino površinako detaljo anel bareder fajlo kana vazdines kadja rezolucija.

remeshopcionalno

Tipboolean

standardnotrue

Topology rebuildipe savo kerel majčiste mesh triangles, kana butivar lačharel leski suitability va palutne use sar animacija vaj 3D printing, ama procesipe si majločho.

remesh_bandopcionalno

Tipnumber

standardno1

0 – 4

Remeshing movement allowance: te bararel pes kadava, extra smoothing šaj te na rakhel cikno detajo. O setting limitinel vertex displacement le originalno surface-esa.

remesh_projectopcionalno

Tipnumber

standardno0

0 – 1

Projection zoripen va te vakerel remeshime vertices pe originalno surface: 1 rakhel detajo le full projection-esa, kana 0 mukel projection off va majglatko rezultato.

uv_unwrap_angle_threshold_degopcionalno

Tipnumber

standardno90

0 – 180

uv_unwrap_refine_iterationsopcionalno

Tipinteger

standardno0

0 – 10

Ginenipen e local refinement passesko savo utilizinel pes va te gindil UV chartur.

uv_unwrap_global_iterationsopcionalno

Tipinteger

standardno1

1 – 10

O balansos le UV hartengo šaj te avel maj lačho kana barjarel pe akava gin le globalne grupiripnaskere ciklusengo save si len te kalkulirinen le harte.

uv_unwrap_smooth_strengthopcionalno

Tipnumber

standardno1

0 – 10

Regulin sar zoralo si UV chart edges smoothing; majcikne seams ande bare settingur anen riski e UV distortion.

image_urltrubul image

Tipurl · image

URL savo sikavel o źorako kipo vaš 3D konverzija.

trubul Kanonikano nav, vi akceptime

Fajloske parametra lel jekh publikano https:// URL, jekh data: URI dži 10 MB, vaj e file_url uploadoski. Fajlura

Rezultato

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

Tire fajlura, tiro alosaripenSako outputs[].url si kopija amare arakhipneste: vično (čargeime per GB-mase) vaj 7 dives bilačhes, tiro kontoskere regulaciatar vaj ?storage=.

Sa jekh forma sako modeloθartype, url, content_type, width, height thaj duration, varesave imajinake, video thaj audio-ke. output si o modelosko korkoro resultosko objekto.

Outputoske fieldura

model_glb: object {url, content_type, file_name, file_size}3D modelo kerdo ando GLB formato.

Bute modeli: Kip ko 3D

AI agentenge: kadija rig sar Markdown si kate https://doitong.com/rom/developers/models/trellis-2.md. Sa e modelura thaj e gidura: https://doitong.com/developers/llms.txt

Tiro prvo rezultato si kate

Ker jekh mangipen

Phandel kava mangipen

Palal Trellis 2

Parametra

Rezultato

Aver variantura e Trellis 2

Trellis 2 · Retexture Variantura: 2

Bute modeli: Kip ko 3D

Trellis Variantura: 2

Trellis · Multi Variantura: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Variantura: 6