Lompat ke konten

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 di halaman ini

Dapatkan kunci API
Microsoft Gambar ke 3D

Image-to-3D Trellis 2 yang dapat menerapkan adapter LoRA khusus untuk struktur, geometri, dan tekstur

Microsoft · 3D

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib image_url
Jatuhkan file, atau

URL gambar sumber untuk dikonversi menjadi model 3D.

resolution bawaan 512

Resolusi pembuatan, dengan 1024 memilih pipeline cascade. Pilih resolusi yang digunakan untuk melatih adapter LoRA yang diberikan; kecocokan 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 opsional dalam format safetensors, yang dilatih khusus untuk denoiser tekstur.

texture_size bawaan 2048

Resolusi tekstur yang dibake ke dalam ekspor GLB.

Checkpoint LoRA opsional dalam format safetensors, yang dilatih khusus untuk denoiser struktur sparse.

Checkpoint LoRA opsional dalam format safetensors, yang dilatih khusus untuk denoiser geometri.

bawaan 7.5

Kekuatan panduan tanpa classifier selama pembuatan struktur sparse.

bawaan 0.7

Penskalaan ulang panduan selama pembuatan struktur sparse. Nilai yang lebih besar membuat output lebih stabil.

bawaan 0.6

Pecahan kemajuan pengurangan noise saat panduan struktur sparse dimulai.

bawaan 1

Gunakan pecahan pengurangan noise pada atau di atas `ss_guidance_interval_start` untuk menentukan kapan panduan struktur sparse berhenti.

bawaan 12

Jumlah langkah pengurangan noise yang digunakan selama pembuatan struktur sparse.

bawaan 5

Ketajaman jadwal noise selama pembuatan struktur sparse.

bawaan 7.5

Kekuatan panduan tanpa classifier selama pembuatan bentuk.

bawaan 0.5

Penskalaan ulang yang diterapkan pada panduan selama pembuatan bentuk; naikkan jika geometri tampak ber-noise.

bawaan 0.6

Pecahan pengurangan noise saat panduan tahap bentuk dimulai.

bawaan 1

Titik berhenti panduan tahap bentuk, dinyatakan sebagai pecahan pengurangan noise yang tidak lebih kecil dari shape_slat_guidance_interval_start.

bawaan 12

Jumlah langkah pengurangan noise selama pembuatan bentuk.

bawaan 3

Ketajaman jadwal noise selama pembuatan bentuk.

bawaan 1

Kekuatan panduan tanpa classifier selama pembuatan tekstur.

bawaan 0

Penskalaan ulang yang diterapkan pada panduan selama pembuatan tekstur; naikkan jika tekstur tampak ber-noise.

bawaan 0.6

Pecahan pengurangan noise saat panduan tahap tekstur dimulai.

bawaan 0.9

Titik berhenti panduan tahap tekstur, dinyatakan sebagai pecahan pengurangan noise yang tidak lebih kecil dari tex_slat_guidance_interval_start.

bawaan 12

Jumlah langkah pengurangan noise selama pembuatan tekstur.

bawaan 3

Ketajaman jadwal noise selama pembuatan tekstur.

bawaan 500000

Jumlah vertex yang diinginkan dalam ekspor GLB.

Seed acak yang membuat pembuatan dapat direproduksi.

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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang TRELLIS.2 LoRA Inference

Menghasilkan GLB dari `image_url`, secara opsional menerapkan LoRA safetensors melalui `sparse_structure_lora_url`, `geometry_lora_url`, dan `texture_lora_url`. `resolution` adalah 512 atau 1024 dan harus sesuai dengan resolusi pelatihan adapter. Juga menyediakan kontrol panduan dan langkah per tahap, `decimation_target`, serta `texture_size`.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
URL gambar sumber untuk dikonversi menjadi model 3D.
sparse_structure_lora_urlopsional
Tipestring | null
Checkpoint LoRA opsional dalam format safetensors, yang dilatih khusus untuk denoiser struktur sparse.
geometry_lora_urlopsional
Tipestring | null
Checkpoint LoRA opsional dalam format safetensors, yang dilatih khusus untuk denoiser geometri.
texture_lora_urlopsional
Tipestring | null
Checkpoint LoRA opsional dalam format safetensors, yang dilatih khusus untuk denoiser tekstur.
seedopsional
Tipeinteger | null
Seed acak yang membuat pembuatan dapat direproduksi.
resolutionopsional
Tipeenum
Bawaan512
5121024
Resolusi pembuatan, dengan 1024 memilih pipeline cascade. Pilih resolusi yang digunakan untuk melatih adapter LoRA yang diberikan; kecocokan diperlukan.
ss_guidance_strengthopsional
Tipenumber
Bawaan7.5
0 – 10
Kekuatan panduan tanpa classifier selama pembuatan struktur sparse.
ss_guidance_rescaleopsional
Tipenumber
Bawaan0.7
0 – 1
Penskalaan ulang panduan selama pembuatan struktur sparse. Nilai yang lebih besar membuat output lebih stabil.
ss_guidance_interval_startopsional
Tipenumber
Bawaan0.6
0 – 1
Pecahan kemajuan pengurangan noise saat panduan struktur sparse dimulai.
ss_guidance_interval_endopsional
Tipenumber
Bawaan1
0 – 1
Gunakan pecahan pengurangan noise pada atau di atas `ss_guidance_interval_start` untuk menentukan kapan panduan struktur sparse berhenti.
ss_sampling_stepsopsional
Tipeinteger
Bawaan12
1 – 50
Jumlah langkah pengurangan noise yang digunakan selama pembuatan struktur sparse.
ss_rescale_topsional
Tipenumber
Bawaan5
1 – 6
Ketajaman jadwal noise selama pembuatan struktur sparse.
shape_slat_guidance_strengthopsional
Tipenumber
Bawaan7.5
0 – 10
Kekuatan panduan tanpa classifier selama pembuatan bentuk.
shape_slat_guidance_rescaleopsional
Tipenumber
Bawaan0.5
0 – 1
Penskalaan ulang yang diterapkan pada panduan selama pembuatan bentuk; naikkan jika geometri tampak ber-noise.
shape_slat_guidance_interval_startopsional
Tipenumber
Bawaan0.6
0 – 1
Pecahan pengurangan noise saat panduan tahap bentuk dimulai.
shape_slat_guidance_interval_endopsional
Tipenumber
Bawaan1
0 – 1
Titik berhenti panduan tahap bentuk, dinyatakan sebagai pecahan pengurangan noise yang tidak lebih kecil dari shape_slat_guidance_interval_start.
shape_slat_sampling_stepsopsional
Tipeinteger
Bawaan12
1 – 50
Jumlah langkah pengurangan noise selama pembuatan bentuk.
shape_slat_rescale_topsional
Tipenumber
Bawaan3
1 – 6
Ketajaman jadwal noise selama pembuatan bentuk.
tex_slat_guidance_strengthopsional
Tipenumber
Bawaan1
0 – 10
Kekuatan panduan tanpa classifier selama pembuatan tekstur.
tex_slat_guidance_rescaleopsional
Tipenumber
Bawaan0
0 – 1
Penskalaan ulang yang diterapkan pada panduan selama pembuatan tekstur; naikkan jika tekstur tampak ber-noise.
tex_slat_guidance_interval_startopsional
Tipenumber
Bawaan0.6
0 – 1
Pecahan pengurangan noise saat panduan tahap tekstur dimulai.
tex_slat_guidance_interval_endopsional
Tipenumber
Bawaan0.9
0 – 1
Titik berhenti panduan tahap tekstur, dinyatakan sebagai pecahan pengurangan noise yang tidak lebih kecil dari tex_slat_guidance_interval_start.
tex_slat_sampling_stepsopsional
Tipeinteger
Bawaan12
1 – 50
Jumlah langkah pengurangan noise selama pembuatan tekstur.
tex_slat_rescale_topsional
Tipenumber
Bawaan3
1 – 6
Ketajaman jadwal noise selama pembuatan tekstur.
decimation_targetopsional
Tipeinteger
Bawaan500000
5.000 – 2.000.000
Jumlah vertex yang diinginkan dalam ekspor GLB.
texture_sizeopsional
Tipeenum
Bawaan2048
102420484096
Resolusi tekstur yang dibake ke dalam ekspor GLB.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Penyaringan dapat dilonggarkan dengan menetapkan false, jika pemanggil berwenang.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
model_glb
object {url, content_type, file_name, file_size}file GLB yang berisi model 3D yang dibuat.
seed
integerSeed yang diterapkan selama pembuatan.
resolution
integerResolusi saat pembuatan dilakukan.
sparse_structure_lora_url
string | nullCheckpoint LoRA struktur sparse yang digunakan selama pembuatan, jika diterapkan.
geometry_lora_url
string | nullCheckpoint LoRA geometri yang digunakan selama pembuatan, jika diterapkan.
texture_lora_url
string | nullCheckpoint LoRA tekstur yang digunakan selama pembuatan, jika diterapkan.
decimation_target
integerTarget jumlah vertex yang diterapkan pada ekspor GLB.
texture_size
integerResolusi tekstur yang dibake ke dalam ekspor GLB.

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