Vai al contenuto

Trellis 2 · Retexture

Integra

ID del modello trellis-2/retexture
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

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

Questa richiesta: 0,24 $ 240 crediti API Esegui in questa pagina

Ottieni la chiave API
Microsoft Da immagine a 3D #image-to-3d

Applica nuove texture a una mesh 3D esistente priva di texture per adattarla a un'immagine di riferimento, con output GLB

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.

•obbligatorio image_url
Trascina un file oppure

URL dell'immagine di riferimento usata per la texturing.

resolution predefinito 1024

I dettagli delle texture e la velocità di elaborazione dipendono da questa risoluzione di generazione interna: aumentandola si ottengono dettagli più fini ma l'elaborazione richiede più tempo.

•obbligatorio

URL sorgente per il retexturing di una mesh 3D senza texture in formato GLB, OBJ, PLY o STL.

Avanzate texture_size · 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 · seed
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.

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.

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.

predefinito 0.6

Punto di attivazione della guida senza classificatore per la generazione delle texture. 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.

predefinito 0.9

Limite di arresto della guida senza classificatore della fase delle texture, specificato come frazione di riduzione del rumore non inferiore a tex_slat_guidance_interval_start.

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.

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.

Seed usato per una generazione casuale riproducibile.

POST /run/trellis-2/retexture?wait=20 preventivo → 0,24 $
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

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

Esegui questa richiesta

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

Informazioni su Trellis 2 · Retexture

Applica una nuova texture alla mesh in `mesh_url` (GLB, OBJ, PLY o STL) basandosi su un'immagine di riferimento `image_url`. `resolution` è 512 o 1024 e `texture_size` è 1024, 2048 o 4096. Sono disponibili controlli di guida e campionamento per la fase texture. La geometria non viene rigenerata.

Parametri

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

NomeTipo PredefinitoConsentiti Descrizione
image_urlobbligatorio image
Tipourl · image
URL dell'immagine di riferimento usata per la texturing.
mesh_urlobbligatorio
Tipostring
URL sorgente per il retexturing di una mesh 3D senza texture in formato GLB, OBJ, PLY o STL.
seedfacoltativo
Tipointeger | null
Seed usato per una generazione casuale riproducibile.
resolutionfacoltativo
Tipoenum
Predefinito1024
5121024
I dettagli delle texture e la velocità di elaborazione dipendono da questa risoluzione di generazione interna: aumentandola si ottengono dettagli più fini ma l'elaborazione richiede più tempo.
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
Punto di attivazione della guida senza classificatore per la generazione delle texture. 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_endfacoltativo
Tiponumber
Predefinito0.9
0 – 1
Limite di arresto della guida senza classificatore della fase delle texture, specificato come frazione di riduzione del rumore non inferiore a tex_slat_guidance_interval_start.
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.
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.
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/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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/retexture.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt