Trellis 2

Integracija

ID modela 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/sl/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"
  }
}

Pokličite model Trellis 2 (trellis-2) prek Doitong API. Dokumentacija za agente: https://doitong.com/sl/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"
}

Če je stanje odgovora "queued" ali "running", pošiljajte poizvedbe GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20, dokler ni "succeeded"; datoteke so v outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 z enakim telesom vrne natančno ceno pred zagonom.

Ta zahteva: 0,30 $ 300 API kreditov Zaženi na tej strani

Pridobi ključ API

Microsoft Slika v 3D #image-to-3d

Pretvori eno sliko v teksturirano 3D-mrežo GLB z nastavljivimi nastavitvami strukture, oblike, teksture in UV

OpenAPI Markdown

Microsoft · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

image •obvezno image_url

Spustite datoteko ali

URL izvorne slike za pretvorbo v 3D.

resolution privzeto 1024

Ločljivost izhoda; povečanje doda podrobnosti, vendar traja dlje.

Napredno 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 privzeto 2048

Ločljivost teksture mreže za pečenje. Pri višji ločljivosti so površinske podrobnosti natančnejše, datoteke pa večje.

ss_guidance_strength privzeto 7.5

Nadzor zvestobe začetne 3D-strukture: višja vrednost daje boljše ujemanje z vhodno sliko, vendar lahko povzroči več šuma.

ss_guidance_rescale privzeto 0.7

Nadzor artefaktov vodenja 1. faze; pri nizkih nastavitvah omogoča močnejše učinke vodenja, pri visokih pa stabilnejši izhod.

ss_guidance_interval_start privzeto 0.6

Začetna meja okna classifier-free guidance v 1. stopnji (redka struktura), izražena kot delež odstranjevanja šuma. Nižje nastavitve začnejo usmerjanje prej; samo interval od interval_start do interval_end uporablja usmerjanje, drugje poteka obdelava brez njega.

ss_guidance_interval_end privzeto 1

Meja usmerjanja za 1. stopnjo (redka struktura): izberite vrednost, ki je najmanj enaka ss_guidance_interval_start. Vrednost določa delež odstranjevanja šuma, pri katerem se classifier-free guidance ustavi.

ss_sampling_steps privzeto 12

Število korakov odstranjevanja šuma začetne strukture: dodatni koraki lahko izboljšajo kakovost, vendar upočasnijo obdelavo.

ss_rescale_t privzeto 5

Nastavite ostrino prehodov z razporedom šuma pri ustvarjanju strukture: višja vrednost ustvari ostrejše prehode.

shape_slat_guidance_strength privzeto 7.5

Nadzor zvestobe podrobne geometrije: večje ujemanje z vhodno sliko doda podrobnosti, vendar lahko povzroči več šuma.

shape_slat_guidance_rescale privzeto 0.5

To nastavitev povečajte, ko je geometrija videti šumna: zmanjša artefakte, ki jih povzroči močno vodenje med fazo oblike.

shape_slat_guidance_interval_start privzeto 0.6

Točka aktiviranja classifier-free guidance za izboljšanje oblike v 2. stopnji. Izražena kot delež napredka odstranjevanja šuma nastavi interval_start; usmerjanje deluje samo znotraj okna med interval_start in interval_end.

shape_slat_guidance_interval_end privzeto 1

Meja usmerjanja za 2. stopnjo (izboljšanje oblike): izberite vrednost, ki je najmanj enaka shape_slat_guidance_interval_start. Vrednost določa delež odstranjevanja šuma, pri katerem se classifier-free guidance ustavi.

shape_slat_sampling_steps privzeto 12

Število korakov odstranjevanja šuma za izboljšanje oblike: dodatni koraki lahko zgladijo geometrijo, vendar zmanjšajo hitrost.

shape_slat_rescale_t privzeto 3

Nastavite ostrino geometrijskih podrobnosti z razporedom šuma pri izboljšanju oblike; višja vrednost ustvari ostrejše podrobnosti.

tex_slat_guidance_strength privzeto 1

Nadzor zvestobe barv teksture: večje ujemanje z barvami vhodne slike pri višjih nastavitvah poveča živahnost, vendar lahko povzroči prenasičenost.

tex_slat_guidance_rescale privzeto 0

To nastavitev povečajte za odpravljanje šumnih tekstur ali barvnih pasov: zmanjša artefakte, ki jih povzroči močno vodenje med fazo teksture.

tex_slat_guidance_interval_start privzeto 0.6

Točka aktiviranja classifier-free guidance za generiranje teksture v 3. stopnji. Izražena kot delež napredka odstranjevanja šuma nastavi interval_start; usmerjanje deluje samo znotraj okna med interval_start in interval_end.

tex_slat_guidance_interval_end privzeto 0.9

Meja usmerjanja za 3. stopnjo (tekstura): izberite vrednost, ki je najmanj enaka tex_slat_guidance_interval_start. Vrednost določa delež odstranjevanja šuma, pri katerem se classifier-free guidance ustavi.

tex_slat_sampling_steps privzeto 12

Število korakov odstranjevanja šuma za ustvarjanje tekstur. Večje število traja dlje, vendar lahko ustvari čistejše teksture.

tex_slat_rescale_t privzeto 3

Nastavite ostrino podrobnosti teksture z razporedom šuma pri ustvarjanju teksture; višja vrednost ustvari ostrejše podrobnosti.

decimation_target privzeto 500000

Ciljno število oglišč mreže; za splošno uporabo je priporočenih 500k, za splet/mobilne naprave pa 20k–50k. Zmanjšanje cilja zamenja podrobnosti mreže za manjše datoteke.

remesh_band privzeto 1

Dovoljeni premik pri ponovni izdelavi mreže: dodatno glajenje lahko pri povečanju vrednosti žrtvuje drobne podrobnosti. Nastavitev omejuje premik oglišč glede na izvorno površino.

remesh_project privzeto 0

Moč projekcije za vračanje ponovno izdelanih oglišč na izvorno površino: 1 ohrani podrobnosti s polno projekcijo, 0 pa projekcijo izklopi za bolj gladek rezultat.

uv_unwrap_angle_threshold_deg privzeto 90

Omejitev kota UV-grafa v stopinjah, ki omejuje razliko med normalami sosednjih ploskev znotraj enega grafa. Višja omejitev daje prednost manjšemu številu večjih grafov, vendar lahko povzroči raztezanje; nižja omejitev daje več grafov in manj popačenja.

uv_unwrap_refine_iterations privzeto 0

Število lokalnih izboljševalnih prehodov za izračun UV-grafov.

uv_unwrap_global_iterations privzeto 1

Ravnotežje UV-grafov lahko izboljšate s povečanjem števila globalnih gručenjskih prehodov za njihov izračun.

uv_unwrap_smooth_strength privzeto 1

Prilagodite moč glajenja robov UV-grafov; pri višjih nastavitvah so šivi manj vidni, vendar obstaja nevarnost popačenja UV.

seed

Seme za ponovljivo naključno ustvarjanje.

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"

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

Zaženi to zahtevo

Ključ API

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Zapomni si v tem brskalniku Pridobi ključ API

O modelu Trellis 2

Ustvari 3D-sredstvo iz ene slike (`image_url`) in vrne datoteko GLB. `resolution` je 512, 1024 ali 1536, `texture_size` pa 1024, 2048 ali 4096. Vsaka od treh stopenj (struktura, oblika, tekstura) ima lastne nastavitve vodenja in vzorčevalnih korakov. `decimation_target` določa število oglišč mreže (5,000 do 2,000,000), na voljo pa so tudi možnosti ponovne izdelave mreže in razvitja UV.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis

seedneobvezno

Vrstainteger | null

Seme za ponovljivo naključno ustvarjanje.

resolutionneobvezno

Vrstaenum

Privzeto1024

51210241536

Ločljivost izhoda; povečanje doda podrobnosti, vendar traja dlje.

ss_guidance_strengthneobvezno

Vrstanumber

Privzeto7.5

0 – 10

Nadzor zvestobe začetne 3D-strukture: višja vrednost daje boljše ujemanje z vhodno sliko, vendar lahko povzroči več šuma.

ss_guidance_rescaleneobvezno

Vrstanumber

Privzeto0.7

0 – 1

Nadzor artefaktov vodenja 1. faze; pri nizkih nastavitvah omogoča močnejše učinke vodenja, pri visokih pa stabilnejši izhod.

ss_guidance_interval_startneobvezno

Vrstanumber

Privzeto0.6

0 – 1

ss_guidance_interval_endneobvezno

Vrstanumber

Privzeto1

0 – 1

ss_sampling_stepsneobvezno

Vrstainteger

Privzeto12

1 – 50

Število korakov odstranjevanja šuma začetne strukture: dodatni koraki lahko izboljšajo kakovost, vendar upočasnijo obdelavo.

ss_rescale_tneobvezno

Vrstanumber

Privzeto5

1 – 6

Nastavite ostrino prehodov z razporedom šuma pri ustvarjanju strukture: višja vrednost ustvari ostrejše prehode.

shape_slat_guidance_strengthneobvezno

Vrstanumber

Privzeto7.5

0 – 10

Nadzor zvestobe podrobne geometrije: večje ujemanje z vhodno sliko doda podrobnosti, vendar lahko povzroči več šuma.

shape_slat_guidance_rescaleneobvezno

Vrstanumber

Privzeto0.5

0 – 1

To nastavitev povečajte, ko je geometrija videti šumna: zmanjša artefakte, ki jih povzroči močno vodenje med fazo oblike.

shape_slat_guidance_interval_startneobvezno

Vrstanumber

Privzeto0.6

0 – 1

shape_slat_guidance_interval_endneobvezno

Vrstanumber

Privzeto1

0 – 1

shape_slat_sampling_stepsneobvezno

Vrstainteger

Privzeto12

1 – 50

Število korakov odstranjevanja šuma za izboljšanje oblike: dodatni koraki lahko zgladijo geometrijo, vendar zmanjšajo hitrost.

shape_slat_rescale_tneobvezno

Vrstanumber

Privzeto3

1 – 6

Nastavite ostrino geometrijskih podrobnosti z razporedom šuma pri izboljšanju oblike; višja vrednost ustvari ostrejše podrobnosti.

tex_slat_guidance_strengthneobvezno

Vrstanumber

Privzeto1

0 – 10

Nadzor zvestobe barv teksture: večje ujemanje z barvami vhodne slike pri višjih nastavitvah poveča živahnost, vendar lahko povzroči prenasičenost.

tex_slat_guidance_rescaleneobvezno

Vrstanumber

Privzeto0

0 – 1

To nastavitev povečajte za odpravljanje šumnih tekstur ali barvnih pasov: zmanjša artefakte, ki jih povzroči močno vodenje med fazo teksture.

tex_slat_guidance_interval_startneobvezno

Vrstanumber

Privzeto0.6

0 – 1

tex_slat_guidance_interval_endneobvezno

Vrstanumber

Privzeto0.9

0 – 1

tex_slat_sampling_stepsneobvezno

Vrstainteger

Privzeto12

1 – 50

Število korakov odstranjevanja šuma za ustvarjanje tekstur. Večje število traja dlje, vendar lahko ustvari čistejše teksture.

tex_slat_rescale_tneobvezno

Vrstanumber

Privzeto3

1 – 6

Nastavite ostrino podrobnosti teksture z razporedom šuma pri ustvarjanju teksture; višja vrednost ustvari ostrejše podrobnosti.

decimation_targetneobvezno

Vrstainteger

Privzeto500000

5000 – 2.000.000

Ciljno število oglišč mreže; za splošno uporabo je priporočenih 500k, za splet/mobilne naprave pa 20k–50k. Zmanjšanje cilja zamenja podrobnosti mreže za manjše datoteke.

texture_sizeneobvezno

Vrstaenum

Privzeto2048

102420484096

Ločljivost teksture mreže za pečenje. Pri višji ločljivosti so površinske podrobnosti natančnejše, datoteke pa večje.

remeshneobvezno

Vrstaboolean

Privzetotrue

Obnova topologije ustvari čistejše trikotnike mreže in običajno izboljša primernost za poznejšo uporabo, kot sta animacija ali 3D-tiskanje, vendar upočasni obdelavo.

remesh_bandneobvezno

Vrstanumber

Privzeto1

0 – 4

Dovoljeni premik pri ponovni izdelavi mreže: dodatno glajenje lahko pri povečanju vrednosti žrtvuje drobne podrobnosti. Nastavitev omejuje premik oglišč glede na izvorno površino.

remesh_projectneobvezno

Vrstanumber

Privzeto0

0 – 1

Moč projekcije za vračanje ponovno izdelanih oglišč na izvorno površino: 1 ohrani podrobnosti s polno projekcijo, 0 pa projekcijo izklopi za bolj gladek rezultat.

uv_unwrap_angle_threshold_degneobvezno

Vrstanumber

Privzeto90

0 – 180

uv_unwrap_refine_iterationsneobvezno

Vrstainteger

Privzeto0

0 – 10

Število lokalnih izboljševalnih prehodov za izračun UV-grafov.

uv_unwrap_global_iterationsneobvezno

Vrstainteger

Privzeto1

1 – 10

Ravnotežje UV-grafov lahko izboljšate s povečanjem števila globalnih gručenjskih prehodov za njihov izračun.

uv_unwrap_smooth_strengthneobvezno

Vrstanumber

Privzeto1

0 – 10

Prilagodite moč glajenja robov UV-grafov; pri višjih nastavitvah so šivi manj vidni, vendar obstaja nevarnost popačenja UV.

image_urlobvezno image

Vrstaurl · image

URL izvorne slike za pretvorbo v 3D.

obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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

Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.

Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.

Polja izhoda

model_glb: object {url, content_type, file_name, file_size}3D-model, ustvarjen v obliki GLB.

Več modelov: Slika v 3D

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/trellis-2.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt

Tukaj bo vaš prvi rezultat

Ustvari zahtevo

Zaženi to zahtevo

O modelu Trellis 2

Parametri

Izhod

Druge različice Trellis 2

Trellis 2 · Retexture Različice: 2

Več modelov: Slika v 3D

Trellis Različice: 2

Trellis · Multi Različice: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Različice: 6