Gå til indhold

TRELLIS.2 LoRA Inference

Integrer

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

Denne anmodning: 0,25 $ 250 API-kreditter Kør den på denne side

Hent API-nøgle
Microsoft Billede til 3D

Trellis 2 fra billede til 3D, der kan anvende tilpassede LoRA-adaptere til struktur, geometri og tekstur

Microsoft · 3D

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

•påkrævet image_url
Slip en fil, eller

URL til kildebilledet til konvertering til en 3D-model.

resolution standard 512

Genereringsopløsning, hvor 1024 vælger cascade-pipelinen. Vælg den opløsning, som de medfølgende LoRA-adaptere blev trænet med; de skal matche.

Avanceret 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

Valgfrit LoRA-checkpoint i safetensors-format, trænet specifikt til teksturens denoiser.

texture_size standard 2048

Opløsning for teksturer, der bages ind i GLB-eksporten.

Valgfrit LoRA-checkpoint i safetensors-format, trænet specifikt til den sparsomme strukturs denoiser.

Valgfrit LoRA-checkpoint i safetensors-format, trænet specifikt til geometridens denoiser.

standard 7.5

Styrke for classifier-free guidance under generering af sparsom struktur.

standard 0.7

Reskalering af vejledningen under generering af sparsom struktur. Større værdier gør outputtet mere stabilt.

standard 0.6

Brøkdel af denoising-fremskridtet, hvor vejledning af den sparsomme struktur begynder.

standard 1

Brug en denoising-brøk på eller over `ss_guidance_interval_start` for at angive, hvornår vejledningen af den sparsomme struktur stopper.

standard 12

Antal denoising-trin under generering af sparsom struktur.

standard 5

Styrken af støjplanen under generering af sparsom struktur.

standard 7.5

Styrke for classifier-free guidance under formgenerering.

standard 0.5

Reskalering anvendt på vejledningen under formgenerering; øg den, når geometrien virker støjende.

standard 0.6

Brøkdel af denoising-fremskridtet, hvor vejledningen i formtrinnet begynder.

standard 1

Slutpunkt for vejledning i formtrinnet, angivet som en denoising-brøk, der ikke er mindre end shape_slat_guidance_interval_start.

standard 12

Antal denoising-trin under formgenerering.

standard 3

Styrken af støjplanen under formgenerering.

standard 1

Styrke for classifier-free guidance under teksturgenerering.

standard 0

Reskalering anvendt på vejledningen under teksturgenerering; øg den, når teksturerne virker støjende.

standard 0.6

Brøkdel af denoising-fremskridtet, hvor vejledningen i teksturtrinnet begynder.

standard 0.9

Slutpunkt for vejledning i teksturtrinnet, angivet som en denoising-brøk, der ikke er mindre end tex_slat_guidance_interval_start.

standard 12

Antal denoising-trin under teksturgenerering.

standard 3

Styrken af støjplanen under teksturgenerering.

standard 500000

Ønsket antal vertices i GLB-eksporten.

Tilfældig seed, der 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 denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om TRELLIS.2 LoRA Inference

Genererer en GLB fra `image_url` og kan valgfrit anvende safetensors-LoRA'er via `sparse_structure_lora_url`, `geometry_lora_url` og `texture_lora_url`. `resolution` er 512 eller 1024 og skal svare til adapterens træningsopløsning. Udsætter også guidance- og trinindstillinger pr. fase, `decimation_target` og `texture_size`.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
image_urlpåkrævet image
Typeurl · image
URL til kildebilledet til konvertering til en 3D-model.
sparse_structure_lora_urlvalgfri
Typestring | null
Valgfrit LoRA-checkpoint i safetensors-format, trænet specifikt til den sparsomme strukturs denoiser.
geometry_lora_urlvalgfri
Typestring | null
Valgfrit LoRA-checkpoint i safetensors-format, trænet specifikt til geometridens denoiser.
texture_lora_urlvalgfri
Typestring | null
Valgfrit LoRA-checkpoint i safetensors-format, trænet specifikt til teksturens denoiser.
seedvalgfri
Typeinteger | null
Tilfældig seed, der gør genereringen reproducerbar.
resolutionvalgfri
Typeenum
Standard512
5121024
Genereringsopløsning, hvor 1024 vælger cascade-pipelinen. Vælg den opløsning, som de medfølgende LoRA-adaptere blev trænet med; de skal matche.
ss_guidance_strengthvalgfri
Typenumber
Standard7.5
0 – 10
Styrke for classifier-free guidance under generering af sparsom struktur.
ss_guidance_rescalevalgfri
Typenumber
Standard0.7
0 – 1
Reskalering af vejledningen under generering af sparsom struktur. Større værdier gør outputtet mere stabilt.
ss_guidance_interval_startvalgfri
Typenumber
Standard0.6
0 – 1
Brøkdel af denoising-fremskridtet, hvor vejledning af den sparsomme struktur begynder.
ss_guidance_interval_endvalgfri
Typenumber
Standard1
0 – 1
Brug en denoising-brøk på eller over `ss_guidance_interval_start` for at angive, hvornår vejledningen af den sparsomme struktur stopper.
ss_sampling_stepsvalgfri
Typeinteger
Standard12
1 – 50
Antal denoising-trin under generering af sparsom struktur.
ss_rescale_tvalgfri
Typenumber
Standard5
1 – 6
Styrken af støjplanen under generering af sparsom struktur.
shape_slat_guidance_strengthvalgfri
Typenumber
Standard7.5
0 – 10
Styrke for classifier-free guidance under formgenerering.
shape_slat_guidance_rescalevalgfri
Typenumber
Standard0.5
0 – 1
Reskalering anvendt på vejledningen under formgenerering; øg den, når geometrien virker støjende.
shape_slat_guidance_interval_startvalgfri
Typenumber
Standard0.6
0 – 1
Brøkdel af denoising-fremskridtet, hvor vejledningen i formtrinnet begynder.
shape_slat_guidance_interval_endvalgfri
Typenumber
Standard1
0 – 1
Slutpunkt for vejledning i formtrinnet, angivet som en denoising-brøk, der ikke er mindre end shape_slat_guidance_interval_start.
shape_slat_sampling_stepsvalgfri
Typeinteger
Standard12
1 – 50
Antal denoising-trin under formgenerering.
shape_slat_rescale_tvalgfri
Typenumber
Standard3
1 – 6
Styrken af støjplanen under formgenerering.
tex_slat_guidance_strengthvalgfri
Typenumber
Standard1
0 – 10
Styrke for classifier-free guidance under teksturgenerering.
tex_slat_guidance_rescalevalgfri
Typenumber
Standard0
0 – 1
Reskalering anvendt på vejledningen under teksturgenerering; øg den, når teksturerne virker støjende.
tex_slat_guidance_interval_startvalgfri
Typenumber
Standard0.6
0 – 1
Brøkdel af denoising-fremskridtet, hvor vejledningen i teksturtrinnet begynder.
tex_slat_guidance_interval_endvalgfri
Typenumber
Standard0.9
0 – 1
Slutpunkt for vejledning i teksturtrinnet, angivet som en denoising-brøk, der ikke er mindre end tex_slat_guidance_interval_start.
tex_slat_sampling_stepsvalgfri
Typeinteger
Standard12
1 – 50
Antal denoising-trin under teksturgenerering.
tex_slat_rescale_tvalgfri
Typenumber
Standard3
1 – 6
Styrken af støjplanen under teksturgenerering.
decimation_targetvalgfri
Typeinteger
Standard500000
5.000 – 2.000.000
Ønsket antal vertices i GLB-eksporten.
texture_sizevalgfri
Typeenum
Standard2048
102420484096
Opløsning for teksturer, der bages ind i GLB-eksporten.
enable_safety_checkervalgfri
Typeboolean
Standardtrue
Screening kan lempes ved at angive false, hvis den kaldende part er autoriseret.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
model_glb
object {url, content_type, file_name, file_size}GLB-fil, der indeholder den genererede 3D-model.
seed
integerSeed anvendt under genereringen.
resolution
integerOpløsning, som genereringen blev udført ved.
sparse_structure_lora_url
string | nullLoRA-checkpoint for sparsom struktur, der blev brugt under genereringen, hvis et blev anvendt.
geometry_lora_url
string | nullLoRA-checkpoint for geometri, der blev brugt under genereringen, hvis et blev anvendt.
texture_lora_url
string | nullLoRA-checkpoint for tekstur, der blev brugt under genereringen, hvis et blev anvendt.
decimation_target
integerVertexantmål anvendt på GLB-eksporten.
texture_size
integerOpløsning for teksturer, der bages ind i GLB-eksporten.

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/trellis-2-lora.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt