Hoppa till innehåll

TRELLIS.2 LoRA Inference

Integrera

Modell-id 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Den här begäran: 0,25 $ 250 API-krediter Kör den på den här sidan

Hämta API-nyckel
Microsoft Bild till 3D

Trellis 2 för bild till 3D som kan tillämpa anpassade LoRA-adaptrar för struktur, geometri och textur

Microsoft · 3D

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

•obligatoriskt image_url
Släpp en fil eller

URL till källbild för konvertering till en 3D-modell.

resolution standard 512

Genereringsupplösning, där 1024 väljer kaskadpipeline. Välj upplösningen som användes för att träna de angivna LoRA-adaptrarna; en matchning krävs.

Avancerat 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

Valfri LoRA-kontrollpunkt i safetensors-format, tränad specifikt för texturavbrusaren.

texture_size standard 2048

Upplösning för texturer som bakas in i GLB-exporten.

Valfri LoRA-kontrollpunkt i safetensors-format, tränad specifikt för avbrusaren för den glesa strukturen.

Valfri LoRA-kontrollpunkt i safetensors-format, tränad specifikt för geometriavbrusaren.

standard 7.5

Styrkan hos klassificerarfri styrning vid generering av gles struktur.

standard 0.7

Omskalning av styrningen vid generering av gles struktur. Högre värden ger stabilare utdata.

standard 0.6

Andel av brusreduceringsförloppet där styrningen för gles struktur börjar.

standard 1

Använd en andel av brusreduceringsförloppet som är minst lika stor som `ss_guidance_interval_start` för att ange när styrningen för gles struktur upphör.

standard 12

Antal brusreduceringssteg vid generering av gles struktur.

standard 5

Brusschemats skärpa vid generering av gles struktur.

standard 7.5

Styrkan hos klassificerarfri styrning vid formgenerering.

standard 0.5

Omskalning av styrningen vid formgenerering. Öka värdet när geometrin ser brusig ut.

standard 0.6

Andel av brusreduceringen där styrningen för formsteget börjar.

standard 1

Slutpunkt för styrningen i formsteget, uttryckt som en andel av brusreduceringen som inte är mindre än shape_slat_guidance_interval_start.

standard 12

Antal brusreduceringssteg under formgenereringen.

standard 3

Brusschemats skärpa under formgenereringen.

standard 1

Styrka för klassificerarfri styrning under texturgenereringen.

standard 0

Omskalning som tillämpas på styrningen under texturgenereringen; höj värdet om texturerna ser brusiga ut.

standard 0.6

Andel av brusreduceringen där styrningen för textursteget börjar.

standard 0.9

Slutpunkt för styrningen i textursteget, uttryckt som en andel av brusreduceringen som inte är mindre än tex_slat_guidance_interval_start.

standard 12

Antal brusreduceringssteg under texturgenereringen.

standard 3

Brusschemats skärpa under texturgenereringen.

standard 500000

Önskat antal hörnpunkter i GLB-exporten.

Slumpmässigt seed som gör genereringen reproducerbar.

POST /run/trellis-2-lora?wait=20 pris → 0,25 $
# 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-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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om TRELLIS.2 LoRA Inference

