Trellis 2

Integracja

Identyfikator 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/pl/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"
  }
}

Wywołaj model Trellis 2 (trellis-2) za pośrednictwem Doitong API. Dokumentacja dla agentów: https://doitong.com/pl/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"
}

Jeśli status odpowiedzi to "queued" lub "running", odpytuj GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20, aż status zmieni się na "succeeded"; pliki znajdują się w outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 z tym samym ciałem zwraca dokładną cenę przed uruchomieniem.

To żądanie: 0,30 $ 300 kredytów API Uruchom na tej stronie

Uzyskaj klucz API

Microsoft Obraz na 3D #image-to-3d

Konwertuje pojedynczy obraz na teksturowaną siatkę 3D GLB z regulacją struktury, kształtu, tekstury i ustawień UV

OpenAPI Markdown

Microsoft · 3D

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

image •wymagane image_url

Upuść plik lub

Adres URL wskazujący obraz źródłowy do konwersji 3D.

resolution domyślnie 1024

Rozdzielczość wyniku; jej zwiększenie dodaje szczegółów, ale wydłuża przetwarzanie.

Zaawansowane 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 domyślnie 2048

Rozdzielczość tekstury siatki do wypalania. Większa szczegółowość powierzchni oznacza większe pliki po zwiększeniu tej rozdzielczości.

ss_guidance_strength domyślnie 7.5

Kontrola wierności początkowej struktury 3D: jej zwiększenie sprzyja lepszemu odwzorowaniu obrazu wejściowego kosztem dodatkowego szumu.

ss_guidance_rescale domyślnie 0.7

Kontrola artefaktów prowadzenia etapu 1, równoważąca silniejsze efekty prowadzenia przy niskich ustawieniach ze stabilniejszym wynikiem przy wysokich ustawieniach.

ss_guidance_interval_start domyślnie 0.6

Początkowa granica okna bezklasowych wskazówek w etapie 1 (rzadka struktura), wyrażona jako ułamek odszumiania. Niższe ustawienia rozpoczynają wskazówki wcześniej; tylko przedział od interval_start do interval_end używa wskazówek, a pozostałe przetwarzanie odbywa się bez nich.

ss_guidance_interval_end domyślnie 1

Punkt końcowy wskazówek dla etapu 1 (rzadka struktura): wybierz wartość co najmniej równą ss_guidance_interval_start. Wartość określa ułamek odszumiania, przy którym kończą się bezklasowe wskazówki.

ss_sampling_steps domyślnie 12

Liczba kroków odszumiania struktury początkowej: potencjalna poprawa jakości dzięki dodatkowym krokom oznacza wolniejsze przetwarzanie.

ss_rescale_t domyślnie 5

Ustaw ostrość przejścia za pomocą harmonogramu szumu generowania struktury: zwiększenie tej wartości wyostrza przejścia.

shape_slat_guidance_strength domyślnie 7.5

Kontrola wierności szczegółowej geometrii: większe dopasowanie do obrazu wejściowego daje więcej szczegółów, ale zwiększa ryzyko dodatkowego szumu.

shape_slat_guidance_rescale domyślnie 0.5

Zwiększ to ustawienie, gdy geometria jest zaszumiona: ogranicza artefakty powodowane silnym prowadzeniem podczas etapu kształtu.

shape_slat_guidance_interval_start domyślnie 0.6

Punkt aktywacji bezklasowych wskazówek dla udoskonalania kształtu w etapie 2. Wyrażony jako ułamek postępu odszumiania, ustawia interval_start; wskazówki działają tylko w oknie ograniczonym przez interval_start i interval_end.

shape_slat_guidance_interval_end domyślnie 1

Punkt końcowy wskazówek dla etapu 2 (udoskonalanie kształtu): wybierz wartość co najmniej równą shape_slat_guidance_interval_start. Wartość określa ułamek odszumiania, przy którym kończą się bezklasowe wskazówki.

shape_slat_sampling_steps domyślnie 12

Liczba kroków odszumiania dopracowania kształtu: potencjalnie gładsza geometria odbywa się kosztem szybkości przy użyciu dodatkowych kroków.

shape_slat_rescale_t domyślnie 3

Ustaw ostrość szczegółów geometrycznych za pomocą harmonogramu szumu dopracowania kształtu; zwiększenie tej wartości daje ostrzejsze szczegóły.

tex_slat_guidance_strength domyślnie 1

Kontrola wierności kolorów tekstury: większe dopasowanie do kolorów obrazu wejściowego przy wyższych ustawieniach zwiększa intensywność, ale może powodować nadmierne nasycenie.

tex_slat_guidance_rescale domyślnie 0

Zwiększ to ustawienie, aby ograniczyć zaszumione tekstury lub pasmowanie kolorów: redukuje artefakty powodowane silnym prowadzeniem podczas etapu tekstury.

tex_slat_guidance_interval_start domyślnie 0.6

Punkt aktywacji bezklasowych wskazówek dla generowania tekstury w etapie 3. Wyrażony jako ułamek postępu odszumiania, ustawia interval_start; wskazówki działają tylko w oknie ograniczonym przez interval_start i interval_end.

tex_slat_guidance_interval_end domyślnie 0.9

Punkt końcowy wskazówek dla etapu 3 (tekstura): wybierz wartość co najmniej równą tex_slat_guidance_interval_start. Wartość określa ułamek odszumiania, przy którym kończą się bezklasowe wskazówki.

tex_slat_sampling_steps domyślnie 12

Liczba kroków odszumiania użytych do generowania tekstur. Zwiększenie liczby kroków wydłuża działanie, ale może dać czystsze tekstury.

tex_slat_rescale_t domyślnie 3

Ustaw ostrość szczegółów tekstury za pomocą harmonogramu szumu generowania tekstury; zwiększenie tej wartości daje ostrzejsze szczegóły.

decimation_target domyślnie 500000

Docelowa liczba wierzchołków siatki: 500k jest zalecane do zastosowań ogólnych, a 20k–50k do internetu i urządzeń mobilnych. Zmniejszenie celu zamienia szczegółowość siatki na mniejsze pliki.

remesh_band domyślnie 1

Dopuszczalny ruch podczas ponownego tworzenia siatki: dodatkowe wygładzanie może poświęcić drobne szczegóły po zwiększeniu tej wartości. Ustawienie ogranicza przesunięcie wierzchołków względem oryginalnej powierzchni.

remesh_project domyślnie 0

Siła projekcji zwracającej wierzchołki po ponownym utworzeniu siatki na oryginalną powierzchnię: 1 zachowuje szczegóły przez pełną projekcję, a 0 wyłącza projekcję, zapewniając gładszy wynik.

uv_unwrap_angle_threshold_deg domyślnie 90

Limit kąta wykresu UV w stopniach, ograniczający różnicę między normalnymi sąsiednich ścian w jednym wykresie. Zwiększenie limitu sprzyja mniejszej liczbie większych wykresów kosztem ryzyka rozciągnięcia; zmniejszenie sprzyja większej liczbie wykresów i mniejszym zniekształceniom.

uv_unwrap_refine_iterations domyślnie 0

Liczba lokalnych przebiegów udoskonalania używanych do obliczania wykresów UV.

uv_unwrap_global_iterations domyślnie 1

Równowagę wykresu UV można poprawić, zwiększając liczbę globalnych przebiegów klasteryzacji używanych do obliczania wykresów.

uv_unwrap_smooth_strength domyślnie 1

Dostosuj siłę wygładzania krawędzi wykresu UV; mniej widoczne szwy przy wyższych ustawieniach wiążą się z ryzykiem zniekształcenia UV.

seed

Ziarno używane do powtarzalnego generowania losowego.

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

Uruchom to żądanie

Klucz API

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Zapamiętaj w tej przeglądarce Uzyskaj klucz API

Informacje o Trellis 2

Buduje zasób 3D z jednego obrazu (`image_url`) i zwraca plik GLB. `resolution` to 512, 1024 lub 1536, a `texture_size` to 1024, 2048 lub 4096. Każdy z trzech etapów (struktura, kształt, tekstura) ma własne ustawienia sterowania i kroków próbkowania. `decimation_target` ustawia liczbę wierzchołków siatki (od 5,000 do 2,000,000), a dostępne są opcje ponownego tworzenia siatki i rozpakowywania UV.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis

seedopcjonalne

Typinteger | null

Ziarno używane do powtarzalnego generowania losowego.

resolutionopcjonalne

Typenum

Domyślne1024

51210241536

Rozdzielczość wyniku; jej zwiększenie dodaje szczegółów, ale wydłuża przetwarzanie.

ss_guidance_strengthopcjonalne

Typnumber

Domyślne7.5

0 – 10

Kontrola wierności początkowej struktury 3D: jej zwiększenie sprzyja lepszemu odwzorowaniu obrazu wejściowego kosztem dodatkowego szumu.

ss_guidance_rescaleopcjonalne

Typnumber

Domyślne0.7

0 – 1

Kontrola artefaktów prowadzenia etapu 1, równoważąca silniejsze efekty prowadzenia przy niskich ustawieniach ze stabilniejszym wynikiem przy wysokich ustawieniach.

ss_guidance_interval_startopcjonalne

Typnumber

Domyślne0.6

0 – 1

ss_guidance_interval_endopcjonalne

Typnumber

Domyślne1

0 – 1

ss_sampling_stepsopcjonalne

Typinteger

Domyślne12

1 – 50

Liczba kroków odszumiania struktury początkowej: potencjalna poprawa jakości dzięki dodatkowym krokom oznacza wolniejsze przetwarzanie.

ss_rescale_topcjonalne

Typnumber

Domyślne5

1 – 6

Ustaw ostrość przejścia za pomocą harmonogramu szumu generowania struktury: zwiększenie tej wartości wyostrza przejścia.

shape_slat_guidance_strengthopcjonalne

Typnumber

Domyślne7.5

0 – 10

Kontrola wierności szczegółowej geometrii: większe dopasowanie do obrazu wejściowego daje więcej szczegółów, ale zwiększa ryzyko dodatkowego szumu.

shape_slat_guidance_rescaleopcjonalne

Typnumber

Domyślne0.5

0 – 1

Zwiększ to ustawienie, gdy geometria jest zaszumiona: ogranicza artefakty powodowane silnym prowadzeniem podczas etapu kształtu.

shape_slat_guidance_interval_startopcjonalne

Typnumber

Domyślne0.6

0 – 1

shape_slat_guidance_interval_endopcjonalne

Typnumber

Domyślne1

0 – 1

shape_slat_sampling_stepsopcjonalne

Typinteger

Domyślne12

1 – 50

Liczba kroków odszumiania dopracowania kształtu: potencjalnie gładsza geometria odbywa się kosztem szybkości przy użyciu dodatkowych kroków.

shape_slat_rescale_topcjonalne

Typnumber

Domyślne3

1 – 6

Ustaw ostrość szczegółów geometrycznych za pomocą harmonogramu szumu dopracowania kształtu; zwiększenie tej wartości daje ostrzejsze szczegóły.

tex_slat_guidance_strengthopcjonalne

Typnumber

Domyślne1

0 – 10

Kontrola wierności kolorów tekstury: większe dopasowanie do kolorów obrazu wejściowego przy wyższych ustawieniach zwiększa intensywność, ale może powodować nadmierne nasycenie.

tex_slat_guidance_rescaleopcjonalne

Typnumber

Domyślne0

0 – 1

Zwiększ to ustawienie, aby ograniczyć zaszumione tekstury lub pasmowanie kolorów: redukuje artefakty powodowane silnym prowadzeniem podczas etapu tekstury.

tex_slat_guidance_interval_startopcjonalne

Typnumber

Domyślne0.6

0 – 1

tex_slat_guidance_interval_endopcjonalne

Typnumber

Domyślne0.9

0 – 1

tex_slat_sampling_stepsopcjonalne

Typinteger

Domyślne12

1 – 50

Liczba kroków odszumiania użytych do generowania tekstur. Zwiększenie liczby kroków wydłuża działanie, ale może dać czystsze tekstury.

tex_slat_rescale_topcjonalne

Typnumber

Domyślne3

1 – 6

Ustaw ostrość szczegółów tekstury za pomocą harmonogramu szumu generowania tekstury; zwiększenie tej wartości daje ostrzejsze szczegóły.

decimation_targetopcjonalne

Typinteger

Domyślne500000

5000 – 2 000 000

texture_sizeopcjonalne

Typenum

Domyślne2048

102420484096

Rozdzielczość tekstury siatki do wypalania. Większa szczegółowość powierzchni oznacza większe pliki po zwiększeniu tej rozdzielczości.

remeshopcjonalne

Typboolean

Domyślnetrue

Przebudowa topologii tworząca czystsze trójkąty siatki, zwykle zwiększająca przydatność do późniejszych zastosowań, takich jak animacja lub druk 3D, kosztem wolniejszego przetwarzania.

remesh_bandopcjonalne

Typnumber

Domyślne1

0 – 4

remesh_projectopcjonalne

Typnumber

Domyślne0

0 – 1

uv_unwrap_angle_threshold_degopcjonalne

Typnumber

Domyślne90

0 – 180

uv_unwrap_refine_iterationsopcjonalne

Typinteger

Domyślne0

0 – 10

Liczba lokalnych przebiegów udoskonalania używanych do obliczania wykresów UV.

uv_unwrap_global_iterationsopcjonalne

Typinteger

Domyślne1

1 – 10

Równowagę wykresu UV można poprawić, zwiększając liczbę globalnych przebiegów klasteryzacji używanych do obliczania wykresów.

uv_unwrap_smooth_strengthopcjonalne

Typnumber

Domyślne1

0 – 10

Dostosuj siłę wygładzania krawędzi wykresu UV; mniej widoczne szwy przy wyższych ustawieniach wiążą się z ryzykiem zniekształcenia UV.

image_urlwymagane image

Typurl · image

Adres URL wskazujący obraz źródłowy do konwersji 3D.

wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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

Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.

Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.

Pola wyniku

model_glb: object {url, content_type, file_name, file_size}Model 3D wygenerowany w formacie GLB.

Więcej modeli: Obraz na 3D

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/trellis-2.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt

Tutaj pojawi się pierwszy wynik

Zbuduj żądanie

Uruchom to żądanie

Informacje o Trellis 2

Parametry

Wynik

Inne warianty Trellis 2

Trellis 2 · Retexture Warianty: 2

Więcej modeli: Obraz na 3D

Trellis Warianty: 2

Trellis · Multi Warianty: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Warianty: 6