Trellis 2

Integrace

ID modelu 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/cs/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"
  }
}

Volejte model Trellis 2 (trellis-2) prostřednictvím Doitong API. Dokumentace pro agenty: https://doitong.com/cs/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"
}

Pokud je stav odpovědi "queued" nebo "running", dotazujte GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20, dokud nebude "succeeded"; soubory jsou v outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 se stejným tělem vrátí přesnou cenu před spuštěním.

Tento požadavek: 0,30 $ 300 kreditů API Spustit na této stránce

Získat API klíč

Microsoft Obrázek na 3D #image-to-3d

Převádí jeden obrázek na texturovanou 3D síť GLB s nastavením struktury, tvaru, textury a UV

OpenAPI Markdown

Microsoft · 3D

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

image •povinné image_url

Přetáhněte soubor nebo

URL odkazující na zdrojový obrázek pro převod do 3D.

resolution výchozí 1024

Rozlišení výstupu; jeho zvýšení přidá detaily, ale prodlouží zpracování.

Pokročilé 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 výchozí 2048

Rozlišení textury sítě pro baking. Zvýšení rozlišení přináší jemnější povrchové detaily, ale větší soubory.

ss_guidance_strength výchozí 7.5

Řízení věrnosti počáteční 3D struktury: zvýšení podporuje lepší shodu se vstupním obrázkem za cenu dodatečného šumu.

ss_guidance_rescale výchozí 0.7

Řízení artefaktů vedení ve fázi 1, které při nízkých hodnotách upřednostňuje silnější účinky vedení a při vysokých stabilnější výstup.

ss_guidance_interval_start výchozí 0.6

Počáteční hranice okna classifier-free guidance ve fázi 1 (řídká struktura), vyjádřená jako zlomek odšumění. Nižší nastavení spouštějí guidance dříve; guidance používá pouze interval od interval_start do interval_end, jinde probíhá zpracování bez guidance.

ss_guidance_interval_end výchozí 1

Limit guidance pro fázi 1 (řídká struktura): zvolte hodnotu alespoň tak velkou jako ss_guidance_interval_start. Hodnota určuje zlomek odšumění, při kterém se classifier-free guidance zastaví.

ss_sampling_steps výchozí 12

Počet kroků odšumování počáteční struktury: případné zvýšení kvality dalšími kroky zpomaluje zpracování.

ss_rescale_t výchozí 5

Nastavte ostrost přechodů pomocí rozvrhu šumu generování struktury: zvýšení této hodnoty přechody zostří.

shape_slat_guidance_strength výchozí 7.5

Řízení věrnosti detailní geometrie: vyšší shoda se vstupním obrázkem přidává detaily, ale hrozí dodatečný šum.

shape_slat_guidance_rescale výchozí 0.5

Toto nastavení zvyšte, pokud geometrie vypadá zašuměně; omezí artefakty způsobené silným vedením během fáze tvaru.

shape_slat_guidance_interval_start výchozí 0.6

Bod aktivace classifier-free guidance pro zpřesnění tvaru ve fázi 2. Je vyjádřen jako zlomek postupu odšumění a nastavuje interval_start; guidance funguje pouze v okně ohraničeném hodnotami interval_start a interval_end.

shape_slat_guidance_interval_end výchozí 1

Limit guidance pro fázi 2 (zpřesnění tvaru): zvolte hodnotu alespoň tak velkou jako shape_slat_guidance_interval_start. Hodnota určuje zlomek odšumění, při kterém se classifier-free guidance zastaví.

shape_slat_sampling_steps výchozí 12

Počet kroků odšumování pro vylepšení tvaru: další kroky mohou vytvořit hladší geometrii, ale zpomalí zpracování.

shape_slat_rescale_t výchozí 3

Nastavte ostrost geometrických detailů pomocí rozvrhu šumu vylepšení tvaru; zvýšení této hodnoty vytvoří ostřejší detaily.

tex_slat_guidance_strength výchozí 1

Řízení věrnosti barev textury: vyšší shoda s barvami vstupního obrázku zvyšuje živost, ale může způsobit přesycení.

tex_slat_guidance_rescale výchozí 0

Toto nastavení zvyšte pro řešení zašuměných textur nebo pruhování barev; omezí artefakty způsobené silným vedením během fáze textury.

tex_slat_guidance_interval_start výchozí 0.6

Bod aktivace classifier-free guidance pro generování textury ve fázi 3. Je vyjádřen jako zlomek postupu odšumění a nastavuje interval_start; guidance funguje pouze v okně ohraničeném hodnotami interval_start a interval_end.

tex_slat_guidance_interval_end výchozí 0.9

Limit guidance pro fázi 3 (textura): zvolte hodnotu alespoň tak velkou jako tex_slat_guidance_interval_start. Hodnota určuje zlomek odšumění, při kterém se classifier-free guidance zastaví.

tex_slat_sampling_steps výchozí 12

Počet kroků odšumování použitých k vytvoření textur. Vyšší počet trvá déle, ale může vytvořit čistší textury.

tex_slat_rescale_t výchozí 3

Nastavte ostrost detailů textury pomocí rozvrhu šumu generování textury; zvýšení této hodnoty vytvoří ostřejší detaily.

decimation_target výchozí 500000

Cílový počet vrcholů sítě, přičemž pro obecné použití se doporučuje 500k a pro web/mobil 20k–50k. Snížení cílové hodnoty vymění detaily sítě za menší soubory.

remesh_band výchozí 1

Povolený pohyb při remeshingu: při zvýšení této hodnoty může dodatečné vyhlazení obětovat jemné detaily. Nastavení omezuje posun vrcholů vzhledem k původnímu povrchu.

remesh_project výchozí 0

Síla projekce pro návrat remeshovaných vrcholů na původní povrch: 1 zachovává detaily úplnou projekcí, zatímco 0 projekci vypne a vytvoří hladší výsledek.

uv_unwrap_angle_threshold_deg výchozí 90

Úhlový limit UV chartu ve stupních, který omezuje rozdíl mezi normálami sousedních ploch v jednom chartu. Zvýšení limitu upřednostňuje méně větších chartů s rizikem roztažení; snížení upřednostňuje více chartů a menší deformaci.

uv_unwrap_refine_iterations výchozí 0

Počet průchodů lokálního zpřesnění použitých k výpočtu UV chartů.

uv_unwrap_global_iterations výchozí 1

Vyvážení UV chartů lze zlepšit zvýšením tohoto počtu globálních shlukovacích průchodů použitých k výpočtu chartů.

uv_unwrap_smooth_strength výchozí 1

Upravuje sílu vyhlazení hran UV chartů; méně viditelné švy při vyšších nastaveních s sebou nesou riziko deformace UV.

seed

Seed použitý pro reprodukovatelné náhodné generování.

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

Spustit tento požadavek

Klíč API

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Zapamatovat v tomto prohlížeči Získat klíč API

O modelu Trellis 2

Vytvoří 3D asset z jednoho obrázku (`image_url`) a vrátí soubor GLB. `resolution` je 512, 1024 nebo 1536 a `texture_size` je 1024, 2048 nebo 4096. Každá ze tří fází (struktura, tvar, textura) má vlastní ovládání guidance a počtu kroků samplování. `decimation_target` nastavuje počet vrcholů sítě (5,000 až 2,000,000) a jsou dostupné volby remeshingu i rozbalení UV.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis

seedvolitelné

Typinteger | null

Seed použitý pro reprodukovatelné náhodné generování.

resolutionvolitelné

Typenum

Výchozí1024

51210241536

Rozlišení výstupu; jeho zvýšení přidá detaily, ale prodlouží zpracování.

ss_guidance_strengthvolitelné

Typnumber

Výchozí7.5

0 – 10

Řízení věrnosti počáteční 3D struktury: zvýšení podporuje lepší shodu se vstupním obrázkem za cenu dodatečného šumu.

ss_guidance_rescalevolitelné

Typnumber

Výchozí0.7

0 – 1

Řízení artefaktů vedení ve fázi 1, které při nízkých hodnotách upřednostňuje silnější účinky vedení a při vysokých stabilnější výstup.

ss_guidance_interval_startvolitelné

Typnumber

Výchozí0.6

0 – 1

ss_guidance_interval_endvolitelné

Typnumber

Výchozí1

0 – 1

ss_sampling_stepsvolitelné

Typinteger

Výchozí12

1 – 50

Počet kroků odšumování počáteční struktury: případné zvýšení kvality dalšími kroky zpomaluje zpracování.

ss_rescale_tvolitelné

Typnumber

Výchozí5

1 – 6

Nastavte ostrost přechodů pomocí rozvrhu šumu generování struktury: zvýšení této hodnoty přechody zostří.

shape_slat_guidance_strengthvolitelné

Typnumber

Výchozí7.5

0 – 10

Řízení věrnosti detailní geometrie: vyšší shoda se vstupním obrázkem přidává detaily, ale hrozí dodatečný šum.

shape_slat_guidance_rescalevolitelné

Typnumber

Výchozí0.5

0 – 1

Toto nastavení zvyšte, pokud geometrie vypadá zašuměně; omezí artefakty způsobené silným vedením během fáze tvaru.

shape_slat_guidance_interval_startvolitelné

Typnumber

Výchozí0.6

0 – 1

shape_slat_guidance_interval_endvolitelné

Typnumber

Výchozí1

0 – 1

shape_slat_sampling_stepsvolitelné

Typinteger

Výchozí12

1 – 50

Počet kroků odšumování pro vylepšení tvaru: další kroky mohou vytvořit hladší geometrii, ale zpomalí zpracování.

shape_slat_rescale_tvolitelné

Typnumber

Výchozí3

1 – 6

Nastavte ostrost geometrických detailů pomocí rozvrhu šumu vylepšení tvaru; zvýšení této hodnoty vytvoří ostřejší detaily.

tex_slat_guidance_strengthvolitelné

Typnumber

Výchozí1

0 – 10

Řízení věrnosti barev textury: vyšší shoda s barvami vstupního obrázku zvyšuje živost, ale může způsobit přesycení.

tex_slat_guidance_rescalevolitelné

Typnumber

Výchozí0

0 – 1

Toto nastavení zvyšte pro řešení zašuměných textur nebo pruhování barev; omezí artefakty způsobené silným vedením během fáze textury.

tex_slat_guidance_interval_startvolitelné

Typnumber

Výchozí0.6

0 – 1

tex_slat_guidance_interval_endvolitelné

Typnumber

Výchozí0.9

0 – 1

Limit guidance pro fázi 3 (textura): zvolte hodnotu alespoň tak velkou jako tex_slat_guidance_interval_start. Hodnota určuje zlomek odšumění, při kterém se classifier-free guidance zastaví.

tex_slat_sampling_stepsvolitelné

Typinteger

Výchozí12

1 – 50

Počet kroků odšumování použitých k vytvoření textur. Vyšší počet trvá déle, ale může vytvořit čistší textury.

tex_slat_rescale_tvolitelné

Typnumber

Výchozí3

1 – 6

Nastavte ostrost detailů textury pomocí rozvrhu šumu generování textury; zvýšení této hodnoty vytvoří ostřejší detaily.

decimation_targetvolitelné

Typinteger

Výchozí500000

5 000 – 2 000 000

Cílový počet vrcholů sítě, přičemž pro obecné použití se doporučuje 500k a pro web/mobil 20k–50k. Snížení cílové hodnoty vymění detaily sítě za menší soubory.

texture_sizevolitelné

Typenum

Výchozí2048

102420484096

Rozlišení textury sítě pro baking. Zvýšení rozlišení přináší jemnější povrchové detaily, ale větší soubory.

remeshvolitelné

Typboolean

Výchozítrue

Přebudování topologie, které vytváří čistší trojúhelníky sítě a obvykle zlepšuje vhodnost pro pozdější použití, například animaci nebo 3D tisk, za cenu pomalejšího zpracování.

remesh_bandvolitelné

Typnumber

Výchozí1

0 – 4

Povolený pohyb při remeshingu: při zvýšení této hodnoty může dodatečné vyhlazení obětovat jemné detaily. Nastavení omezuje posun vrcholů vzhledem k původnímu povrchu.

remesh_projectvolitelné

Typnumber

Výchozí0

0 – 1

Síla projekce pro návrat remeshovaných vrcholů na původní povrch: 1 zachovává detaily úplnou projekcí, zatímco 0 projekci vypne a vytvoří hladší výsledek.

uv_unwrap_angle_threshold_degvolitelné

Typnumber

Výchozí90

0 – 180

uv_unwrap_refine_iterationsvolitelné

Typinteger

Výchozí0

0 – 10

Počet průchodů lokálního zpřesnění použitých k výpočtu UV chartů.

uv_unwrap_global_iterationsvolitelné

Typinteger

Výchozí1

1 – 10

Vyvážení UV chartů lze zlepšit zvýšením tohoto počtu globálních shlukovacích průchodů použitých k výpočtu chartů.

uv_unwrap_smooth_strengthvolitelné

Typnumber

Výchozí1

0 – 10

Upravuje sílu vyhlazení hran UV chartů; méně viditelné švy při vyšších nastaveních s sebou nesou riziko deformace UV.

image_urlpovinné image

Typurl · image

URL odkazující na zdrojový obrázek pro převod do 3D.

povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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 soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.

Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.

Pole výstupu

model_glb: object {url, content_type, file_name, file_size}3D model vygenerovaný ve formátu GLB.

Další modely: Obrázek na 3D

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/trellis-2.md. Všechny modely a návody: https://doitong.com/developers/llms.txt

Zde se zobrazí váš první výsledek

Sestavit požadavek

Spustit tento požadavek

O modelu Trellis 2

Parametry

Výstup

Další varianty Trellis 2

Trellis 2 · Retexture Varianty: 2

Další modely: Obrázek na 3D

Trellis Varianty: 2

Trellis · Multi Varianty: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Varianty: 6