Přejít na obsah

TRELLIS.2 LoRA Inference

Integrace

ID modelu 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"

Tento požadavek: 0,25 $ 250 kreditů API · ≈ 26,37 ₽ Spustit na této stránce

Získat API klíč
Microsoft Obrázek na 3D

Převod obrázku na 3D pomocí Trellis 2 s možností použít vlastní LoRA adaptéry pro strukturu, geometrii a texturu

Microsoft · 3D

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné image_url
Přetáhněte soubor nebo

URL zdrojového obrázku pro převod na 3D model.

resolution výchozí 512

Rozlišení generování, kde 1024 vybírá cascade pipeline. Zvolte rozlišení použité k trénování dodaných adaptérů LoRA; shoda je povinná.

Pokročilé 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

Volitelný checkpoint LoRA ve formátu safetensors, natrénovaný konkrétně pro odšumovač textury.

texture_size výchozí 2048

Rozlišení textur zapečených do exportu GLB.

Volitelný checkpoint LoRA ve formátu safetensors, natrénovaný konkrétně pro odšumovač řídké struktury.

Volitelný checkpoint LoRA ve formátu safetensors, natrénovaný konkrétně pro odšumovač geometrie.

výchozí 7.5

Síla classifier-free guidance během generování řídké struktury.

výchozí 0.7

Přepočítání guidance během generování řídké struktury. Vyšší hodnoty činí výstup stabilnější.

výchozí 0.6

Zlomek postupu odšumění, ve kterém začíná guidance řídké struktury.

výchozí 1

Použijte zlomek odšumění rovný nebo vyšší než `ss_guidance_interval_start` k určení, kdy se guidance řídké struktury zastaví.

výchozí 12

Počet kroků odšumění použitých při generování řídké struktury.

výchozí 5

Ostrost rozvrhu šumu během generování řídké struktury.

výchozí 7.5

Síla classifier-free guidance během generování tvaru.

výchozí 0.5

Přepočítání použité na guidance během generování tvaru; zvyšte je, když geometrie působí zašuměně.

výchozí 0.6

Zlomek odšumění, ve kterém začíná guidance fáze tvaru.

výchozí 1

Bod zastavení guidance fáze tvaru, vyjádřený jako zlomek odšumění nejméně tak velký jako shape_slat_guidance_interval_start.

výchozí 12

Počet kroků odšumění během generování tvaru.

výchozí 3

Ostrost rozvrhu šumu během generování tvaru.

výchozí 1

Síla classifier-free guidance během generování textury.

výchozí 0

Přepočítání použité na guidance během generování textury; zvyšte je, když textury působí zašuměně.

výchozí 0.6

Zlomek odšumění, ve kterém začíná guidance fáze textury.

výchozí 0.9

Bod zastavení guidance fáze textury, vyjádřený jako zlomek odšumění nejméně tak velký jako tex_slat_guidance_interval_start.

výchozí 12

Počet kroků odšumění během generování textury.

výchozí 3

Ostrost rozvrhu šumu během generování textury.

výchozí 500000

Požadovaný počet vrcholů v exportu GLB.

Náhodný seed, díky kterému lze generování zopakovat.

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

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu TRELLIS.2 LoRA Inference

