Lompat ke konten

Trellis 2

Integrasikan

ID model trellis-2
# 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?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,30 300 kredit API Jalankan di halaman ini

Dapatkan kunci API
Microsoft Gambar ke 3D #image-to-3d

Mengubah satu gambar menjadi mesh 3D GLB bertekstur dengan pengaturan struktur, bentuk, tekstur, dan UV yang dapat disesuaikan

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 yang mengarah ke gambar sumber untuk konversi 3D.

resolution bawaan 1024

Resolusi output; meningkatkannya menambahkan detail tetapi membutuhkan waktu lebih lama.

Lanjutan texture_size · 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 · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh
texture_size bawaan 2048

Resolusi tekstur mesh untuk baking. Detail permukaan yang lebih halus menghasilkan file yang lebih besar saat resolusi ini ditingkatkan.

bawaan 7.5

Kontrol fidelitas struktur 3D awal: meningkatkannya menghasilkan kesesuaian yang lebih dekat dengan gambar input dengan risiko noise tambahan.

bawaan 0.7

Kontrol artefak panduan tahap 1, menukar efek panduan yang lebih kuat pada pengaturan rendah dengan output yang lebih stabil pada pengaturan tinggi.

bawaan 0.6

Batas awal jendela panduan tanpa classifier pada tahap 1 (struktur sparse), dinyatakan sebagai pecahan pengurangan noise. Pengaturan yang lebih rendah memulai panduan lebih cepat; hanya interval dari interval_start hingga interval_end yang menggunakan panduan, sedangkan pemrosesan lainnya tanpa panduan.

bawaan 1

Batas panduan untuk tahap 1 (struktur sparse): pilih nilai yang setidaknya sebesar ss_guidance_interval_start. Nilai ini menunjukkan pecahan pengurangan noise saat panduan tanpa classifier berhenti.

bawaan 12

Jumlah denoising struktur awal: potensi peningkatan kualitas dari langkah tambahan disertai pemrosesan yang lebih lambat.

bawaan 5

Atur ketajaman transisi melalui jadwal noise pembuatan struktur: meningkatkan nilai ini membuat transisi lebih tajam.

bawaan 7.5

Kontrol fidelitas geometri terperinci: meningkatkan kepatuhan pada gambar input menghasilkan detail tambahan, dengan risiko noise tambahan.

bawaan 0.5

Tingkatkan pengaturan ini saat geometri tampak ber-noise: ini mengurangi artefak yang disebabkan oleh panduan kuat selama tahap bentuk.

bawaan 0.6

Titik aktivasi panduan tanpa classifier untuk penyempurnaan bentuk pada tahap 2. Dinyatakan sebagai pecahan kemajuan pengurangan noise, nilai ini menetapkan interval_start; panduan hanya beroperasi dalam jendela yang dibatasi oleh interval_start dan interval_end.

bawaan 1

Batas panduan untuk tahap 2 (penyempurnaan bentuk): pilih nilai yang setidaknya sebesar shape_slat_guidance_interval_start. Nilai ini menunjukkan pecahan pengurangan noise saat panduan tanpa classifier berhenti.

bawaan 12

Jumlah denoising penyempurnaan bentuk: geometri yang berpotensi lebih halus mengorbankan kecepatan saat langkah tambahan digunakan.

bawaan 3

Atur ketajaman detail geometris melalui jadwal noise penyempurnaan bentuk; meningkatkan nilai ini menghasilkan detail yang lebih tajam.

bawaan 1

Kontrol fidelitas warna tekstur: kepatuhan yang lebih dekat pada warna gambar input pada pengaturan tinggi meningkatkan kejelasan warna, tetapi dapat menyebabkan oversaturasi.

bawaan 0

Tingkatkan pengaturan ini untuk mengatasi tekstur ber-noise atau color banding: ini mengurangi artefak yang disebabkan oleh panduan kuat selama tahap tekstur.

bawaan 0.6

Titik aktivasi panduan tanpa classifier untuk pembuatan tekstur pada tahap 3. Dinyatakan sebagai pecahan kemajuan pengurangan noise, nilai ini menetapkan interval_start; panduan hanya beroperasi dalam jendela yang dibatasi oleh interval_start dan interval_end.

bawaan 0.9

Batas panduan untuk tahap 3 (tekstur): pilih nilai yang setidaknya sebesar tex_slat_guidance_interval_start. Nilai ini menunjukkan pecahan pengurangan noise saat panduan tanpa classifier berhenti.

bawaan 12

Jumlah langkah denoising yang digunakan untuk menghasilkan tekstur. Meningkatkan jumlah langkah membutuhkan waktu lebih lama, tetapi dapat menghasilkan tekstur yang lebih bersih.

bawaan 3

Atur ketajaman detail tekstur melalui jadwal noise pembuatan tekstur; meningkatkan nilai ini menghasilkan detail yang lebih tajam.

bawaan 500000

Target jumlah vertex mesh, dengan 500k direkomendasikan untuk penggunaan umum dan 20k–50k untuk web/mobile. Mengurangi target menukar detail mesh dengan file yang lebih kecil.

bawaan 1

Toleransi pergerakan remeshing: penghalusan tambahan dapat mengorbankan detail halus saat nilai ini dinaikkan. Pengaturan ini membatasi perpindahan vertex relatif terhadap permukaan asli.

bawaan 0

Kekuatan proyeksi untuk mengembalikan vertex yang di-remesh ke permukaan asli: 1 mempertahankan detail melalui proyeksi penuh, sedangkan 0 menonaktifkan proyeksi untuk hasil yang lebih halus.

bawaan 90

Batas sudut chart UV dalam derajat, yang membatasi perbedaan normal wajah bertetangga dalam satu chart. Menaikkan batas ini cenderung menghasilkan lebih sedikit chart yang lebih besar dengan risiko peregangan; menurunkannya cenderung menghasilkan lebih banyak chart dan distorsi lebih kecil.

bawaan 0

Jumlah lintasan penyempurnaan lokal yang digunakan untuk menghitung chart UV.

bawaan 1

Keseimbangan chart UV dapat ditingkatkan dengan menambah jumlah lintasan pengelompokan global yang digunakan untuk menghitung chart.

bawaan 1

Sesuaikan seberapa kuat tepi chart UV dihaluskan; seam yang lebih tidak terlihat pada pengaturan tinggi disertai risiko distorsi UV.

Seed yang digunakan untuk pembuatan acak yang dapat direproduksi.

POST /run/trellis-2?wait=20 estimasi harga → $0,30
# 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?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

Membangun aset 3D dari satu gambar (`image_url`) dan mengembalikan file GLB. `resolution` adalah 512, 1024, atau 1536, sedangkan `texture_size` adalah 1024, 2048, atau 4096. Masing-masing dari tiga tahap (struktur, bentuk, tekstur) memiliki kontrol panduan dan langkah sampling sendiri. `decimation_target` mengatur jumlah vertex mesh (5,000 hingga 2,000,000), dan opsi remeshing serta pembukaan UV tersedia.

Parameter

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

NamaTipe BawaanDiizinkan Deskripsi
seedopsional
Tipeinteger | null
Seed yang digunakan untuk pembuatan acak yang dapat direproduksi.
resolutionopsional
Tipeenum
Bawaan1024
51210241536
Resolusi output; meningkatkannya menambahkan detail tetapi membutuhkan waktu lebih lama.
ss_guidance_strengthopsional
Tipenumber
Bawaan7.5
0 – 10
Kontrol fidelitas struktur 3D awal: meningkatkannya menghasilkan kesesuaian yang lebih dekat dengan gambar input dengan risiko noise tambahan.
ss_guidance_rescaleopsional
Tipenumber
Bawaan0.7
0 – 1
Kontrol artefak panduan tahap 1, menukar efek panduan yang lebih kuat pada pengaturan rendah dengan output yang lebih stabil pada pengaturan tinggi.
ss_guidance_interval_startopsional
Tipenumber
Bawaan0.6
0 – 1
Batas awal jendela panduan tanpa classifier pada tahap 1 (struktur sparse), dinyatakan sebagai pecahan pengurangan noise. Pengaturan yang lebih rendah memulai panduan lebih cepat; hanya interval dari interval_start hingga interval_end yang menggunakan panduan, sedangkan pemrosesan lainnya tanpa panduan.
ss_guidance_interval_endopsional
Tipenumber
Bawaan1
0 – 1
Batas panduan untuk tahap 1 (struktur sparse): pilih nilai yang setidaknya sebesar ss_guidance_interval_start. Nilai ini menunjukkan pecahan pengurangan noise saat panduan tanpa classifier berhenti.
ss_sampling_stepsopsional
Tipeinteger
Bawaan12
1 – 50
Jumlah denoising struktur awal: potensi peningkatan kualitas dari langkah tambahan disertai pemrosesan yang lebih lambat.
ss_rescale_topsional
Tipenumber
Bawaan5
1 – 6
Atur ketajaman transisi melalui jadwal noise pembuatan struktur: meningkatkan nilai ini membuat transisi lebih tajam.
shape_slat_guidance_strengthopsional
Tipenumber
Bawaan7.5
0 – 10
Kontrol fidelitas geometri terperinci: meningkatkan kepatuhan pada gambar input menghasilkan detail tambahan, dengan risiko noise tambahan.
shape_slat_guidance_rescaleopsional
Tipenumber
Bawaan0.5
0 – 1
Tingkatkan pengaturan ini saat geometri tampak ber-noise: ini mengurangi artefak yang disebabkan oleh panduan kuat selama tahap bentuk.
shape_slat_guidance_interval_startopsional
Tipenumber
Bawaan0.6
0 – 1
Titik aktivasi panduan tanpa classifier untuk penyempurnaan bentuk pada tahap 2. Dinyatakan sebagai pecahan kemajuan pengurangan noise, nilai ini menetapkan interval_start; panduan hanya beroperasi dalam jendela yang dibatasi oleh interval_start dan interval_end.
shape_slat_guidance_interval_endopsional
Tipenumber
Bawaan1
0 – 1
Batas panduan untuk tahap 2 (penyempurnaan bentuk): pilih nilai yang setidaknya sebesar shape_slat_guidance_interval_start. Nilai ini menunjukkan pecahan pengurangan noise saat panduan tanpa classifier berhenti.
shape_slat_sampling_stepsopsional
Tipeinteger
Bawaan12
1 – 50
Jumlah denoising penyempurnaan bentuk: geometri yang berpotensi lebih halus mengorbankan kecepatan saat langkah tambahan digunakan.
shape_slat_rescale_topsional
Tipenumber
Bawaan3
1 – 6
Atur ketajaman detail geometris melalui jadwal noise penyempurnaan bentuk; meningkatkan nilai ini menghasilkan detail yang lebih tajam.
tex_slat_guidance_strengthopsional
Tipenumber
Bawaan1
0 – 10
Kontrol fidelitas warna tekstur: kepatuhan yang lebih dekat pada warna gambar input pada pengaturan tinggi meningkatkan kejelasan warna, tetapi dapat menyebabkan oversaturasi.
tex_slat_guidance_rescaleopsional
Tipenumber
Bawaan0
0 – 1
Tingkatkan pengaturan ini untuk mengatasi tekstur ber-noise atau color banding: ini mengurangi artefak yang disebabkan oleh panduan kuat selama tahap tekstur.
tex_slat_guidance_interval_startopsional
Tipenumber
Bawaan0.6
0 – 1
Titik aktivasi panduan tanpa classifier untuk pembuatan tekstur pada tahap 3. Dinyatakan sebagai pecahan kemajuan pengurangan noise, nilai ini menetapkan interval_start; panduan hanya beroperasi dalam jendela yang dibatasi oleh interval_start dan interval_end.
tex_slat_guidance_interval_endopsional
Tipenumber
Bawaan0.9
0 – 1
Batas panduan untuk tahap 3 (tekstur): pilih nilai yang setidaknya sebesar tex_slat_guidance_interval_start. Nilai ini menunjukkan pecahan pengurangan noise saat panduan tanpa classifier berhenti.
tex_slat_sampling_stepsopsional
Tipeinteger
Bawaan12
1 – 50
Jumlah langkah denoising yang digunakan untuk menghasilkan tekstur. Meningkatkan jumlah langkah membutuhkan waktu lebih lama, tetapi dapat menghasilkan tekstur yang lebih bersih.
tex_slat_rescale_topsional
Tipenumber
Bawaan3
1 – 6
Atur ketajaman detail tekstur melalui jadwal noise pembuatan tekstur; meningkatkan nilai ini menghasilkan detail yang lebih tajam.
decimation_targetopsional
Tipeinteger
Bawaan500000
5.000 – 2.000.000
Target jumlah vertex mesh, dengan 500k direkomendasikan untuk penggunaan umum dan 20k–50k untuk web/mobile. Mengurangi target menukar detail mesh dengan file yang lebih kecil.
texture_sizeopsional
Tipeenum
Bawaan2048
102420484096
Resolusi tekstur mesh untuk baking. Detail permukaan yang lebih halus menghasilkan file yang lebih besar saat resolusi ini ditingkatkan.
remeshopsional
Tipeboolean
Bawaantrue
Pembangunan ulang topologi yang menghasilkan segitiga mesh lebih bersih, biasanya meningkatkan kesesuaian untuk penggunaan lanjutan seperti animasi atau pencetakan 3D, dengan mengorbankan pemrosesan yang lebih lambat.
remesh_bandopsional
Tipenumber
Bawaan1
0 – 4
Toleransi pergerakan remeshing: penghalusan tambahan dapat mengorbankan detail halus saat nilai ini dinaikkan. Pengaturan ini membatasi perpindahan vertex relatif terhadap permukaan asli.
remesh_projectopsional
Tipenumber
Bawaan0
0 – 1
Kekuatan proyeksi untuk mengembalikan vertex yang di-remesh ke permukaan asli: 1 mempertahankan detail melalui proyeksi penuh, sedangkan 0 menonaktifkan proyeksi untuk hasil yang lebih halus.
uv_unwrap_angle_threshold_degopsional
Tipenumber
Bawaan90
0 – 180
Batas sudut chart UV dalam derajat, yang membatasi perbedaan normal wajah bertetangga dalam satu chart. Menaikkan batas ini cenderung menghasilkan lebih sedikit chart yang lebih besar dengan risiko peregangan; menurunkannya cenderung menghasilkan lebih banyak chart dan distorsi lebih kecil.
uv_unwrap_refine_iterationsopsional
Tipeinteger
Bawaan0
0 – 10
Jumlah lintasan penyempurnaan lokal yang digunakan untuk menghitung chart UV.
uv_unwrap_global_iterationsopsional
Tipeinteger
Bawaan1
1 – 10
Keseimbangan chart UV dapat ditingkatkan dengan menambah jumlah lintasan pengelompokan global yang digunakan untuk menghitung chart.
uv_unwrap_smooth_strengthopsional
Tipenumber
Bawaan1
0 – 10
Sesuaikan seberapa kuat tepi chart UV dihaluskan; seam yang lebih tidak terlihat pada pengaturan tinggi disertai risiko distorsi UV.
image_urlwajib image
Tipeurl · image
URL yang mengarah ke gambar sumber untuk konversi 3D.
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",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    }
  },
  "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}Model 3D yang dibuat dalam format GLB.

Model lainnya: Gambar ke 3D

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