Trellis 2

Integra

ID del modello 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/it/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"
  }
}

Chiama il modello Trellis 2 (trellis-2) tramite Doitong API. Documentazione per gli agenti: https://doitong.com/it/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"
}

Se lo stato della risposta è "queued" o "running", interroga GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 finché non diventa "succeeded"; i file si trovano in outputs[].url. POST https://api.doitong.com/v1/quote/trellis-2 con lo stesso body restituisce il prezzo esatto prima dell'esecuzione.

Questa richiesta: 0,30 $ 300 crediti API Esegui in questa pagina

Ottieni la chiave API

Microsoft Da immagine a 3D #image-to-3d

Trasforma una singola immagine in una mesh 3D GLB con texture e impostazioni regolabili per struttura, forma, texture e UV

OpenAPI Markdown

Microsoft · 3D

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

image •obbligatorio image_url

Trascina un file oppure

URL che punta all'immagine sorgente per la conversione 3D.

resolution predefinito 1024

Risoluzione dell'output; aumentarla aggiunge dettagli ma richiede più tempo.

Avanzate 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 predefinito 2048

Risoluzione della texture della mesh per il baking. Un maggiore dettaglio della superficie comporta file più grandi quando si aumenta questa risoluzione.

ss_guidance_strength predefinito 7.5

Controllo della fedeltà della struttura 3D iniziale: aumentarlo favorisce una maggiore corrispondenza con l'immagine input, con il rischio di più rumore.

ss_guidance_rescale predefinito 0.7

Controllo degli artefatti di guida dello stage 1, che privilegia effetti di guida più forti ai valori bassi e un output più stabile ai valori alti.

ss_guidance_interval_start predefinito 0.6

Limite iniziale della finestra di guida senza classificatore nella fase 1 (struttura sparsa), espresso come frazione di riduzione del rumore. Valori inferiori avviano prima la guida; solo l'intervallo da interval_start a interval_end usa la guida, mentre il resto viene elaborato senza guida.

ss_guidance_interval_end predefinito 1

Limite della guida per la fase 1 (struttura sparsa): scegli un valore almeno pari a ss_guidance_interval_start. Indica la frazione di riduzione del rumore raggiunta quando termina la guida senza classificatore.

ss_sampling_steps predefinito 12

Numero di passaggi di denoising della struttura iniziale: i possibili miglioramenti della qualità con passaggi aggiuntivi comportano un'elaborazione più lenta.

ss_rescale_t predefinito 5

Imposta la nitidezza della transizione tramite il programma di rumore della generazione della struttura: aumentare questo valore rende le transizioni più nette.

shape_slat_guidance_strength predefinito 7.5

Controllo della fedeltà della geometria dettagliata: aumentare l'aderenza all'immagine input aggiunge dettagli, con il rischio di più rumore.

shape_slat_guidance_rescale predefinito 0.5

Aumenta questa impostazione quando la geometria appare rumorosa: riduce gli artefatti causati da una guida forte durante lo stage della forma.

shape_slat_guidance_interval_start predefinito 0.6

Punto di attivazione della guida senza classificatore per il perfezionamento della forma nella fase 2. Espresso come frazione dell'avanzamento della riduzione del rumore, imposta interval_start; la guida opera solo nella finestra delimitata da interval_start e interval_end.

shape_slat_guidance_interval_end predefinito 1

Limite della guida per la fase 2 (perfezionamento della forma): scegli un valore almeno pari a shape_slat_guidance_interval_start. Indica la frazione di riduzione del rumore raggiunta quando termina la guida senza classificatore.

shape_slat_sampling_steps predefinito 12

Numero di passaggi di denoising per il perfezionamento della forma: usare passaggi aggiuntivi può rendere la geometria più uniforme, a scapito della velocità.

shape_slat_rescale_t predefinito 3

Imposta la nitidezza dei dettagli geometrici tramite il programma di rumore del perfezionamento della forma; aumentare questo valore produce dettagli più netti.

tex_slat_guidance_strength predefinito 1

Controllo della fedeltà cromatica della texture: una maggiore aderenza ai colori dell'immagine input con impostazioni elevate aumenta la vividezza, ma può causare sovrasaturazione.

tex_slat_guidance_rescale predefinito 0

Aumenta questa impostazione per correggere texture rumorose o bande di colore: riduce gli artefatti causati da una guida forte durante lo stage della texture.

tex_slat_guidance_interval_start predefinito 0.6

Punto di attivazione della guida senza classificatore per la generazione delle texture nella fase 3. Espresso come frazione dell'avanzamento della riduzione del rumore, imposta interval_start; la guida opera solo nella finestra delimitata da interval_start e interval_end.

tex_slat_guidance_interval_end predefinito 0.9

Limite della guida per la fase 3 (texture): scegli un valore almeno pari a tex_slat_guidance_interval_start. Indica la frazione di riduzione del rumore raggiunta quando termina la guida senza classificatore.

tex_slat_sampling_steps predefinito 12

Numero di passaggi di denoising usati per generare le texture. Aumentare il numero di passaggi richiede più tempo ma può produrre texture più pulite.

tex_slat_rescale_t predefinito 3

Imposta la nitidezza dei dettagli della texture tramite il programma di rumore della generazione della texture; aumentare questo valore produce dettagli più netti.

decimation_target predefinito 500000

Numero target di vertici della mesh: 500k è consigliato per uso generale e 20k–50k per web/mobile. Ridurre il target sacrifica dettagli della mesh in cambio di file più piccoli.

remesh_band predefinito 1

Tolleranza al movimento del remeshing: un maggiore smoothing può sacrificare i dettagli fini. L'impostazione limita lo spostamento dei vertici rispetto alla superficie originale.

remesh_project predefinito 0

Intensità della proiezione per riportare i vertici sottoposti a remeshing sulla superficie originale: 1 conserva i dettagli tramite proiezione completa, mentre 0 disattiva la proiezione per un risultato più uniforme.

uv_unwrap_angle_threshold_deg predefinito 90

Limite angolare delle chart UV in gradi, che limita la differenza tra le normali delle facce adiacenti in una chart. Aumentarlo favorisce chart meno numerose e più grandi, con rischio di deformazione; ridurlo favorisce più chart e meno distorsione.

uv_unwrap_refine_iterations predefinito 0

Numero di passaggi di perfezionamento locali usati per calcolare le chart UV.

uv_unwrap_global_iterations predefinito 1

L'equilibrio delle chart UV può migliorare aumentando questo numero di passaggi di clustering globale usati per calcolarle.

uv_unwrap_smooth_strength predefinito 1

Regola l'intensità dello smoothing dei bordi delle chart UV; impostazioni più alte riducono le giunzioni visibili ma aumentano il rischio di distorsione UV.

seed

Seed usato per una generazione casuale riproducibile.

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

Esegui questa richiesta

Chiave API

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ricorda in questo browser Ottieni una chiave API

Informazioni su Trellis 2

Crea una risorsa 3D da un'immagine (`image_url`) e restituisce un file GLB. `resolution` è 512, 1024 o 1536, mentre `texture_size` è 1024, 2048 o 4096. Ognuna delle tre fasi (struttura, forma, texture) dispone di controlli propri per guida e passaggi di campionamento. `decimation_target` imposta il numero di vertici della mesh (da 5,000 a 2,000,000) e sono disponibili opzioni di remeshing e apertura UV.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione

seedfacoltativo

Tipointeger | null

Seed usato per una generazione casuale riproducibile.

resolutionfacoltativo

Tipoenum

Predefinito1024

51210241536

Risoluzione dell'output; aumentarla aggiunge dettagli ma richiede più tempo.

ss_guidance_strengthfacoltativo

Tiponumber

Predefinito7.5

0 – 10

Controllo della fedeltà della struttura 3D iniziale: aumentarlo favorisce una maggiore corrispondenza con l'immagine input, con il rischio di più rumore.

ss_guidance_rescalefacoltativo

Tiponumber

Predefinito0.7

0 – 1

Controllo degli artefatti di guida dello stage 1, che privilegia effetti di guida più forti ai valori bassi e un output più stabile ai valori alti.

ss_guidance_interval_startfacoltativo

Tiponumber

Predefinito0.6

0 – 1

ss_guidance_interval_endfacoltativo

Tiponumber

Predefinito1

0 – 1

ss_sampling_stepsfacoltativo

Tipointeger

Predefinito12

1 – 50

Numero di passaggi di denoising della struttura iniziale: i possibili miglioramenti della qualità con passaggi aggiuntivi comportano un'elaborazione più lenta.

ss_rescale_tfacoltativo

Tiponumber

Predefinito5

1 – 6

Imposta la nitidezza della transizione tramite il programma di rumore della generazione della struttura: aumentare questo valore rende le transizioni più nette.

shape_slat_guidance_strengthfacoltativo

Tiponumber

Predefinito7.5

0 – 10

Controllo della fedeltà della geometria dettagliata: aumentare l'aderenza all'immagine input aggiunge dettagli, con il rischio di più rumore.

shape_slat_guidance_rescalefacoltativo

Tiponumber

Predefinito0.5

0 – 1

Aumenta questa impostazione quando la geometria appare rumorosa: riduce gli artefatti causati da una guida forte durante lo stage della forma.

shape_slat_guidance_interval_startfacoltativo

Tiponumber

Predefinito0.6

0 – 1

shape_slat_guidance_interval_endfacoltativo

Tiponumber

Predefinito1

0 – 1

shape_slat_sampling_stepsfacoltativo

Tipointeger

Predefinito12

1 – 50

Numero di passaggi di denoising per il perfezionamento della forma: usare passaggi aggiuntivi può rendere la geometria più uniforme, a scapito della velocità.

shape_slat_rescale_tfacoltativo

Tiponumber

Predefinito3

1 – 6

Imposta la nitidezza dei dettagli geometrici tramite il programma di rumore del perfezionamento della forma; aumentare questo valore produce dettagli più netti.

tex_slat_guidance_strengthfacoltativo

Tiponumber

Predefinito1

0 – 10

Controllo della fedeltà cromatica della texture: una maggiore aderenza ai colori dell'immagine input con impostazioni elevate aumenta la vividezza, ma può causare sovrasaturazione.

tex_slat_guidance_rescalefacoltativo

Tiponumber

Predefinito0

0 – 1

Aumenta questa impostazione per correggere texture rumorose o bande di colore: riduce gli artefatti causati da una guida forte durante lo stage della texture.

tex_slat_guidance_interval_startfacoltativo

Tiponumber

Predefinito0.6

0 – 1

tex_slat_guidance_interval_endfacoltativo

Tiponumber

Predefinito0.9

0 – 1

tex_slat_sampling_stepsfacoltativo

Tipointeger

Predefinito12

1 – 50

Numero di passaggi di denoising usati per generare le texture. Aumentare il numero di passaggi richiede più tempo ma può produrre texture più pulite.

tex_slat_rescale_tfacoltativo

Tiponumber

Predefinito3

1 – 6

Imposta la nitidezza dei dettagli della texture tramite il programma di rumore della generazione della texture; aumentare questo valore produce dettagli più netti.

decimation_targetfacoltativo

Tipointeger

Predefinito500000

5000 – 2.000.000

Numero target di vertici della mesh: 500k è consigliato per uso generale e 20k–50k per web/mobile. Ridurre il target sacrifica dettagli della mesh in cambio di file più piccoli.

texture_sizefacoltativo

Tipoenum

Predefinito2048

102420484096

Risoluzione della texture della mesh per il baking. Un maggiore dettaglio della superficie comporta file più grandi quando si aumenta questa risoluzione.

remeshfacoltativo

Tipoboolean

Predefinitotrue

Ricostruzione della topologia che crea triangoli della mesh più puliti, migliorando in genere l'idoneità per usi successivi come animazione o stampa 3D, a costo di un'elaborazione più lenta.

remesh_bandfacoltativo

Tiponumber

Predefinito1

0 – 4

Tolleranza al movimento del remeshing: un maggiore smoothing può sacrificare i dettagli fini. L'impostazione limita lo spostamento dei vertici rispetto alla superficie originale.

remesh_projectfacoltativo

Tiponumber

Predefinito0

0 – 1

uv_unwrap_angle_threshold_degfacoltativo

Tiponumber

Predefinito90

0 – 180

uv_unwrap_refine_iterationsfacoltativo

Tipointeger

Predefinito0

0 – 10

Numero di passaggi di perfezionamento locali usati per calcolare le chart UV.

uv_unwrap_global_iterationsfacoltativo

Tipointeger

Predefinito1

1 – 10

L'equilibrio delle chart UV può migliorare aumentando questo numero di passaggi di clustering globale usati per calcolarle.

uv_unwrap_smooth_strengthfacoltativo

Tiponumber

Predefinito1

0 – 10

Regola l'intensità dello smoothing dei bordi delle chart UV; impostazioni più alte riducono le giunzioni visibili ma aumentano il rischio di distorsione UV.

image_urlobbligatorio image

Tipourl · image

URL che punta all'immagine sorgente per la conversione 3D.

obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

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

I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.

Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.

Campi dell'output

model_glb: object {url, content_type, file_name, file_size}Modello 3D generato in formato GLB.

Altri modelli: Da immagine a 3D

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/trellis-2.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt

Il tuo primo risultato apparirà qui

Crea una richiesta

Esegui questa richiesta

Informazioni su Trellis 2

Parametri

Output

Altre varianti di Trellis 2

Trellis 2 · Retexture Varianti: 2

Altri modelli: Da immagine a 3D

Trellis Varianti: 2

Trellis · Multi Varianti: 2

TRELLIS.2 LoRA Inference

Hi3D Image to 3D Varianti: 6