Generuje GLB z `image_url` a volitelně aplikuje LoRA ve formátu safetensors přes `sparse_structure_lora_url`, `geometry_lora_url` a `texture_lora_url`. `resolution` je 512 nebo 1024 a musí odpovídat trénovacímu rozlišení adaptérů. Nabízí také ovládání guidance a kroků pro jednotlivé fáze, `decimation_target` a `texture_size`.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
image_urlpovinné image
Typurl · image
URL zdrojového obrázku pro převod na 3D model.
sparse_structure_lora_urlvolitelné
Typstring | null
Volitelný checkpoint LoRA ve formátu safetensors, natrénovaný konkrétně pro odšumovač řídké struktury.
geometry_lora_urlvolitelné
Typstring | null
Volitelný checkpoint LoRA ve formátu safetensors, natrénovaný konkrétně pro odšumovač geometrie.
texture_lora_urlvolitelné
Typstring | null
Volitelný checkpoint LoRA ve formátu safetensors, natrénovaný konkrétně pro odšumovač textury.
seedvolitelné
Typinteger | null
Náhodný seed, díky kterému lze generování zopakovat.
resolutionvolitelné
Typenum
Výchozí512
5121024
Rozlišení generování, kde 1024 vybírá cascade pipeline. Zvolte rozlišení použité k trénování dodaných adaptérů LoRA; shoda je povinná.
ss_guidance_strengthvolitelné
Typnumber
Výchozí7.5
0 – 10
Síla classifier-free guidance během generování řídké struktury.
ss_guidance_rescalevolitelné
Typnumber
Výchozí0.7
0 – 1
Přepočítání guidance během generování řídké struktury. Vyšší hodnoty činí výstup stabilnější.
ss_guidance_interval_startvolitelné
Typnumber
Výchozí0.6
0 – 1
Zlomek postupu odšumění, ve kterém začíná guidance řídké struktury.
ss_guidance_interval_endvolitelné
Typnumber
Výchozí1
0 – 1
Použijte zlomek odšumění rovný nebo vyšší než `ss_guidance_interval_start` k určení, kdy se guidance řídké struktury zastaví.
ss_sampling_stepsvolitelné
Typinteger
Výchozí12
1 – 50
Počet kroků odšumění použitých při generování řídké struktury.
ss_rescale_tvolitelné
Typnumber
Výchozí5
1 – 6
Ostrost rozvrhu šumu během generování řídké struktury.
shape_slat_guidance_strengthvolitelné
Typnumber
Výchozí7.5
0 – 10
Síla classifier-free guidance během generování tvaru.
shape_slat_guidance_rescalevolitelné
Typnumber
Výchozí0.5
0 – 1
Přepočítání použité na guidance během generování tvaru; zvyšte je, když geometrie působí zašuměně.
shape_slat_guidance_interval_startvolitelné
Typnumber
Výchozí0.6
0 – 1
Zlomek odšumění, ve kterém začíná guidance fáze tvaru.
shape_slat_guidance_interval_endvolitelné
Typnumber
Výchozí1
0 – 1
Bod zastavení guidance fáze tvaru, vyjádřený jako zlomek odšumění nejméně tak velký jako shape_slat_guidance_interval_start.
shape_slat_sampling_stepsvolitelné
Typinteger
Výchozí12
1 – 50
Počet kroků odšumění během generování tvaru.
shape_slat_rescale_tvolitelné
Typnumber
Výchozí3
1 – 6
Ostrost rozvrhu šumu během generování tvaru.
tex_slat_guidance_strengthvolitelné
Typnumber
Výchozí1
0 – 10
Síla classifier-free guidance během generování textury.
tex_slat_guidance_rescalevolitelné
Typnumber
Výchozí0
0 – 1
Přepočítání použité na guidance během generování textury; zvyšte je, když textury působí zašuměně.
tex_slat_guidance_interval_startvolitelné
Typnumber
Výchozí0.6
0 – 1
Zlomek odšumění, ve kterém začíná guidance fáze textury.
tex_slat_guidance_interval_endvolitelné
Typnumber
Výchozí0.9
0 – 1
Bod zastavení guidance fáze textury, vyjádřený jako zlomek odšumění nejméně tak velký jako tex_slat_guidance_interval_start.
tex_slat_sampling_stepsvolitelné
Typinteger
Výchozí12
1 – 50
Počet kroků odšumění během generování textury.
tex_slat_rescale_tvolitelné
Typnumber
Výchozí3
1 – 6
Ostrost rozvrhu šumu během generování textury.
decimation_targetvolitelné
Typinteger
Výchozí500000
5 000 – 2 000 000
Požadovaný počet vrcholů v exportu GLB.
texture_sizevolitelné
Typenum
Výchozí2048
102420484096
Rozlišení textur zapečených do exportu GLB.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Kontrolu lze uvolnit nastavením na false, pokud je volající autorizován.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
model_glb
object {url, content_type, file_name, file_size}Soubor GLB obsahující vygenerovaný 3D model.
seed
integerSeed použitý během generování.
resolution
integerRozlišení, při kterém generování proběhlo.
sparse_structure_lora_url
string | nullCheckpoint LoRA řídké struktury použitý při generování, pokud byl použit.
geometry_lora_url
string | nullCheckpoint LoRA geometrie použitý při generování, pokud byl použit.
texture_lora_url
string | nullCheckpoint LoRA textury použitý při generování, pokud byl použit.
decimation_target
integerCílový počet vrcholů použitý pro export GLB.
texture_size
integerRozlišení textur zapečených do exportu GLB.

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/trellis-2-lora.md. Všechny modely a návody: https://doitong.com/developers/llms.txt