Genererar en GLB från `image_url` och kan valfritt tillämpa safetensors-LoRA via `sparse_structure_lora_url`, `geometry_lora_url` och `texture_lora_url`. `resolution` är 512 eller 1024 och måste matcha adaptrarnas träningsupplösning. Exponerar även vägledning och stegreglage per stadium, `decimation_target` och `texture_size`.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
image_urlobligatoriskt image
Typurl · image
URL till källbild för konvertering till en 3D-modell.
sparse_structure_lora_urlvalfritt
Typstring | null
Valfri LoRA-kontrollpunkt i safetensors-format, tränad specifikt för avbrusaren för den glesa strukturen.
geometry_lora_urlvalfritt
Typstring | null
Valfri LoRA-kontrollpunkt i safetensors-format, tränad specifikt för geometriavbrusaren.
texture_lora_urlvalfritt
Typstring | null
Valfri LoRA-kontrollpunkt i safetensors-format, tränad specifikt för texturavbrusaren.
seedvalfritt
Typinteger | null
Slumpmässigt seed som gör genereringen reproducerbar.
resolutionvalfritt
Typenum
Standard512
5121024
Genereringsupplösning, där 1024 väljer kaskadpipeline. Välj upplösningen som användes för att träna de angivna LoRA-adaptrarna; en matchning krävs.
ss_guidance_strengthvalfritt
Typnumber
Standard7.5
0 – 10
Styrkan hos klassificerarfri styrning vid generering av gles struktur.
ss_guidance_rescalevalfritt
Typnumber
Standard0.7
0 – 1
Omskalning av styrningen vid generering av gles struktur. Högre värden ger stabilare utdata.
ss_guidance_interval_startvalfritt
Typnumber
Standard0.6
0 – 1
Andel av brusreduceringsförloppet där styrningen för gles struktur börjar.
ss_guidance_interval_endvalfritt
Typnumber
Standard1
0 – 1
Använd en andel av brusreduceringsförloppet som är minst lika stor som `ss_guidance_interval_start` för att ange när styrningen för gles struktur upphör.
ss_sampling_stepsvalfritt
Typinteger
Standard12
1 – 50
Antal brusreduceringssteg vid generering av gles struktur.
ss_rescale_tvalfritt
Typnumber
Standard5
1 – 6
Brusschemats skärpa vid generering av gles struktur.
shape_slat_guidance_strengthvalfritt
Typnumber
Standard7.5
0 – 10
Styrkan hos klassificerarfri styrning vid formgenerering.
shape_slat_guidance_rescalevalfritt
Typnumber
Standard0.5
0 – 1
Omskalning av styrningen vid formgenerering. Öka värdet när geometrin ser brusig ut.
shape_slat_guidance_interval_startvalfritt
Typnumber
Standard0.6
0 – 1
Andel av brusreduceringen där styrningen för formsteget börjar.
shape_slat_guidance_interval_endvalfritt
Typnumber
Standard1
0 – 1
Slutpunkt för styrningen i formsteget, uttryckt som en andel av brusreduceringen som inte är mindre än shape_slat_guidance_interval_start.
shape_slat_sampling_stepsvalfritt
Typinteger
Standard12
1 – 50
Antal brusreduceringssteg under formgenereringen.
shape_slat_rescale_tvalfritt
Typnumber
Standard3
1 – 6
Brusschemats skärpa under formgenereringen.
tex_slat_guidance_strengthvalfritt
Typnumber
Standard1
0 – 10
Styrka för klassificerarfri styrning under texturgenereringen.
tex_slat_guidance_rescalevalfritt
Typnumber
Standard0
0 – 1
Omskalning som tillämpas på styrningen under texturgenereringen; höj värdet om texturerna ser brusiga ut.
tex_slat_guidance_interval_startvalfritt
Typnumber
Standard0.6
0 – 1
Andel av brusreduceringen där styrningen för textursteget börjar.
tex_slat_guidance_interval_endvalfritt
Typnumber
Standard0.9
0 – 1
Slutpunkt för styrningen i textursteget, uttryckt som en andel av brusreduceringen som inte är mindre än tex_slat_guidance_interval_start.
tex_slat_sampling_stepsvalfritt
Typinteger
Standard12
1 – 50
Antal brusreduceringssteg under texturgenereringen.
tex_slat_rescale_tvalfritt
Typnumber
Standard3
1 – 6
Brusschemats skärpa under texturgenereringen.
decimation_targetvalfritt
Typinteger
Standard500000
5 000 – 2 000 000
Önskat antal hörnpunkter i GLB-exporten.
texture_sizevalfritt
Typenum
Standard2048
102420484096
Upplösning för texturer som bakas in i GLB-exporten.
enable_safety_checkervalfritt
Typboolean
Standardtrue
Granskningen kan lättas genom att ange false, om anroparen är behörig.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
model_glb
object {url, content_type, file_name, file_size}GLB-fil som innehåller den genererade 3D-modellen.
seed
integerSeed som används under genereringen.
resolution
integerUpplösning som användes vid genereringen.
sparse_structure_lora_url
string | nullLoRA-kontrollpunkt för gles struktur som användes under genereringen, om någon tillämpades.
geometry_lora_url
string | nullLoRA-kontrollpunkt för geometri som användes under genereringen, om någon tillämpades.
texture_lora_url
string | nullLoRA-kontrollpunkt för textur som användes under genereringen, om någon tillämpades.
decimation_target
integerMålantal hörnpunkter som tillämpades på GLB-exporten.
texture_size
integerUpplösning för texturer som bakas in i GLB-exporten.

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/trellis-2-lora.md. Alla modeller och guider: https://doitong.com/developers/llms.txt