Trellis 2

Integreren

Model-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/nl/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"
  }
}

Roep het Trellis 2-model (trellis-2) aan via de Doitong API. Documentatie voor agents: https://doitong.com/nl/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"
}

Als de responsstatus "queued" of "running" is, poll dan GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 totdat deze "succeeded" is; de bestanden staan in outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 met dezelfde body retourneert de exacte prijs vóór de uitvoering.

Deze request: $ 0,30 300 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen

Microsoft Afbeelding naar 3D #image-to-3d

Maakt van één afbeelding een getexturede GLB 3D-mesh met instelbare structuur-, vorm-, textuur- en UV-instellingen

OpenAPI Markdown

Microsoft · 3D

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

image •verplicht image_url

Sleep een bestand hierheen of

URL naar de bronafbeelding voor 3D-conversie.

resolution standaard 1024

Resolutie van de uitvoer; een hogere resolutie voegt details toe maar duurt langer.

Geavanceerd 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 standaard 2048

Textuurresolutie van de mesh voor baking. Fijnere oppervlaktedetails leiden bij een hogere resolutie tot grotere bestanden.

ss_guidance_strength standaard 7.5

Getrouwheidsregeling voor de initiële 3D-structuur: een hogere waarde volgt de invoerafbeelding nauwkeuriger, met risico op extra ruis.

ss_guidance_rescale standaard 0.7

Regeling voor begeleidingsartefacten in fase 1: lage waarden geven sterkere begeleidingseffecten, hoge waarden een stabielere uitvoer.

ss_guidance_interval_start standaard 0.6

Startgrens van het classifier-free-guidancevenster in fase 1 (ijle structuur), uitgedrukt als een ruisonderdrukkingsfractie. Lagere instellingen starten de begeleiding eerder; alleen het interval van interval_start tot interval_end gebruikt begeleiding, elders vindt verwerking zonder begeleiding plaats.

ss_guidance_interval_end standaard 1

Begeleidingsafkappunt voor fase 1 (ijle structuur): kies een waarde die minstens zo groot is als ss_guidance_interval_start. De waarde geeft de fractie van de bereikte ruisonderdrukking aan waarop classifier-free guidance stopt.

ss_sampling_steps standaard 12

Aantal denoising-stappen voor de initiële structuur: mogelijke kwaliteitswinst door extra stappen gaat ten koste van tragere verwerking.

ss_rescale_t standaard 5

Stel de scherpte van de overgang in via het ruisrooster voor structuurgeneratie: een hogere waarde maakt overgangen scherper.

shape_slat_guidance_strength standaard 7.5

Getrouwheidsregeling voor gedetailleerde geometrie: een hogere overeenkomst met de invoerafbeelding levert extra details op, met risico op extra ruis.

shape_slat_guidance_rescale standaard 0.5

Verhoog deze instelling wanneer de geometrie ruis bevat: dit vermindert artefacten door sterke begeleiding tijdens de vormfase.

shape_slat_guidance_interval_start standaard 0.6

Activeringspunt van classifier-free guidance voor vormverfijning in fase 2. Uitgedrukt als fractie van de voortgang van de ruisonderdrukking stelt dit interval_start in; begeleiding werkt alleen binnen het venster tussen interval_start en interval_end.

shape_slat_guidance_interval_end standaard 1

Begeleidingsafkappunt voor fase 2 (vormverfijning): kies een waarde die minstens zo groot is als shape_slat_guidance_interval_start. De waarde geeft de fractie van de bereikte ruisonderdrukking aan waarop classifier-free guidance stopt.

shape_slat_sampling_steps standaard 12

Aantal denoising-stappen voor vormverfijning: mogelijk vloeiendere geometrie gaat bij extra stappen ten koste van snelheid.

shape_slat_rescale_t standaard 3

Stel de scherpte van geometrische details in via het ruisrooster voor vormverfijning; een hogere waarde levert scherpere details op.

tex_slat_guidance_strength standaard 1

Regeling voor kleurgetrouwheid van de textuur: een hogere overeenkomst met de kleuren in de invoerafbeelding verhoogt de levendigheid, maar kan oververzadiging veroorzaken.

tex_slat_guidance_rescale standaard 0

Verhoog deze instelling bij ruisachtige texturen of kleurbanding: dit vermindert artefacten door sterke begeleiding tijdens de textuurfase.

tex_slat_guidance_interval_start standaard 0.6

Activeringspunt van classifier-free guidance voor textuurgeneratie in fase 3. Uitgedrukt als fractie van de voortgang van de ruisonderdrukking stelt dit interval_start in; begeleiding werkt alleen binnen het venster tussen interval_start en interval_end.

tex_slat_guidance_interval_end standaard 0.9

Begeleidingsafkappunt voor fase 3 (textuur): kies een waarde die minstens zo groot is als tex_slat_guidance_interval_start. De waarde geeft de fractie van de bereikte ruisonderdrukking aan waarop classifier-free guidance stopt.

tex_slat_sampling_steps standaard 12

Aantal denoising-stappen voor het genereren van texturen. Een hoger aantal stappen duurt langer, maar kan schonere texturen opleveren.

tex_slat_rescale_t standaard 3

Stel de scherpte van textuurdetails in via het ruisrooster voor textuurgeneratie; een hogere waarde levert scherpere details op.

decimation_target standaard 500000

Doel voor het aantal mesh-vertices: 500k wordt aanbevolen voor algemeen gebruik en 20k–50k voor web/mobiel. Een lager doel ruilt meshdetail in voor kleinere bestanden.

remesh_band standaard 1

Toegestane beweging bij remeshing: extra afvlakking kan fijne details opofferen wanneer deze waarde wordt verhoogd. De instelling beperkt de verplaatsing van vertices ten opzichte van het oorspronkelijke oppervlak.

remesh_project standaard 0

Projectiekracht voor het terugbrengen van geremeshte vertices naar het oorspronkelijke oppervlak: 1 behoudt details via volledige projectie, terwijl 0 projectie uitschakelt voor een gladder resultaat.

uv_unwrap_angle_threshold_deg standaard 90

Hoeklimiet van de UV-chart in graden, die beperkt hoeveel naburige vlaksnormalen binnen één chart mogen verschillen. Een hogere limiet geeft de voorkeur aan minder, grotere charts met risico op uitrekking; een lagere limiet geeft de voorkeur aan meer charts en minder vervorming.

uv_unwrap_refine_iterations standaard 0

Aantal lokale verfijningspasses voor het berekenen van UV-charts.

uv_unwrap_global_iterations standaard 1

De balans van UV-charts kan worden verbeterd door dit aantal globale clusteringpasses voor het berekenen van de charts te verhogen.

uv_unwrap_smooth_strength standaard 1

Pas aan hoe sterk de randen van UV-charts worden afgevlakt; minder zichtbare naden bij hogere instellingen brengen risico op UV-vervorming met zich mee.

seed

Seed voor reproduceerbare willekeurige generatie.

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

Deze request uitvoeren

API-sleutel

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. Onthouden in deze browser API-sleutel ophalen

Over Trellis 2

Bouwt een 3D-asset uit één afbeelding (`image_url`) en retourneert een GLB-bestand. `resolution` is 512, 1024 of 1536 en `texture_size` is 1024, 2048 of 4096. Elk van de drie fasen (structuur, vorm, textuur) heeft eigen instellingen voor guidance en samplingstappen. `decimation_target` stelt het aantal meshvertices in (5,000 tot 2,000,000) en opties voor remeshing en UV-unwrapping worden beschikbaar gesteld.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving

seedoptioneel

Typeinteger | null

Seed voor reproduceerbare willekeurige generatie.

resolutionoptioneel

Typeenum

Standaard1024

51210241536

Resolutie van de uitvoer; een hogere resolutie voegt details toe maar duurt langer.

ss_guidance_strengthoptioneel

Typenumber

Standaard7.5

0 – 10

Getrouwheidsregeling voor de initiële 3D-structuur: een hogere waarde volgt de invoerafbeelding nauwkeuriger, met risico op extra ruis.

ss_guidance_rescaleoptioneel

Typenumber

Standaard0.7

0 – 1

Regeling voor begeleidingsartefacten in fase 1: lage waarden geven sterkere begeleidingseffecten, hoge waarden een stabielere uitvoer.

ss_guidance_interval_startoptioneel

Typenumber

Standaard0.6

0 – 1

ss_guidance_interval_endoptioneel

Typenumber

Standaard1

0 – 1

ss_sampling_stepsoptioneel

Typeinteger

Standaard12

1 – 50

Aantal denoising-stappen voor de initiële structuur: mogelijke kwaliteitswinst door extra stappen gaat ten koste van tragere verwerking.

ss_rescale_toptioneel

Typenumber

Standaard5

1 – 6

Stel de scherpte van de overgang in via het ruisrooster voor structuurgeneratie: een hogere waarde maakt overgangen scherper.

shape_slat_guidance_strengthoptioneel

Typenumber

Standaard7.5

0 – 10

Getrouwheidsregeling voor gedetailleerde geometrie: een hogere overeenkomst met de invoerafbeelding levert extra details op, met risico op extra ruis.

shape_slat_guidance_rescaleoptioneel

Typenumber

Standaard0.5

0 – 1

Verhoog deze instelling wanneer de geometrie ruis bevat: dit vermindert artefacten door sterke begeleiding tijdens de vormfase.

shape_slat_guidance_interval_startoptioneel

Typenumber

Standaard0.6

0 – 1

shape_slat_guidance_interval_endoptioneel

Typenumber

Standaard1

0 – 1

shape_slat_sampling_stepsoptioneel

Typeinteger

Standaard12

1 – 50

Aantal denoising-stappen voor vormverfijning: mogelijk vloeiendere geometrie gaat bij extra stappen ten koste van snelheid.

shape_slat_rescale_toptioneel

Typenumber

Standaard3

1 – 6

Stel de scherpte van geometrische details in via het ruisrooster voor vormverfijning; een hogere waarde levert scherpere details op.

tex_slat_guidance_strengthoptioneel

Typenumber

Standaard1

0 – 10

Regeling voor kleurgetrouwheid van de textuur: een hogere overeenkomst met de kleuren in de invoerafbeelding verhoogt de levendigheid, maar kan oververzadiging veroorzaken.

tex_slat_guidance_rescaleoptioneel

Typenumber

Standaard0

0 – 1

Verhoog deze instelling bij ruisachtige texturen of kleurbanding: dit vermindert artefacten door sterke begeleiding tijdens de textuurfase.

tex_slat_guidance_interval_startoptioneel

Typenumber

Standaard0.6

0 – 1

tex_slat_guidance_interval_endoptioneel

Typenumber

Standaard0.9

0 – 1

tex_slat_sampling_stepsoptioneel

Typeinteger

Standaard12

1 – 50

Aantal denoising-stappen voor het genereren van texturen. Een hoger aantal stappen duurt langer, maar kan schonere texturen opleveren.

tex_slat_rescale_toptioneel

Typenumber

Standaard3

1 – 6

Stel de scherpte van textuurdetails in via het ruisrooster voor textuurgeneratie; een hogere waarde levert scherpere details op.

decimation_targetoptioneel

Typeinteger

Standaard500000

5.000 – 2.000.000

Doel voor het aantal mesh-vertices: 500k wordt aanbevolen voor algemeen gebruik en 20k–50k voor web/mobiel. Een lager doel ruilt meshdetail in voor kleinere bestanden.

texture_sizeoptioneel

Typeenum

Standaard2048

102420484096

Textuurresolutie van de mesh voor baking. Fijnere oppervlaktedetails leiden bij een hogere resolutie tot grotere bestanden.

remeshoptioneel

Typeboolean

Standaardtrue

Topologieherbouw die schonere meshdriehoeken maakt en doorgaans de geschiktheid voor later gebruik, zoals animatie of 3D-printen, verbetert, ten koste van tragere verwerking.

remesh_bandoptioneel

Typenumber

Standaard1

0 – 4

remesh_projectoptioneel

Typenumber

Standaard0

0 – 1

uv_unwrap_angle_threshold_degoptioneel

Typenumber

Standaard90

0 – 180

uv_unwrap_refine_iterationsoptioneel

Typeinteger

Standaard0

0 – 10

Aantal lokale verfijningspasses voor het berekenen van UV-charts.

uv_unwrap_global_iterationsoptioneel

Typeinteger

Standaard1

1 – 10

De balans van UV-charts kan worden verbeterd door dit aantal globale clusteringpasses voor het berekenen van de charts te verhogen.

uv_unwrap_smooth_strengthoptioneel

Typenumber

Standaard1

0 – 10

Pas aan hoe sterk de randen van UV-charts worden afgevlakt; minder zichtbare naden bij hogere instellingen brengen risico op UV-vervorming met zich mee.

image_urlverplicht image

Typeurl · image

URL naar de bronafbeelding voor 3D-conversie.

verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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

Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.

Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.

Velden van de uitvoer

model_glb: object {url, content_type, file_name, file_size}3D-model gegenereerd in GLB-indeling.

Meer modellen: Afbeelding naar 3D

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/trellis-2.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt

Je eerste resultaat komt hier

Een aanvraag samenstellen

Deze request uitvoeren

Over Trellis 2

Parameters

Uitvoer

Andere varianten van Trellis 2

Trellis 2 · Retexture Varianten: 2

Meer modellen: Afbeelding naar 3D

Trellis Varianten: 2

Trellis · Multi Varianten: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Varianten: 6