Przejdź do treści

TRELLIS.2 LoRA Inference

Integracja

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

To żądanie: 0,25 $ 250 kredytów API Uruchom na tej stronie

Uzyskaj klucz API
Microsoft Obraz na 3D

Konwersja obrazu na 3D przez Trellis 2 z możliwością zastosowania niestandardowych adapterów LoRA do struktury, geometrii i tekstury

Microsoft · 3D

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane image_url
Upuść plik lub

URL źródłowego obrazu do konwersji na model 3D.

resolution domyślnie 512

Rozdzielczość generowania, przy czym 1024 wybiera potok kaskadowy. Wybierz rozdzielczość używaną do trenowania dostarczonych adapterów LoRA; wymagane jest dopasowanie.

Zaawansowane 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

Opcjonalny checkpoint LoRA w formacie safetensors, wytrenowany specjalnie dla odszumiacza tekstury.

texture_size domyślnie 2048

Rozdzielczość tekstur wypalonych w eksporcie GLB.

Opcjonalny checkpoint LoRA w formacie safetensors, wytrenowany specjalnie dla odszumiacza rzadkiej struktury.

Opcjonalny checkpoint LoRA w formacie safetensors, wytrenowany specjalnie dla odszumiacza geometrii.

domyślnie 7.5

Siła bezklasowych wskazówek podczas generowania rzadkiej struktury.

domyślnie 0.7

Przeskalowanie wskazówek podczas generowania rzadkiej struktury. Większe wartości zwiększają stabilność wyniku.

domyślnie 0.6

Ułamek postępu odszumiania, przy którym rozpoczynają się wskazówki rzadkiej struktury.

domyślnie 1

Użyj ułamka odszumiania równego lub większego niż `ss_guidance_interval_start`, aby określić moment zakończenia wskazówek rzadkiej struktury.

domyślnie 12

Liczba kroków odszumiania używanych podczas generowania rzadkiej struktury.

domyślnie 5

Ostrość harmonogramu szumu podczas generowania rzadkiej struktury.

domyślnie 7.5

Siła bezklasowych wskazówek podczas generowania kształtu.

domyślnie 0.5

Przeskalowanie stosowane do wskazówek podczas generowania kształtu; zwiększ je, gdy geometria wydaje się zaszumiona.

domyślnie 0.6

Ułamek odszumiania, przy którym rozpoczynają się wskazówki etapu kształtu.

domyślnie 1

Punkt zakończenia wskazówek etapu kształtu, wyrażony jako ułamek odszumiania nie mniejszy niż shape_slat_guidance_interval_start.

domyślnie 12

Liczba kroków odszumiania podczas generowania kształtu.

domyślnie 3

Ostrość harmonogramu szumu podczas generowania kształtu.

domyślnie 1

Siła bezklasowych wskazówek podczas generowania tekstury.

domyślnie 0

Przeskalowanie stosowane do wskazówek podczas generowania tekstury; zwiększ je, gdy tekstury wydają się zaszumione.

domyślnie 0.6

Ułamek odszumiania, przy którym rozpoczynają się wskazówki etapu tekstury.

domyślnie 0.9

Punkt zakończenia wskazówek etapu tekstury, wyrażony jako ułamek odszumiania nie mniejszy niż tex_slat_guidance_interval_start.

domyślnie 12

Liczba kroków odszumiania podczas generowania tekstury.

domyślnie 3

Ostrość harmonogramu szumu podczas generowania tekstury.

domyślnie 500000

Żądana liczba wierzchołków w eksporcie GLB.

Losowe ziarno zapewniające powtarzalność generowania.

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

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o TRELLIS.2 LoRA Inference

Generuje GLB z `image_url`, opcjonalnie stosując LoRA safetensors za pośrednictwem `sparse_structure_lora_url`, `geometry_lora_url` i `texture_lora_url`. `resolution` to 512 lub 1024 i musi odpowiadać rozdzielczości trenowania adapterów. Dostępne są również ustawienia sterowania i kroków dla poszczególnych etapów, `decimation_target` oraz `texture_size`.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
image_urlwymagane image
Typurl · image
URL źródłowego obrazu do konwersji na model 3D.
sparse_structure_lora_urlopcjonalne
Typstring | null
Opcjonalny checkpoint LoRA w formacie safetensors, wytrenowany specjalnie dla odszumiacza rzadkiej struktury.
geometry_lora_urlopcjonalne
Typstring | null
Opcjonalny checkpoint LoRA w formacie safetensors, wytrenowany specjalnie dla odszumiacza geometrii.
texture_lora_urlopcjonalne
Typstring | null
Opcjonalny checkpoint LoRA w formacie safetensors, wytrenowany specjalnie dla odszumiacza tekstury.
seedopcjonalne
Typinteger | null
Losowe ziarno zapewniające powtarzalność generowania.
resolutionopcjonalne
Typenum
Domyślne512
5121024
Rozdzielczość generowania, przy czym 1024 wybiera potok kaskadowy. Wybierz rozdzielczość używaną do trenowania dostarczonych adapterów LoRA; wymagane jest dopasowanie.
ss_guidance_strengthopcjonalne
Typnumber
Domyślne7.5
0 – 10
Siła bezklasowych wskazówek podczas generowania rzadkiej struktury.
ss_guidance_rescaleopcjonalne
Typnumber
Domyślne0.7
0 – 1
Przeskalowanie wskazówek podczas generowania rzadkiej struktury. Większe wartości zwiększają stabilność wyniku.
ss_guidance_interval_startopcjonalne
Typnumber
Domyślne0.6
0 – 1
Ułamek postępu odszumiania, przy którym rozpoczynają się wskazówki rzadkiej struktury.
ss_guidance_interval_endopcjonalne
Typnumber
Domyślne1
0 – 1
Użyj ułamka odszumiania równego lub większego niż `ss_guidance_interval_start`, aby określić moment zakończenia wskazówek rzadkiej struktury.
ss_sampling_stepsopcjonalne
Typinteger
Domyślne12
1 – 50
Liczba kroków odszumiania używanych podczas generowania rzadkiej struktury.
ss_rescale_topcjonalne
Typnumber
Domyślne5
1 – 6
Ostrość harmonogramu szumu podczas generowania rzadkiej struktury.
shape_slat_guidance_strengthopcjonalne
Typnumber
Domyślne7.5
0 – 10
Siła bezklasowych wskazówek podczas generowania kształtu.
shape_slat_guidance_rescaleopcjonalne
Typnumber
Domyślne0.5
0 – 1
Przeskalowanie stosowane do wskazówek podczas generowania kształtu; zwiększ je, gdy geometria wydaje się zaszumiona.
shape_slat_guidance_interval_startopcjonalne
Typnumber
Domyślne0.6
0 – 1
Ułamek odszumiania, przy którym rozpoczynają się wskazówki etapu kształtu.
shape_slat_guidance_interval_endopcjonalne
Typnumber
Domyślne1
0 – 1
Punkt zakończenia wskazówek etapu kształtu, wyrażony jako ułamek odszumiania nie mniejszy niż shape_slat_guidance_interval_start.
shape_slat_sampling_stepsopcjonalne
Typinteger
Domyślne12
1 – 50
Liczba kroków odszumiania podczas generowania kształtu.
shape_slat_rescale_topcjonalne
Typnumber
Domyślne3
1 – 6
Ostrość harmonogramu szumu podczas generowania kształtu.
tex_slat_guidance_strengthopcjonalne
Typnumber
Domyślne1
0 – 10
Siła bezklasowych wskazówek podczas generowania tekstury.
tex_slat_guidance_rescaleopcjonalne
Typnumber
Domyślne0
0 – 1
Przeskalowanie stosowane do wskazówek podczas generowania tekstury; zwiększ je, gdy tekstury wydają się zaszumione.
tex_slat_guidance_interval_startopcjonalne
Typnumber
Domyślne0.6
0 – 1
Ułamek odszumiania, przy którym rozpoczynają się wskazówki etapu tekstury.
tex_slat_guidance_interval_endopcjonalne
Typnumber
Domyślne0.9
0 – 1
Punkt zakończenia wskazówek etapu tekstury, wyrażony jako ułamek odszumiania nie mniejszy niż tex_slat_guidance_interval_start.
tex_slat_sampling_stepsopcjonalne
Typinteger
Domyślne12
1 – 50
Liczba kroków odszumiania podczas generowania tekstury.
tex_slat_rescale_topcjonalne
Typnumber
Domyślne3
1 – 6
Ostrość harmonogramu szumu podczas generowania tekstury.
decimation_targetopcjonalne
Typinteger
Domyślne500000
5000 – 2 000 000
Żądana liczba wierzchołków w eksporcie GLB.
texture_sizeopcjonalne
Typenum
Domyślne2048
102420484096
Rozdzielczość tekstur wypalonych w eksporcie GLB.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Filtrowanie można złagodzić, ustawiając false, jeśli wywołujący ma odpowiednie uprawnienia.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
model_glb
object {url, content_type, file_name, file_size}Plik GLB zawierający wygenerowany model 3D.
seed
integerZiarno zastosowane podczas generowania.
resolution
integerRozdzielczość, w której wykonano generowanie.
sparse_structure_lora_url
string | nullCheckpoint LoRA rzadkiej struktury użyty podczas generowania, jeśli został zastosowany.
geometry_lora_url
string | nullCheckpoint LoRA geometrii użyty podczas generowania, jeśli został zastosowany.
texture_lora_url
string | nullCheckpoint LoRA tekstury użyty podczas generowania, jeśli został zastosowany.
decimation_target
integerCel liczby wierzchołków zastosowany do eksportu GLB.
texture_size
integerRozdzielczość tekstur wypalonych w eksporcie GLB.

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/trellis-2-lora.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt