Langkau ke kandungan

TRELLIS.2 LoRA Inference

Integrasikan

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

Permintaan ini: $0.25 250 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Microsoft Imej ke 3D

Teks-ke-3D Trellis 2 yang boleh menggunakan penyesuai LoRA tersuai untuk struktur, geometri dan tekstur

Microsoft · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan image_url
Lepaskan fail, atau

URL imej sumber untuk penukaran kepada model 3D.

resolution lalai 512

Resolusi penjanaan, dengan 1024 memilih saluran paip lata. Pilih resolusi yang digunakan untuk melatih penyesuai LoRA yang diberikan; padanan diperlukan.

Lanjutan 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

Checkpoint LoRA pilihan dalam format safetensors, dilatih khusus untuk penyahhingar tekstur.

texture_size lalai 2048

Resolusi tekstur yang dibakar ke dalam eksport GLB.

Checkpoint LoRA pilihan dalam format safetensors, dilatih khusus untuk penyahhingar struktur jarang.

Checkpoint LoRA pilihan dalam format safetensors, dilatih khusus untuk penyahhingar geometri.

lalai 7.5

Kekuatan panduan tanpa pengelas semasa penjanaan struktur jarang.

lalai 0.7

Penskalaan semula panduan semasa penjanaan struktur jarang. Nilai lebih besar menjadikan output lebih stabil.

lalai 0.6

Pecahan kemajuan penyahhingaran apabila panduan struktur jarang bermula.

lalai 1

Gunakan pecahan penyahhingaran pada atau melebihi `ss_guidance_interval_start` untuk menentukan masa panduan struktur jarang berhenti.

lalai 12

Bilangan langkah penyahhingaran semasa penjanaan struktur jarang.

lalai 5

Ketajaman jadual hingar semasa penjanaan struktur jarang.

lalai 7.5

Kekuatan panduan tanpa pengelas semasa penjanaan bentuk.

lalai 0.5

Penskalaan semula yang digunakan pada panduan semasa penjanaan bentuk; tingkatkan apabila geometri kelihatan berhingar.

lalai 0.6

Pecahan penyahhingaran apabila panduan peringkat bentuk bermula.

lalai 1

Titik berhenti panduan peringkat bentuk, dinyatakan sebagai pecahan penyahhingaran yang tidak kurang daripada shape_slat_guidance_interval_start.

lalai 12

Bilangan langkah penyahhingaran semasa penjanaan bentuk.

lalai 3

Ketajaman jadual hingar semasa penjanaan bentuk.

lalai 1

Kekuatan panduan tanpa pengelas semasa penjanaan tekstur.

lalai 0

Penskalaan semula yang digunakan pada panduan semasa penjanaan tekstur; tingkatkan apabila tekstur kelihatan berhingar.

lalai 0.6

Pecahan penyahhingaran apabila panduan peringkat tekstur bermula.

lalai 0.9

Titik berhenti panduan peringkat tekstur, dinyatakan sebagai pecahan penyahhingaran yang tidak kurang daripada tex_slat_guidance_interval_start.

lalai 12

Bilangan langkah penyahhingaran semasa penjanaan tekstur.

lalai 3

Ketajaman jadual hingar semasa penjanaan tekstur.

lalai 500000

Bilangan bucu yang dikehendaki dalam eksport GLB.

Seed rawak yang menjadikan penjanaan boleh dihasilkan semula.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang TRELLIS.2 LoRA Inference

Menjana GLB daripada `image_url`, dengan pilihan menggunakan LoRA safetensors melalui `sparse_structure_lora_url`, `geometry_lora_url` dan `texture_lora_url`. `resolution` ialah 512 atau 1024 dan mesti sepadan dengan resolusi latihan penyesuai. Turut menyediakan kawalan panduan dan langkah bagi setiap peringkat, `decimation_target` dan `texture_size`.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL imej sumber untuk penukaran kepada model 3D.
sparse_structure_lora_urlpilihan
Jenisstring | null
Checkpoint LoRA pilihan dalam format safetensors, dilatih khusus untuk penyahhingar struktur jarang.
geometry_lora_urlpilihan
Jenisstring | null
Checkpoint LoRA pilihan dalam format safetensors, dilatih khusus untuk penyahhingar geometri.
texture_lora_urlpilihan
Jenisstring | null
Checkpoint LoRA pilihan dalam format safetensors, dilatih khusus untuk penyahhingar tekstur.
seedpilihan
Jenisinteger | null
Seed rawak yang menjadikan penjanaan boleh dihasilkan semula.
resolutionpilihan
Jenisenum
Lalai512
5121024
Resolusi penjanaan, dengan 1024 memilih saluran paip lata. Pilih resolusi yang digunakan untuk melatih penyesuai LoRA yang diberikan; padanan diperlukan.
ss_guidance_strengthpilihan
Jenisnumber
Lalai7.5
0 – 10
Kekuatan panduan tanpa pengelas semasa penjanaan struktur jarang.
ss_guidance_rescalepilihan
Jenisnumber
Lalai0.7
0 – 1
Penskalaan semula panduan semasa penjanaan struktur jarang. Nilai lebih besar menjadikan output lebih stabil.
ss_guidance_interval_startpilihan
Jenisnumber
Lalai0.6
0 – 1
Pecahan kemajuan penyahhingaran apabila panduan struktur jarang bermula.
ss_guidance_interval_endpilihan
Jenisnumber
Lalai1
0 – 1
Gunakan pecahan penyahhingaran pada atau melebihi `ss_guidance_interval_start` untuk menentukan masa panduan struktur jarang berhenti.
ss_sampling_stepspilihan
Jenisinteger
Lalai12
1 – 50
Bilangan langkah penyahhingaran semasa penjanaan struktur jarang.
ss_rescale_tpilihan
Jenisnumber
Lalai5
1 – 6
Ketajaman jadual hingar semasa penjanaan struktur jarang.
shape_slat_guidance_strengthpilihan
Jenisnumber
Lalai7.5
0 – 10
Kekuatan panduan tanpa pengelas semasa penjanaan bentuk.
shape_slat_guidance_rescalepilihan
Jenisnumber
Lalai0.5
0 – 1
Penskalaan semula yang digunakan pada panduan semasa penjanaan bentuk; tingkatkan apabila geometri kelihatan berhingar.
shape_slat_guidance_interval_startpilihan
Jenisnumber
Lalai0.6
0 – 1
Pecahan penyahhingaran apabila panduan peringkat bentuk bermula.
shape_slat_guidance_interval_endpilihan
Jenisnumber
Lalai1
0 – 1
Titik berhenti panduan peringkat bentuk, dinyatakan sebagai pecahan penyahhingaran yang tidak kurang daripada shape_slat_guidance_interval_start.
shape_slat_sampling_stepspilihan
Jenisinteger
Lalai12
1 – 50
Bilangan langkah penyahhingaran semasa penjanaan bentuk.
shape_slat_rescale_tpilihan
Jenisnumber
Lalai3
1 – 6
Ketajaman jadual hingar semasa penjanaan bentuk.
tex_slat_guidance_strengthpilihan
Jenisnumber
Lalai1
0 – 10
Kekuatan panduan tanpa pengelas semasa penjanaan tekstur.
tex_slat_guidance_rescalepilihan
Jenisnumber
Lalai0
0 – 1
Penskalaan semula yang digunakan pada panduan semasa penjanaan tekstur; tingkatkan apabila tekstur kelihatan berhingar.
tex_slat_guidance_interval_startpilihan
Jenisnumber
Lalai0.6
0 – 1
Pecahan penyahhingaran apabila panduan peringkat tekstur bermula.
tex_slat_guidance_interval_endpilihan
Jenisnumber
Lalai0.9
0 – 1
Titik berhenti panduan peringkat tekstur, dinyatakan sebagai pecahan penyahhingaran yang tidak kurang daripada tex_slat_guidance_interval_start.
tex_slat_sampling_stepspilihan
Jenisinteger
Lalai12
1 – 50
Bilangan langkah penyahhingaran semasa penjanaan tekstur.
tex_slat_rescale_tpilihan
Jenisnumber
Lalai3
1 – 6
Ketajaman jadual hingar semasa penjanaan tekstur.
decimation_targetpilihan
Jenisinteger
Lalai500000
5,000 – 2,000,000
Bilangan bucu yang dikehendaki dalam eksport GLB.
texture_sizepilihan
Jenisenum
Lalai2048
102420484096
Resolusi tekstur yang dibakar ke dalam eksport GLB.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
model_glb
object {url, content_type, file_name, file_size}Fail GLB yang mengandungi model 3D yang dijana.
seed
integerSeed yang digunakan semasa penjanaan.
resolution
integerResolusi ketika penjanaan dilakukan.
sparse_structure_lora_url
string | nullCheckpoint LoRA struktur jarang yang digunakan semasa penjanaan, jika digunakan.
geometry_lora_url
string | nullCheckpoint LoRA geometri yang digunakan semasa penjanaan, jika digunakan.
texture_lora_url
string | nullCheckpoint LoRA tekstur yang digunakan semasa penjanaan, jika digunakan.
decimation_target
integerSasaran bilangan bucu yang digunakan pada eksport GLB.
texture_size
integerResolusi tekstur yang dibakar ke dalam eksport GLB.

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/trellis-2-lora.md. Semua model dan panduan: https://doitong.com/developers/llms.txt