Naar inhoud springen

TRELLIS.2 LoRA Inference

Integreren

Model-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.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"

Deze request: $ 0,25 250 API-tegoed · ≈ ₽ 26,37 Op deze pagina uitvoeren

API-sleutel ophalen
Microsoft Afbeelding naar 3D

Trellis 2 image-to-3D die aangepaste LoRA-adapters kan toepassen op structuur, geometrie en textuur

Microsoft · 3D

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht image_url
Sleep een bestand hierheen of

URL van de bronafbeelding voor conversie naar een 3D-model.

resolution standaard 512

Generatieresolutie, waarbij 1024 de cascadepipeline selecteert. Kies de resolutie waarop de meegeleverde LoRA-adapters zijn getraind; een overeenkomst is vereist.

Geavanceerd 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

Optioneel LoRA-checkpoint in safetensors-indeling, specifiek getraind voor de textuurdenoiser.

texture_size standaard 2048

Resolutie van texturen die in de GLB-export zijn gebakken.

Optioneel LoRA-checkpoint in safetensors-indeling, specifiek getraind voor de denoiser van de ijle structuur.

Optioneel LoRA-checkpoint in safetensors-indeling, specifiek getraind voor de geometriedenoser.

standaard 7.5

Kracht van classifier-free guidance tijdens generatie van de ijle structuur.

standaard 0.7

Herschaling van begeleiding tijdens generatie van de ijle structuur. Hogere waarden maken de uitvoer stabieler.

standaard 0.6

Fractie van de ruisonderdrukkingsvoortgang waarop begeleiding van de ijle structuur begint.

standaard 1

Gebruik een ruisonderdrukkingsfractie die gelijk is aan of hoger is dan `ss_guidance_interval_start` om op te geven wanneer begeleiding van de ijle structuur stopt.

standaard 12

Aantal ruisonderdrukkingsstappen tijdens generatie van de ijle structuur.

standaard 5

Scherpte van het ruisschema tijdens generatie van de ijle structuur.

standaard 7.5

Kracht van classifier-free guidance tijdens vormgeneratie.

standaard 0.5

Herschaling die tijdens vormgeneratie op begeleiding wordt toegepast; verhoog deze wanneer de geometrie ruisachtig lijkt.

standaard 0.6

Fractie van de ruisonderdrukking waarop begeleiding van de vormfase begint.

standaard 1

Stopgrens voor begeleiding van de vormfase, uitgedrukt als een ruisonderdrukkingsfractie die niet kleiner is dan shape_slat_guidance_interval_start.

standaard 12

Aantal ruisonderdrukkingsstappen tijdens vormgeneratie.

standaard 3

Scherpte van het ruisschema tijdens vormgeneratie.

standaard 1

Kracht van classifier-free guidance tijdens textuurgeneratie.

standaard 0

Herschaling die tijdens textuurgeneratie op begeleiding wordt toegepast; verhoog deze wanneer texturen ruisachtig lijken.

standaard 0.6

Fractie van de ruisonderdrukking waarop begeleiding van de textuurfase begint.

standaard 0.9

Stopgrens voor begeleiding van de textuurfase, uitgedrukt als een ruisonderdrukkingsfractie die niet kleiner is dan tex_slat_guidance_interval_start.

standaard 12

Aantal ruisonderdrukkingsstappen tijdens textuurgeneratie.

standaard 3

Scherpte van het ruisschema tijdens textuurgeneratie.

standaard 500000

Gewenst aantal vertices in de GLB-export.

Willekeurige seed die reproduceerbare generatie mogelijk maakt.

POST /run/trellis-2-lora?wait=20 prijsopgave → $ 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"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over TRELLIS.2 LoRA Inference

Genereert een GLB uit `image_url` en kan optioneel safetensors LoRA's toepassen via `sparse_structure_lora_url`, `geometry_lora_url` en `texture_lora_url`. `resolution` is 512 of 1024 en moet overeenkomen met de trainingsresolutie van de adapters. Ook beschikbaar zijn guidance- en step-instellingen per fase, `decimation_target` en `texture_size`.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlverplicht image
Typeurl · image
URL van de bronafbeelding voor conversie naar een 3D-model.
sparse_structure_lora_urloptioneel
Typestring | null
Optioneel LoRA-checkpoint in safetensors-indeling, specifiek getraind voor de denoiser van de ijle structuur.
geometry_lora_urloptioneel
Typestring | null
Optioneel LoRA-checkpoint in safetensors-indeling, specifiek getraind voor de geometriedenoser.
texture_lora_urloptioneel
Typestring | null
Optioneel LoRA-checkpoint in safetensors-indeling, specifiek getraind voor de textuurdenoiser.
seedoptioneel
Typeinteger | null
Willekeurige seed die reproduceerbare generatie mogelijk maakt.
resolutionoptioneel
Typeenum
Standaard512
5121024
Generatieresolutie, waarbij 1024 de cascadepipeline selecteert. Kies de resolutie waarop de meegeleverde LoRA-adapters zijn getraind; een overeenkomst is vereist.
ss_guidance_strengthoptioneel
Typenumber
Standaard7.5
0 – 10
Kracht van classifier-free guidance tijdens generatie van de ijle structuur.
ss_guidance_rescaleoptioneel
Typenumber
Standaard0.7
0 – 1
Herschaling van begeleiding tijdens generatie van de ijle structuur. Hogere waarden maken de uitvoer stabieler.
ss_guidance_interval_startoptioneel
Typenumber
Standaard0.6
0 – 1
Fractie van de ruisonderdrukkingsvoortgang waarop begeleiding van de ijle structuur begint.
ss_guidance_interval_endoptioneel
Typenumber
Standaard1
0 – 1
Gebruik een ruisonderdrukkingsfractie die gelijk is aan of hoger is dan `ss_guidance_interval_start` om op te geven wanneer begeleiding van de ijle structuur stopt.
ss_sampling_stepsoptioneel
Typeinteger
Standaard12
1 – 50
Aantal ruisonderdrukkingsstappen tijdens generatie van de ijle structuur.
ss_rescale_toptioneel
Typenumber
Standaard5
1 – 6
Scherpte van het ruisschema tijdens generatie van de ijle structuur.
shape_slat_guidance_strengthoptioneel
Typenumber
Standaard7.5
0 – 10
Kracht van classifier-free guidance tijdens vormgeneratie.
shape_slat_guidance_rescaleoptioneel
Typenumber
Standaard0.5
0 – 1
Herschaling die tijdens vormgeneratie op begeleiding wordt toegepast; verhoog deze wanneer de geometrie ruisachtig lijkt.
shape_slat_guidance_interval_startoptioneel
Typenumber
Standaard0.6
0 – 1
Fractie van de ruisonderdrukking waarop begeleiding van de vormfase begint.
shape_slat_guidance_interval_endoptioneel
Typenumber
Standaard1
0 – 1
Stopgrens voor begeleiding van de vormfase, uitgedrukt als een ruisonderdrukkingsfractie die niet kleiner is dan shape_slat_guidance_interval_start.
shape_slat_sampling_stepsoptioneel
Typeinteger
Standaard12
1 – 50
Aantal ruisonderdrukkingsstappen tijdens vormgeneratie.
shape_slat_rescale_toptioneel
Typenumber
Standaard3
1 – 6
Scherpte van het ruisschema tijdens vormgeneratie.
tex_slat_guidance_strengthoptioneel
Typenumber
Standaard1
0 – 10
Kracht van classifier-free guidance tijdens textuurgeneratie.
tex_slat_guidance_rescaleoptioneel
Typenumber
Standaard0
0 – 1
Herschaling die tijdens textuurgeneratie op begeleiding wordt toegepast; verhoog deze wanneer texturen ruisachtig lijken.
tex_slat_guidance_interval_startoptioneel
Typenumber
Standaard0.6
0 – 1
Fractie van de ruisonderdrukking waarop begeleiding van de textuurfase begint.
tex_slat_guidance_interval_endoptioneel
Typenumber
Standaard0.9
0 – 1
Stopgrens voor begeleiding van de textuurfase, uitgedrukt als een ruisonderdrukkingsfractie die niet kleiner is dan tex_slat_guidance_interval_start.
tex_slat_sampling_stepsoptioneel
Typeinteger
Standaard12
1 – 50
Aantal ruisonderdrukkingsstappen tijdens textuurgeneratie.
tex_slat_rescale_toptioneel
Typenumber
Standaard3
1 – 6
Scherpte van het ruisschema tijdens textuurgeneratie.
decimation_targetoptioneel
Typeinteger
Standaard500000
5.000 – 2.000.000
Gewenst aantal vertices in de GLB-export.
texture_sizeoptioneel
Typeenum
Standaard2048
102420484096
Resolutie van texturen die in de GLB-export zijn gebakken.
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Screening kan worden versoepeld door false in te stellen, mits de aanroeper is geautoriseerd.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
model_glb
object {url, content_type, file_name, file_size}GLB-bestand met het gegenereerde 3D-model.
seed
integerSeed die tijdens de generatie is toegepast.
resolution
integerResolutie waarop de generatie is uitgevoerd.
sparse_structure_lora_url
string | nullLoRA-checkpoint voor de ijle structuur dat tijdens generatie is gebruikt, indien toegepast.
geometry_lora_url
string | nullLoRA-checkpoint voor geometrie dat tijdens generatie is gebruikt, indien toegepast.
texture_lora_url
string | nullLoRA-checkpoint voor textuur dat tijdens generatie is gebruikt, indien toegepast.
decimation_target
integerDoel voor het aantal vertices dat op de GLB-export is toegepast.
texture_size
integerResolutie van texturen die in de GLB-export zijn gebakken.

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/trellis-2-lora.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt