Trellis 2

Integrieren

Modell-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/de/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"
  }
}

Rufe das Modell Trellis 2 (trellis-2) über die Doitong API auf. Dokumentation für Agenten: https://doitong.com/de/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"
}

Wenn der Antwortstatus "queued" oder "running" lautet, frage GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 ab, bis er "succeeded" lautet; die Dateien befinden sich in outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 mit demselben Body gibt den exakten Preis vor der Ausführung zurück.

Diese Anfrage: 0,30 $ 300 API-Credits Auf dieser Seite ausführen

API-Schlüssel abrufen

Microsoft Bild zu 3D #image-to-3d

Erzeugt aus einem Einzelbild ein texturiertes GLB-3D-Mesh mit einstellbaren Struktur-, Form-, Textur- und UV-Einstellungen

OpenAPI Markdown

Microsoft · 3D

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

image •erforderlich image_url

Datei ablegen oder

URL zum Quellbild für die 3D-Konvertierung.

resolution Standard 1024

Auflösung der Ausgabe; eine Erhöhung fügt Details hinzu, benötigt jedoch mehr Zeit.

Erweitert 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 Standard 2048

Texturauflösung des Meshes zum Baken. Feinere Oberflächendetails führen bei höherer Auflösung zu größeren Dateien.

ss_guidance_strength Standard 7.5

Steuerung der anfänglichen 3D-Strukturtreue: höhere Werte begünstigen eine stärkere Übereinstimmung mit dem Eingabebild, können jedoch zusätzliches Rauschen verursachen.

ss_guidance_rescale Standard 0.7

Steuerung von Leitartefakten in Phase 1: niedrige Werte verstärken die Steuerungseffekte, hohe Werte führen zu einer stabileren Ausgabe.

ss_guidance_interval_start Standard 0.6

Startgrenze des classifier-free-guidance-Fensters in Stufe 1 (spärliche Struktur), ausgedrückt als Entrauschungsanteil. Niedrigere Einstellungen beginnen die Anleitung früher; nur das Intervall von interval_start bis interval_end verwendet Anleitung, an anderer Stelle erfolgt die Verarbeitung ohne Anleitung.

ss_guidance_interval_end Standard 1

Anleitungsgrenze für Stufe 1 (spärliche Struktur): Wähle einen Wert mindestens so groß wie ss_guidance_interval_start. Der Wert bezeichnet den erreichten Entrauschungsanteil, bei dem classifier-free guidance endet.

ss_sampling_steps Standard 12

Anzahl der Denoising-Schritte für die anfängliche Struktur; mögliche Qualitätsgewinne durch zusätzliche Schritte gehen mit langsamerer Verarbeitung einher.

ss_rescale_t Standard 5

Schärfe des Übergangs über den Rauschplan der Strukturgenerierung; höhere Werte machen Übergänge schärfer.

shape_slat_guidance_strength Standard 7.5

Steuerung der Treue zur detaillierten Geometrie: höhere Übereinstimmung mit dem Eingabebild liefert zusätzliche Details, birgt jedoch das Risiko von mehr Rauschen.

shape_slat_guidance_rescale Standard 0.5

Erhöhen Sie diese Einstellung, wenn die Geometrie verrauscht wirkt; sie reduziert durch starke Steuerung während der Formphase verursachte Artefakte.

shape_slat_guidance_interval_start Standard 0.6

Aktivierungspunkt der classifier-free guidance für die Formverfeinerung in Stufe 2. Als Anteil des Entrauschungsfortschritts legt er interval_start fest; die Anleitung wirkt nur innerhalb des von interval_start und interval_end begrenzten Fensters.

shape_slat_guidance_interval_end Standard 1

Anleitungsgrenze für Stufe 2 (Formverfeinerung): Wähle einen Wert mindestens so groß wie shape_slat_guidance_interval_start. Der Wert bezeichnet den erreichten Entrauschungsanteil, bei dem classifier-free guidance endet.

shape_slat_sampling_steps Standard 12

Anzahl der Denoising-Schritte zur Formverfeinerung; zusätzliche Schritte können eine glattere Geometrie liefern, verlangsamen jedoch die Verarbeitung.

shape_slat_rescale_t Standard 3

Legt die Schärfe geometrischer Details über den Rauschplan der Formverfeinerung fest; höhere Werte erzeugen schärfere Details.

tex_slat_guidance_strength Standard 1

Steuerung der Farbtreue der Textur: höhere Werte halten sich stärker an die Farben des Eingabebilds, erhöhen die Leuchtkraft, können jedoch Übersättigung verursachen.

tex_slat_guidance_rescale Standard 0

Erhöhen Sie diese Einstellung bei verrauschten Texturen oder Farbstreifen; sie reduziert durch starke Steuerung während der Texturphase verursachte Artefakte.

tex_slat_guidance_interval_start Standard 0.6

Aktivierungspunkt der classifier-free guidance für die Texturgenerierung in Stufe 3. Als Anteil des Entrauschungsfortschritts legt er interval_start fest; die Anleitung wirkt nur innerhalb des von interval_start und interval_end begrenzten Fensters.

tex_slat_guidance_interval_end Standard 0.9

Anleitungsgrenze für Stufe 3 (Textur): Wähle einen Wert mindestens so groß wie tex_slat_guidance_interval_start. Der Wert bezeichnet den erreichten Entrauschungsanteil, bei dem classifier-free guidance endet.

tex_slat_sampling_steps Standard 12

Anzahl der Denoising-Schritte zur TexTurerzeugung. Eine höhere Anzahl benötigt mehr Zeit, kann aber sauberere Texturen liefern.

tex_slat_rescale_t Standard 3

Legt die Schärfe von Texturdetails über den Rauschplan der TexTurerzeugung fest; höhere Werte erzeugen schärfere Details.

decimation_target Standard 500000

Zielanzahl der Mesh-Vertices: 500k wird für allgemeine Zwecke empfohlen, 20k–50k für Web/Mobilgeräte. Eine Verringerung des Ziels tauscht Meshdetails gegen kleinere Dateien.

remesh_band Standard 1

Bewegungsspielraum beim Remeshing: Zusätzliche Glättung kann feine Details beeinträchtigen, wenn dieser Wert erhöht wird. Die Einstellung begrenzt die Vertex-Verschiebung relativ zur ursprünglichen Oberfläche.

remesh_project Standard 0

Projektionsstärke zum Zurückführen remeshter Vertices auf die ursprüngliche Oberfläche: 1 bewahrt Details durch vollständige Projektion, während 0 die Projektion deaktiviert und ein glatteres Ergebnis erzeugt.

uv_unwrap_angle_threshold_deg Standard 90

Winkelgrenze der UV-Charts in Grad, die den Unterschied benachbarter Flächennormalen innerhalb eines Charts begrenzt. Eine Erhöhung begünstigt weniger, größere Charts auf Kosten möglicher Verzerrung; eine Verringerung begünstigt mehr Charts und weniger Verzerrung.

uv_unwrap_refine_iterations Standard 0

Anzahl lokaler Verfeinerungsdurchläufe zur Berechnung der UV-Charts.

uv_unwrap_global_iterations Standard 1

Das Guthaben der UV-Charts kann durch Erhöhen dieser Anzahl globaler Clustering-Durchläufe zur Berechnung der Charts verbessert werden.

uv_unwrap_smooth_strength Standard 1

Steuert, wie stark die Kanten der UV-Charts geglättet werden; weniger sichtbare Nähte bei höheren Einstellungen gehen mit dem Risiko einer UV-Verzerrung einher.

seed

Seed für reproduzierbare Zufallsgenerierung.

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

Diese Anfrage ausführen

API-Schlüssel

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. In diesem Browser merken API-Schlüssel abrufen

Über Trellis 2

Erstellt aus einem Bild (`image_url`) ein 3D-Asset und gibt eine GLB-Datei zurück. `resolution` ist 512, 1024 oder 1536; `texture_size` ist 1024, 2048 oder 4096. Jede der drei Stufen (Struktur, Form, Textur) verfügt über eigene Einstellungen für Führung und Sampling-Schritte. `decimation_target` legt die Anzahl der Mesh-Vertices fest (5,000 bis 2,000,000); Optionen für Remeshing und UV-Unwrapping sind verfügbar.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung

seedoptional

Typinteger | null

Seed für reproduzierbare Zufallsgenerierung.

resolutionoptional

Typenum

Standard1024

51210241536

Auflösung der Ausgabe; eine Erhöhung fügt Details hinzu, benötigt jedoch mehr Zeit.

ss_guidance_strengthoptional

Typnumber

Standard7.5

0 – 10

Steuerung der anfänglichen 3D-Strukturtreue: höhere Werte begünstigen eine stärkere Übereinstimmung mit dem Eingabebild, können jedoch zusätzliches Rauschen verursachen.

ss_guidance_rescaleoptional

Typnumber

Standard0.7

0 – 1

Steuerung von Leitartefakten in Phase 1: niedrige Werte verstärken die Steuerungseffekte, hohe Werte führen zu einer stabileren Ausgabe.

ss_guidance_interval_startoptional

Typnumber

Standard0.6

0 – 1

ss_guidance_interval_endoptional

Typnumber

Standard1

0 – 1

ss_sampling_stepsoptional

Typinteger

Standard12

1 – 50

Anzahl der Denoising-Schritte für die anfängliche Struktur; mögliche Qualitätsgewinne durch zusätzliche Schritte gehen mit langsamerer Verarbeitung einher.

ss_rescale_toptional

Typnumber

Standard5

1 – 6

Schärfe des Übergangs über den Rauschplan der Strukturgenerierung; höhere Werte machen Übergänge schärfer.

