Vai al contenuto

TRELLIS.2 LoRA Inference

Integra

ID del modello trellis-2-lora
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/trellis-2-lora?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Questa richiesta: 0,25 $ 250 crediti API · ≈ 26,37 ₽ Esegui in questa pagina

Ottieni la chiave API
Microsoft Da immagine a 3D

Conversione da immagine a 3D di Trellis 2 con applicazione di adattatori LoRA personalizzati per struttura, geometria e texture

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 sorgente per la conversione in un modello 3D.

resolution predefinito 512

Risoluzione della generazione: 1024 seleziona la pipeline cascade. Scegli la risoluzione usata per addestrare gli adattatori LoRA forniti; è necessaria una corrispondenza.

Avanzate texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · 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 · seed · enable_safety_checker

Checkpoint LoRA opzionale in formato safetensors, addestrato specificamente per il denoiser delle texture.

texture_size predefinito 2048

Risoluzione delle texture incorporate nell'esportazione GLB.

Checkpoint LoRA opzionale in formato safetensors, addestrato specificamente per il denoiser della struttura sparsa.

Checkpoint LoRA opzionale in formato safetensors, addestrato specificamente per il denoiser della geometria.

predefinito 7.5

Intensità della guida senza classificatore durante la generazione della struttura sparsa.

predefinito 0.7

Ridimensionamento della guida durante la generazione della struttura sparsa. Valori maggiori rendono l'output più stabile.

predefinito 0.6

Frazione dell'avanzamento della riduzione del rumore in cui inizia la guida della struttura sparsa.

predefinito 1

Usa una frazione di denoising maggiore o uguale a `ss_guidance_interval_start` per specificare quando termina la guida basata sulla struttura sparsa.

predefinito 12

Numero di passaggi di riduzione del rumore durante la generazione della struttura sparsa.

predefinito 5

Nitidezza del programma del rumore durante la generazione della struttura sparsa.

predefinito 7.5

Intensità della guida senza classificatore durante la generazione della forma.

predefinito 0.5

Ridimensionamento applicato alla guida durante la generazione della forma; aumentalo quando la geometria appare rumorosa.

predefinito 0.6

Frazione della riduzione del rumore in cui inizia la guida della fase della forma.

predefinito 1

Punto di arresto della guida della fase della forma, espresso come frazione di riduzione del rumore non inferiore a shape_slat_guidance_interval_start.

predefinito 12

Numero di passaggi di riduzione del rumore durante la generazione della forma.

predefinito 3

Nitidezza del programma del rumore durante la generazione della forma.

predefinito 1

Intensità della guida senza classificatore durante la generazione delle texture.

predefinito 0

Ridimensionamento applicato alla guida durante la generazione delle texture; aumentalo quando le texture appaiono rumorose.

predefinito 0.6

Frazione della riduzione del rumore in cui inizia la guida della fase delle texture.

predefinito 0.9

Punto di arresto della guida della fase delle texture, espresso come frazione di riduzione del rumore non inferiore a tex_slat_guidance_interval_start.

predefinito 12

Numero di passaggi di riduzione del rumore durante la generazione delle texture.

predefinito 3

Nitidezza del programma del rumore durante la generazione delle texture.

predefinito 500000

Numero desiderato di vertici nell'esportazione GLB.

Seed casuale che rende riproducibile la generazione.

POST /run/trellis-2-lora?wait=20 preventivo → 0,25 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/trellis-2-lora?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.ru/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 LoRA Inference

Genera un GLB da `image_url`, applicando facoltativamente LoRA safetensors tramite `sparse_structure_lora_url`, `geometry_lora_url` e `texture_lora_url`. `resolution` è 512 o 1024 e deve corrispondere alla risoluzione di addestramento degli adattatori. Sono inoltre disponibili controlli per guida e passaggi di ogni fase, `decimation_target` e `texture_size`.

Parametri

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

NomeTipo PredefinitoConsentiti Descrizione
image_urlobbligatorio image
Tipourl · image
URL dell'immagine sorgente per la conversione in un modello 3D.
sparse_structure_lora_urlfacoltativo
Tipostring | null
Checkpoint LoRA opzionale in formato safetensors, addestrato specificamente per il denoiser della struttura sparsa.
geometry_lora_urlfacoltativo
Tipostring | null
Checkpoint LoRA opzionale in formato safetensors, addestrato specificamente per il denoiser della geometria.
texture_lora_urlfacoltativo
Tipostring | null
Checkpoint LoRA opzionale in formato safetensors, addestrato specificamente per il denoiser delle texture.
seedfacoltativo
Tipointeger | null
Seed casuale che rende riproducibile la generazione.
resolutionfacoltativo
Tipoenum
Predefinito512
5121024
Risoluzione della generazione: 1024 seleziona la pipeline cascade. Scegli la risoluzione usata per addestrare gli adattatori LoRA forniti; è necessaria una corrispondenza.
ss_guidance_strengthfacoltativo
Tiponumber
Predefinito7.5
0 – 10
Intensità della guida senza classificatore durante la generazione della struttura sparsa.
ss_guidance_rescalefacoltativo
Tiponumber
Predefinito0.7
0 – 1
Ridimensionamento della guida durante la generazione della struttura sparsa. Valori maggiori rendono l'output più stabile.
ss_guidance_interval_startfacoltativo
Tiponumber
Predefinito0.6
0 – 1
Frazione dell'avanzamento della riduzione del rumore in cui inizia la guida della struttura sparsa.
ss_guidance_interval_endfacoltativo
Tiponumber
Predefinito1
0 – 1
Usa una frazione di denoising maggiore o uguale a `ss_guidance_interval_start` per specificare quando termina la guida basata sulla struttura sparsa.
ss_sampling_stepsfacoltativo
Tipointeger
Predefinito12
1 – 50
Numero di passaggi di riduzione del rumore durante la generazione della struttura sparsa.
ss_rescale_tfacoltativo
Tiponumber
Predefinito5
1 – 6
Nitidezza del programma del rumore durante la generazione della struttura sparsa.
shape_slat_guidance_strengthfacoltativo
Tiponumber
Predefinito7.5
0 – 10
Intensità della guida senza classificatore durante la generazione della forma.
shape_slat_guidance_rescalefacoltativo
Tiponumber
Predefinito0.5
0 – 1
Ridimensionamento applicato alla guida durante la generazione della forma; aumentalo quando la geometria appare rumorosa.
shape_slat_guidance_interval_startfacoltativo
Tiponumber
Predefinito0.6
0 – 1
Frazione della riduzione del rumore in cui inizia la guida della fase della forma.
shape_slat_guidance_interval_endfacoltativo
Tiponumber
Predefinito1
0 – 1
Punto di arresto della guida della fase della forma, espresso come frazione di riduzione del rumore non inferiore a shape_slat_guidance_interval_start.
shape_slat_sampling_stepsfacoltativo
Tipointeger
Predefinito12
1 – 50
Numero di passaggi di riduzione del rumore durante la generazione della forma.
shape_slat_rescale_tfacoltativo
Tiponumber
Predefinito3
1 – 6
Nitidezza del programma del rumore durante la generazione della forma.
tex_slat_guidance_strengthfacoltativo
Tiponumber
Predefinito1
0 – 10
Intensità della guida senza classificatore durante la generazione delle texture.
tex_slat_guidance_rescalefacoltativo
Tiponumber
Predefinito0
0 – 1
Ridimensionamento applicato alla guida durante la generazione delle texture; aumentalo quando le texture appaiono rumorose.
tex_slat_guidance_interval_startfacoltativo
Tiponumber
Predefinito0.6
0 – 1
Frazione della riduzione del rumore in cui inizia la guida della fase delle texture.
tex_slat_guidance_interval_endfacoltativo
Tiponumber
Predefinito0.9
0 – 1
Punto di arresto della guida della fase delle texture, espresso 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 riduzione del rumore durante la generazione delle texture.
tex_slat_rescale_tfacoltativo
Tiponumber
Predefinito3
1 – 6
Nitidezza del programma del rumore durante la generazione delle texture.
decimation_targetfacoltativo
Tipointeger
Predefinito500000
5000 – 2.000.000
Numero desiderato di vertici nell'esportazione GLB.
texture_sizefacoltativo
Tipoenum
Predefinito2048
102420484096
Risoluzione delle texture incorporate nell'esportazione GLB.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Il controllo può essere allentato impostando false, se il chiamante è autorizzato.
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-lora",
  "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": 250,
    "usd": "0.25",
    "charged": 250,
    "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
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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}File GLB contenente il modello 3D generato.
seed
integerSeed applicato durante la generazione.
resolution
integerRisoluzione alla quale è stata eseguita la generazione.
sparse_structure_lora_url
string | nullCheckpoint LoRA della struttura sparsa usato durante la generazione, se applicato.
geometry_lora_url
string | nullCheckpoint LoRA della geometria usato durante la generazione, se applicato.
texture_lora_url
string | nullCheckpoint LoRA delle texture usato durante la generazione, se applicato.
decimation_target
integerTarget del numero di vertici applicato all'esportazione GLB.
texture_size
integerRisoluzione delle texture incorporate nell'esportazione GLB.

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