Trellis 2

Integráció

Modellazonosító 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/hu/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"
  }
}

A(z) Trellis 2 modell hívása (trellis-2) a Doitong API-n keresztül. Dokumentáció ágensekhez: https://doitong.com/hu/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"
}

Ha a válasz állapota "queued" vagy "running", kérdezd le a GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 végpontot addig, amíg "succeeded" nem lesz; a fájlok az outputs[].url alatt találhatók. A POST https://api.doitong.com/v1/quote/trellis-2 ugyanazzal a törzzsel a futtatás előtti pontos árat adja vissza.

Ez a kérés: 0,30 $ 300 API-jóváírás Futtatás ezen az oldalon

API-kulcs beszerzése

Microsoft Képből 3D #image-to-3d

Egyetlen képet textúrázott GLB 3D-hálóvá alakít, állítható struktúra-, forma-, textúra- és UV-beállításokkal

OpenAPI Markdown

Microsoft · 3D

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

image •kötelező image_url

Húzz egy fájlt ide, vagy

A 3D-konverzióhoz használt forrásképre mutató URL.

resolution alapértelmezett: 1024

A kimenet felbontása; növelése részletesebb eredményt ad, de hosszabb ideig tart.

Speciális 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 alapértelmezett: 2048

A háló textúrafelvételeinek felbontása. A felbontás növelése finomabb felületi részleteket ad, de nagyobb fájlokat eredményez.

ss_guidance_strength alapértelmezett: 7.5

A kezdeti 3D-struktúra hűségének vezérlése: növelése a bemeneti képhez való szorosabb egyezést részesíti előnyben, további zaj kockázatával.

ss_guidance_rescale alapértelmezett: 0.7

Az 1. szakasz vezérlési műtermékeinek beállítása: alacsony értékeknél erősebb vezérlési hatást, magas értékeknél stabilabb kimenetet biztosít.

ss_guidance_interval_start alapértelmezett: 0.6

A classifier-free guidance ablakának kezdőhatára az 1. szakaszban (ritka struktúra), zajcsökkentési hányadosként megadva. Az alacsonyabb beállítások hamarabb indítják az útmutatást; csak az interval_start és az interval_end közötti tartomány használ útmutatást, máshol irányítás nélküli feldolgozás történik.

ss_guidance_interval_end alapértelmezett: 1

Az 1. szakasz (ritka struktúra) útmutatási határa: válasszon az ss_guidance_interval_start értékével legalább megegyező értéket. Ez a zajcsökkentés azon hányadát jelöli, amelynél a classifier-free guidance leáll.

ss_sampling_steps alapértelmezett: 12

A kezdeti struktúra zajmentesítési lépésszáma: a további lépések lehetséges minőségjavulása lassabb feldolgozással jár.

ss_rescale_t alapértelmezett: 5

Az átmenet élességének beállítása a struktúragenerálás zajütemezésén keresztül: az érték növelése élesebb átmeneteket eredményez.

shape_slat_guidance_strength alapértelmezett: 7.5

A részletes geometria hűségének vezérlése: a bemeneti képhez való nagyobb igazodás további részleteket ad, de növeli a zaj kockázatát.

shape_slat_guidance_rescale alapértelmezett: 0.5

Növelje ezt a beállítást, ha a geometria zajos: csökkenti az alakfázisban az erős vezérlés okozta műtermékeket.

shape_slat_guidance_interval_start alapértelmezett: 0.6

A classifier-free guidance aktiválási pontja a 2. szakasz alakfinomításához. A zajcsökkentés előrehaladásának hányadosaként megadva beállítja az interval_start értéket; az útmutatás csak az interval_start és az interval_end által határolt ablakban működik.

shape_slat_guidance_interval_end alapértelmezett: 1

A 2. szakasz (alakfinomítás) útmutatási határa: válasszon a shape_slat_guidance_interval_start értékével legalább megegyező értéket. Ez a zajcsökkentés azon hányadát jelöli, amelynél a classifier-free guidance leáll.

shape_slat_sampling_steps alapértelmezett: 12

Az alakfinomítás zajmentesítési lépésszáma: további lépések használatakor simább geometria érhető el, a sebesség rovására.

shape_slat_rescale_t alapértelmezett: 3

A geometriai részletek élességének beállítása az alakfinomítás zajütemezésén keresztül; az érték növelése élesebb részleteket eredményez.

tex_slat_guidance_strength alapértelmezett: 1

A textúraszínek hűségének vezérlése: magasabb értékeknél a bemeneti kép színeihez való szorosabb igazodás élénkebb színeket adhat, de túltelítettséget okozhat.

tex_slat_guidance_rescale alapértelmezett: 0

Növelje ezt a beállítást zajos textúrák vagy színsávosodás esetén: csökkenti a textúrafázisban az erős vezérlés okozta műtermékeket.

tex_slat_guidance_interval_start alapértelmezett: 0.6

A classifier-free guidance aktiválási pontja a 3. szakasz textúragenerálásához. A zajcsökkentés előrehaladásának hányadosaként megadva beállítja az interval_start értéket; az útmutatás csak az interval_start és az interval_end által határolt ablakban működik.

tex_slat_guidance_interval_end alapértelmezett: 0.9

A 3. szakasz (textúra) útmutatási határa: válasszon a tex_slat_guidance_interval_start értékével legalább megegyező értéket. Ez a zajcsökkentés azon hányadát jelöli, amelynél a classifier-free guidance leáll.

tex_slat_sampling_steps alapértelmezett: 12

A textúrák generálásához használt zajmentesítési lépések száma. A lépésszám növelése hosszabb feldolgozást igényelhet, de tisztább textúrákat eredményezhet.

tex_slat_rescale_t alapértelmezett: 3

A textúrarészletek élességének beállítása a textúragenerálás zajütemezésén keresztül; az érték növelése élesebb részleteket eredményez.

decimation_target alapértelmezett: 500000

A háló csúcsszámának célértéke: általános használathoz 500k, webre/mobilra 20k–50k ajánlott. A célérték csökkentése a háló részletességét kisebb fájlméretre cseréli.

remesh_band alapértelmezett: 1

Újrahálózási mozgástűrés: ennek növelésekor a fokozott simítás feláldozhatja a finom részleteket. A beállítás az eredeti felülethez viszonyítva korlátozza a csúcsok elmozdulását.

remesh_project alapértelmezett: 0

A újrahálózott csúcsok eredeti felületre vetítésének erőssége: az 1 teljes vetítéssel megőrzi a részleteket, a 0 pedig kikapcsolja a vetítést a simább eredményért.

uv_unwrap_angle_threshold_deg alapértelmezett: 90

UV-térképrész szöghatára fokban, amely korlátozza, hogy a szomszédos lapok normálvektorai mennyire térhetnek el egymástól egy térképrészben. A határ növelése kevesebb és nagyobb térképrészt részesít előnyben a nyúlás kockázatával; csökkentése több térképrészt és kisebb torzulást eredményez.

uv_unwrap_refine_iterations alapértelmezett: 0

Az UV-térképrészek kiszámításához használt lokális finomítási menetek száma.

uv_unwrap_global_iterations alapértelmezett: 1

Az UV-térképrészek kiszámításához használt globális klaszterezési menetek számának növelése javíthatja az UV-térképrészek kiegyensúlyozottságát.

uv_unwrap_smooth_strength alapértelmezett: 1

Az UV-térképrész éleinek simítási erőssége; a magasabb beállítások kevésbé látható illesztéseket adnak, de UV-torzulást okozhatnak.

seed

Reprodukálható véletlenszerű generáláshoz használt seed.

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

Kérés futtatása

API-kulcs

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. Megjegyzés ebben a böngészőben API-kulcs igénylése

A(z) Trellis 2 bemutatása

Egy képből (`image_url`) 3D-eszközt készít, és GLB-fájlt ad vissza. A `resolution` értéke 512, 1024 vagy 1536, a `texture_size` értéke pedig 1024, 2048 vagy 4096 lehet. A három szakasz (struktúra, forma, textúra) mindegyike saját útmutatási és mintavételi lépésvezérlőkkel rendelkezik. A `decimation_target` állítja be a háló csúcsainak számát (5,000–2,000,000), továbbá elérhetők az újrahálózási és UV-kibontási opciók.

Paraméterek

Küldd el a kanonikus nevet vagy a natív nevet, de ne mindkettőt. Kanonikus nevek

NévTípus AlapértelmezettEngedélyezett Leírás

seednem kötelező

Típusinteger | null

Reprodukálható véletlenszerű generáláshoz használt seed.

resolutionnem kötelező

Típusenum

Alapértelmezett1024

51210241536

A kimenet felbontása; növelése részletesebb eredményt ad, de hosszabb ideig tart.

ss_guidance_strengthnem kötelező

Típusnumber

Alapértelmezett7.5

0 – 10

A kezdeti 3D-struktúra hűségének vezérlése: növelése a bemeneti képhez való szorosabb egyezést részesíti előnyben, további zaj kockázatával.

ss_guidance_rescalenem kötelező

Típusnumber

Alapértelmezett0.7

0 – 1

Az 1. szakasz vezérlési műtermékeinek beállítása: alacsony értékeknél erősebb vezérlési hatást, magas értékeknél stabilabb kimenetet biztosít.

ss_guidance_interval_startnem kötelező

Típusnumber

Alapértelmezett0.6

0 – 1

ss_guidance_interval_endnem kötelező

Típusnumber

Alapértelmezett1

0 – 1

ss_sampling_stepsnem kötelező

Típusinteger

Alapértelmezett12

1 – 50

A kezdeti struktúra zajmentesítési lépésszáma: a további lépések lehetséges minőségjavulása lassabb feldolgozással jár.

ss_rescale_tnem kötelező

Típusnumber

Alapértelmezett5

1 – 6

Az átmenet élességének beállítása a struktúragenerálás zajütemezésén keresztül: az érték növelése élesebb átmeneteket eredményez.

shape_slat_guidance_strengthnem kötelező

Típusnumber

Alapértelmezett7.5

0 – 10

A részletes geometria hűségének vezérlése: a bemeneti képhez való nagyobb igazodás további részleteket ad, de növeli a zaj kockázatát.

shape_slat_guidance_rescalenem kötelező

Típusnumber

Alapértelmezett0.5

0 – 1

Növelje ezt a beállítást, ha a geometria zajos: csökkenti az alakfázisban az erős vezérlés okozta műtermékeket.

shape_slat_guidance_interval_startnem kötelező

Típusnumber

Alapértelmezett0.6

0 – 1

shape_slat_guidance_interval_endnem kötelező

Típusnumber

Alapértelmezett1

0 – 1

shape_slat_sampling_stepsnem kötelező

Típusinteger

Alapértelmezett12

1 – 50

Az alakfinomítás zajmentesítési lépésszáma: további lépések használatakor simább geometria érhető el, a sebesség rovására.

shape_slat_rescale_tnem kötelező

Típusnumber

Alapértelmezett3

1 – 6

A geometriai részletek élességének beállítása az alakfinomítás zajütemezésén keresztül; az érték növelése élesebb részleteket eredményez.

tex_slat_guidance_strengthnem kötelező

Típusnumber

Alapértelmezett1

0 – 10

A textúraszínek hűségének vezérlése: magasabb értékeknél a bemeneti kép színeihez való szorosabb igazodás élénkebb színeket adhat, de túltelítettséget okozhat.

tex_slat_guidance_rescalenem kötelező

Típusnumber

Alapértelmezett0

0 – 1

Növelje ezt a beállítást zajos textúrák vagy színsávosodás esetén: csökkenti a textúrafázisban az erős vezérlés okozta műtermékeket.

tex_slat_guidance_interval_startnem kötelező

Típusnumber

Alapértelmezett0.6

0 – 1

tex_slat_guidance_interval_endnem kötelező

Típusnumber

Alapértelmezett0.9

0 – 1

tex_slat_sampling_stepsnem kötelező

Típusinteger

Alapértelmezett12

1 – 50

A textúrák generálásához használt zajmentesítési lépések száma. A lépésszám növelése hosszabb feldolgozást igényelhet, de tisztább textúrákat eredményezhet.

tex_slat_rescale_tnem kötelező

Típusnumber

Alapértelmezett3

1 – 6

A textúrarészletek élességének beállítása a textúragenerálás zajütemezésén keresztül; az érték növelése élesebb részleteket eredményez.

decimation_targetnem kötelező

Típusinteger

Alapértelmezett500000

5000 – 2 000 000

A háló csúcsszámának célértéke: általános használathoz 500k, webre/mobilra 20k–50k ajánlott. A célérték csökkentése a háló részletességét kisebb fájlméretre cseréli.

texture_sizenem kötelező

Típusenum

Alapértelmezett2048

102420484096

A háló textúrafelvételeinek felbontása. A felbontás növelése finomabb felületi részleteket ad, de nagyobb fájlokat eredményez.

remeshnem kötelező

Típusboolean

Alapértelmezetttrue

Topológia-újraépítés, amely tisztább hálóháromszögeket hoz létre, és általában javítja a későbbi felhasználásokhoz, például animációhoz vagy 3D-nyomtatáshoz való alkalmasságot, a lassabb feldolgozás árán.

remesh_bandnem kötelező

Típusnumber

Alapértelmezett1

0 – 4

remesh_projectnem kötelező

Típusnumber

Alapértelmezett0

0 – 1

A újrahálózott csúcsok eredeti felületre vetítésének erőssége: az 1 teljes vetítéssel megőrzi a részleteket, a 0 pedig kikapcsolja a vetítést a simább eredményért.

uv_unwrap_angle_threshold_degnem kötelező

Típusnumber

Alapértelmezett90

0 – 180

uv_unwrap_refine_iterationsnem kötelező

Típusinteger

Alapértelmezett0

0 – 10

Az UV-térképrészek kiszámításához használt lokális finomítási menetek száma.

uv_unwrap_global_iterationsnem kötelező

Típusinteger

Alapértelmezett1

1 – 10

Az UV-térképrészek kiszámításához használt globális klaszterezési menetek számának növelése javíthatja az UV-térképrészek kiegyensúlyozottságát.

uv_unwrap_smooth_strengthnem kötelező

Típusnumber

Alapértelmezett1

0 – 10

Az UV-térképrész éleinek simítási erőssége; a magasabb beállítások kevésbé látható illesztéseket adnak, de UV-torzulást okozhatnak.

image_urlkötelező image

Típusurl · image

A 3D-konverzióhoz használt forrásképre mutató URL.

kötelező Kanonikus név, szintén elfogadva

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

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

Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.

Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.

A kimenet mezői

model_glb: object {url, content_type, file_name, file_size}GLB formátumban generált 3D-modell.

További modellek: Képből 3D

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/trellis-2.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt

Az első eredményed itt jelenik meg

Kérés összeállítása

Kérés futtatása

A(z) Trellis 2 bemutatása

Paraméterek

Kimenet

A(z) Trellis 2 további változatai

Trellis 2 · Retexture Változatok: 2

További modellek: Képből 3D

Trellis Változatok: 2

Trellis · Multi Változatok: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Változatok: 6