shape_slat_guidance_strengthoptional

Typnumber

Standard7.5

0 – 10

Steuerung der Treue zur detaillierten Geometrie: höhere Übereinstimmung mit dem Eingabebild liefert zusätzliche Details, birgt jedoch das Risiko von mehr Rauschen.

shape_slat_guidance_rescaleoptional

Typnumber

Standard0.5

0 – 1

Erhöhen Sie diese Einstellung, wenn die Geometrie verrauscht wirkt; sie reduziert durch starke Steuerung während der Formphase verursachte Artefakte.

shape_slat_guidance_interval_startoptional

Typnumber

Standard0.6

0 – 1

shape_slat_guidance_interval_endoptional

Typnumber

Standard1

0 – 1

shape_slat_sampling_stepsoptional

Typinteger

Standard12

1 – 50

Anzahl der Denoising-Schritte zur Formverfeinerung; zusätzliche Schritte können eine glattere Geometrie liefern, verlangsamen jedoch die Verarbeitung.

shape_slat_rescale_toptional

Typnumber

Standard3

1 – 6

Legt die Schärfe geometrischer Details über den Rauschplan der Formverfeinerung fest; höhere Werte erzeugen schärfere Details.

tex_slat_guidance_strengthoptional

Typnumber

Standard1

0 – 10

Steuerung der Farbtreue der Textur: höhere Werte halten sich stärker an die Farben des Eingabebilds, erhöhen die Leuchtkraft, können jedoch Übersättigung verursachen.

tex_slat_guidance_rescaleoptional

Typnumber

Standard0

0 – 1

Erhöhen Sie diese Einstellung bei verrauschten Texturen oder Farbstreifen; sie reduziert durch starke Steuerung während der Texturphase verursachte Artefakte.

tex_slat_guidance_interval_startoptional

Typnumber

Standard0.6

0 – 1

tex_slat_guidance_interval_endoptional

Typnumber

Standard0.9

0 – 1

tex_slat_sampling_stepsoptional

Typinteger

Standard12

1 – 50

Anzahl der Denoising-Schritte zur TexTurerzeugung. Eine höhere Anzahl benötigt mehr Zeit, kann aber sauberere Texturen liefern.

tex_slat_rescale_toptional

Typnumber

Standard3

1 – 6

Legt die Schärfe von Texturdetails über den Rauschplan der TexTurerzeugung fest; höhere Werte erzeugen schärfere Details.

decimation_targetoptional

Typinteger

Standard500000

5.000 – 2.000.000

Zielanzahl der Mesh-Vertices: 500k wird für allgemeine Zwecke empfohlen, 20k–50k für Web/Mobilgeräte. Eine Verringerung des Ziels tauscht Meshdetails gegen kleinere Dateien.

texture_sizeoptional

Typenum

Standard2048

102420484096

Texturauflösung des Meshes zum Baken. Feinere Oberflächendetails führen bei höherer Auflösung zu größeren Dateien.

remeshoptional

Typboolean

Standardtrue

Topologie-Neuaufbau, der sauberere Mesh-Dreiecke erzeugt und meist die Eignung für spätere Zwecke wie Animation oder 3D-Druck verbessert, aber die Verarbeitung verlangsamt.

remesh_bandoptional

Typnumber

Standard1

0 – 4

remesh_projectoptional

Typnumber

Standard0

0 – 1

uv_unwrap_angle_threshold_degoptional

Typnumber

Standard90

0 – 180

uv_unwrap_refine_iterationsoptional

Typinteger

Standard0

0 – 10

Anzahl lokaler Verfeinerungsdurchläufe zur Berechnung der UV-Charts.

uv_unwrap_global_iterationsoptional

Typinteger

Standard1

1 – 10

Das Guthaben der UV-Charts kann durch Erhöhen dieser Anzahl globaler Clustering-Durchläufe zur Berechnung der Charts verbessert werden.

uv_unwrap_smooth_strengthoptional

Typnumber

Standard1

0 – 10

Steuert, wie stark die Kanten der UV-Charts geglättet werden; weniger sichtbare Nähte bei höheren Einstellungen gehen mit dem Risiko einer UV-Verzerrung einher.

image_urlerforderlich image

Typurl · image

URL zum Quellbild für die 3D-Konvertierung.

erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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

Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.

Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.

Ausgabefelder

model_glb: object {url, content_type, file_name, file_size}Im GLB-Format generiertes 3D-Modell.

Weitere Modelle: Bild zu 3D

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/trellis-2.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt

Dein erstes Ergebnis erscheint hier

Anfrage erstellen

Diese Anfrage ausführen

Über Trellis 2

Parameter

Ausgabe

Weitere Trellis 2-Varianten

Trellis 2 · Retexture Varianten: 2

Weitere Modelle: Bild zu 3D

Trellis Varianten: 2

Trellis · Multi Varianten: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Varianten: 6