Ugrás a tartalomhoz

TRELLIS.2 LoRA Inference

Integráció

Modellazonosító 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"

Ez a kérés: 0,25 $ 250 API-jóváírás · ≈ 26,37 ₽ Futtatás ezen az oldalon

API-kulcs beszerzése
Microsoft Képből 3D

Trellis 2 kép–3D modell, amely egyedi LoRA-adaptereket alkalmazhat a struktúrához, geometriához és textúrához

Microsoft · 3D

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

•kötelező image_url
Húzz egy fájlt ide, vagy

A 3D-modellé alakítandó forráskép URL-je.

resolution alapértelmezett: 512

Generálási felbontás: a 1024 a kaszkád-pipeline-t választja. A megadott LoRA-adapterek betanításához használt felbontást kell választani; az egyezés kötelező.

Speciális 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

Opcionális LoRA-ellenőrzőpont safetensors formátumban, kifejezetten a textúra-zajcsökkentőhöz betanítva.

texture_size alapértelmezett: 2048

A GLB-exportba beágyazott textúrák felbontása.

Opcionális LoRA-ellenőrzőpont safetensors formátumban, kifejezetten a ritka struktúra zajcsökkentőjéhez betanítva.

Opcionális LoRA-ellenőrzőpont safetensors formátumban, kifejezetten a geometriai zajcsökkentőhöz betanítva.

alapértelmezett: 7.5

A classifier-free guidance erőssége ritka struktúra generálása közben.

alapértelmezett: 0.7

Útmutatás-újraméretezés ritka struktúra generálása közben. A nagyobb értékek stabilabb kimenetet eredményeznek.

alapértelmezett: 0.6

A zajcsökkentési folyamat azon hányada, ahol a ritka struktúra útmutatása elkezdődik.

alapértelmezett: 1

A ritka struktúra útmutatásának leállítási idejének megadásához használjon a `ss_guidance_interval_start` értékével legalább megegyező zajcsökkentési hányadot.

alapértelmezett: 12

A ritka struktúra generálása közben használt zajcsökkentési lépések száma.

alapértelmezett: 5

A zajütemezés élessége ritka struktúra generálása közben.

alapértelmezett: 7.5

A classifier-free guidance erőssége alakgenerálás közben.

alapértelmezett: 0.5

Az alakgenerálás közben alkalmazott útmutatás-újraméretezés; növelje, ha a geometria zajosnak tűnik.

alapértelmezett: 0.6

A zajcsökkentés azon hányada, ahol az alakfázis útmutatása elkezdődik.

alapértelmezett: 1

Az alakfázis útmutatásának leállítási pontja, a shape_slat_guidance_interval_start értékénél nem kisebb zajcsökkentési hányadosként megadva.

alapértelmezett: 12

Az alakgenerálás közbeni zajcsökkentési lépések száma.

alapértelmezett: 3

A zajütemezés élessége alakgenerálás közben.

alapértelmezett: 1

A classifier-free guidance erőssége textúragenerálás közben.

alapértelmezett: 0

A textúragenerálás közben alkalmazott útmutatás-újraméretezés; növelje, ha a textúrák zajosnak tűnnek.

alapértelmezett: 0.6

A zajcsökkentés azon hányada, ahol a textúrafázis útmutatása elkezdődik.

alapértelmezett: 0.9

A textúrafázis útmutatásának leállítási pontja, a tex_slat_guidance_interval_start értékénél nem kisebb zajcsökkentési hányadosként megadva.

alapértelmezett: 12

A textúragenerálás közbeni zajcsökkentési lépések száma.

alapértelmezett: 3

A zajütemezés élessége textúragenerálás közben.

alapértelmezett: 500000

A GLB-export kívánt csúcsszáma.

Véletlenszerű seed, amely reprodukálhatóvá teszi a generálást.

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

Kérés futtatása

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. API-kulcs igénylése

A(z) TRELLIS.2 LoRA Inference bemutatása

GLB-t generál az `image_url` alapján, és opcionálisan safetensors LoRA-kat alkalmaz a `sparse_structure_lora_url`, `geometry_lora_url` és `texture_lora_url` segítségével. A `resolution` 512 vagy 1024, és egyeznie kell az adapterek tanítási felbontásával. Szakaszonkénti útmutatási és lépésvezérlőket, valamint `decimation_target` és `texture_size` paramétert is kínál.

Paraméterek

Küldd el a kanonikus nevet vagy a natív nevet, de ne mindkettőt. Kanonikus nevek

NévTípus AlapértelmezettEngedélyezett Leírás
image_urlkötelező image
Típusurl · image
A 3D-modellé alakítandó forráskép URL-je.
sparse_structure_lora_urlnem kötelező
Típusstring | null
Opcionális LoRA-ellenőrzőpont safetensors formátumban, kifejezetten a ritka struktúra zajcsökkentőjéhez betanítva.
geometry_lora_urlnem kötelező
Típusstring | null
Opcionális LoRA-ellenőrzőpont safetensors formátumban, kifejezetten a geometriai zajcsökkentőhöz betanítva.
texture_lora_urlnem kötelező
Típusstring | null
Opcionális LoRA-ellenőrzőpont safetensors formátumban, kifejezetten a textúra-zajcsökkentőhöz betanítva.
seednem kötelező
Típusinteger | null
Véletlenszerű seed, amely reprodukálhatóvá teszi a generálást.
resolutionnem kötelező
Típusenum
Alapértelmezett512
5121024
Generálási felbontás: a 1024 a kaszkád-pipeline-t választja. A megadott LoRA-adapterek betanításához használt felbontást kell választani; az egyezés kötelező.
ss_guidance_strengthnem kötelező
Típusnumber
Alapértelmezett7.5
0 – 10
A classifier-free guidance erőssége ritka struktúra generálása közben.
ss_guidance_rescalenem kötelező
Típusnumber
Alapértelmezett0.7
0 – 1
Útmutatás-újraméretezés ritka struktúra generálása közben. A nagyobb értékek stabilabb kimenetet eredményeznek.
ss_guidance_interval_startnem kötelező
Típusnumber
Alapértelmezett0.6
0 – 1
A zajcsökkentési folyamat azon hányada, ahol a ritka struktúra útmutatása elkezdődik.
ss_guidance_interval_endnem kötelező
Típusnumber
Alapértelmezett1
0 – 1
A ritka struktúra útmutatásának leállítási idejének megadásához használjon a `ss_guidance_interval_start` értékével legalább megegyező zajcsökkentési hányadot.
ss_sampling_stepsnem kötelező
Típusinteger
Alapértelmezett12
1 – 50
A ritka struktúra generálása közben használt zajcsökkentési lépések száma.
ss_rescale_tnem kötelező
Típusnumber
Alapértelmezett5
1 – 6
A zajütemezés élessége ritka struktúra generálása közben.
shape_slat_guidance_strengthnem kötelező
Típusnumber
Alapértelmezett7.5
0 – 10
A classifier-free guidance erőssége alakgenerálás közben.
shape_slat_guidance_rescalenem kötelező
Típusnumber
Alapértelmezett0.5
0 – 1
Az alakgenerálás közben alkalmazott útmutatás-újraméretezés; növelje, ha a geometria zajosnak tűnik.
shape_slat_guidance_interval_startnem kötelező
Típusnumber
Alapértelmezett0.6
0 – 1
A zajcsökkentés azon hányada, ahol az alakfázis útmutatása elkezdődik.
shape_slat_guidance_interval_endnem kötelező
Típusnumber
Alapértelmezett1
0 – 1
Az alakfázis útmutatásának leállítási pontja, a shape_slat_guidance_interval_start értékénél nem kisebb zajcsökkentési hányadosként megadva.
shape_slat_sampling_stepsnem kötelező
Típusinteger
Alapértelmezett12
1 – 50
Az alakgenerálás közbeni zajcsökkentési lépések száma.
shape_slat_rescale_tnem kötelező
Típusnumber
Alapértelmezett3
1 – 6
A zajütemezés élessége alakgenerálás közben.
tex_slat_guidance_strengthnem kötelező
Típusnumber
Alapértelmezett1
0 – 10
A classifier-free guidance erőssége textúragenerálás közben.
tex_slat_guidance_rescalenem kötelező
Típusnumber
Alapértelmezett0
0 – 1
A textúragenerálás közben alkalmazott útmutatás-újraméretezés; növelje, ha a textúrák zajosnak tűnnek.
tex_slat_guidance_interval_startnem kötelező
Típusnumber
Alapértelmezett0.6
0 – 1
A zajcsökkentés azon hányada, ahol a textúrafázis útmutatása elkezdődik.
tex_slat_guidance_interval_endnem kötelező
Típusnumber
Alapértelmezett0.9
0 – 1
A textúrafázis útmutatásának leállítási pontja, a tex_slat_guidance_interval_start értékénél nem kisebb zajcsökkentési hányadosként megadva.
tex_slat_sampling_stepsnem kötelező
Típusinteger
Alapértelmezett12
1 – 50
A textúragenerálás közbeni zajcsökkentési lépések száma.
tex_slat_rescale_tnem kötelező
Típusnumber
Alapértelmezett3
1 – 6
A zajütemezés élessége textúragenerálás közben.
decimation_targetnem kötelező
Típusinteger
Alapértelmezett500000
5000 – 2 000 000
A GLB-export kívánt csúcsszáma.
texture_sizenem kötelező
Típusenum
Alapértelmezett2048
102420484096
A GLB-exportba beágyazott textúrák felbontása.
enable_safety_checkernem kötelező
Típusboolean
Alapértelmezetttrue
A szűrés a false érték beállításával enyhíthető, ha a hívó jogosult erre.
kötelező Kanonikus név, szintén elfogadva

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

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"
  }
}
Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.
Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.
A kimenet mezői
model_glb
object {url, content_type, file_name, file_size}A generált 3D-modellt tartalmazó GLB-fájl.
seed
integerA generálás során alkalmazott seed.
resolution
integerA felbontás, amelyen a generálás történt.
sparse_structure_lora_url
string | nullA generálás során használt ritka struktúrájú LoRA-ellenőrzőpont, ha alkalmaztak ilyet.
geometry_lora_url
string | nullA generálás során használt geometriai LoRA-ellenőrzőpont, ha alkalmaztak ilyet.
texture_lora_url
string | nullA generálás során használt textúra-LoRA-ellenőrzőpont, ha alkalmaztak ilyet.
decimation_target
integerA GLB-exporthoz alkalmazott csúcsszám-célérték.
texture_size
integerA GLB-exportba beágyazott textúrák felbontása.

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/trellis-2-lora.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt