Lompat ke konten

Trellis 2 · Retexture

Integrasikan

ID model trellis-2/retexture
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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"

Permintaan ini: $0,24 240 kredit API · ≈ ₽25,31 Jalankan di halaman ini

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

Memberi tekstur ulang pada mesh 3D tanpa tekstur yang sudah ada agar sesuai dengan gambar referensi, dengan output GLB

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 referensi yang digunakan untuk tekstur.

resolution bawaan 1024

Detail tekstur dan kecepatan pemrosesan bergantung pada resolusi pembuatan internal ini: menaikkannya menghasilkan detail yang lebih halus tetapi membutuhkan waktu lebih lama.

•wajib

URL sumber tekstur ulang untuk mesh 3D tanpa tekstur dalam format GLB, OBJ, PLY, atau STL.

Lanjutan texture_size · 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 · seed
texture_size bawaan 2048

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

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. 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 berhenti panduan tanpa classifier tahap tekstur, ditentukan sebagai pecahan pengurangan noise yang tidak lebih kecil dari tex_slat_guidance_interval_start.

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.

Seed yang digunakan untuk pembuatan acak yang dapat direproduksi.

POST /run/trellis-2/retexture?wait=20 estimasi harga → $0,24
# 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/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# 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"

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 · Retexture

Menerapkan tekstur baru pada mesh di `mesh_url` (GLB, OBJ, PLY, atau STL) berdasarkan gambar referensi `image_url`. `resolution` adalah 512 atau 1024, dan `texture_size` adalah 1024, 2048, atau 4096. Kontrol panduan dan sampling tahap tekstur tersedia. Geometri tidak dibuat ulang.

Parameter

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

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
URL gambar referensi yang digunakan untuk tekstur.
mesh_urlwajib
Tipestring
URL sumber tekstur ulang untuk mesh 3D tanpa tekstur dalam format GLB, OBJ, PLY, atau STL.
seedopsional
Tipeinteger | null
Seed yang digunakan untuk pembuatan acak yang dapat direproduksi.
resolutionopsional
Tipeenum
Bawaan1024
5121024
Detail tekstur dan kecepatan pemrosesan bergantung pada resolusi pembuatan internal ini: menaikkannya menghasilkan detail yang lebih halus tetapi membutuhkan waktu lebih lama.
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. 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 berhenti panduan tanpa classifier tahap tekstur, ditentukan sebagai pecahan pengurangan noise yang tidak lebih kecil dari tex_slat_guidance_interval_start.
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.
texture_sizeopsional
Tipeenum
Bawaan2048
102420484096
Resolusi tekstur mesh untuk baking. Detail permukaan yang lebih halus menghasilkan file yang lebih besar saat resolusi ini ditingkatkan.
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/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/retexture.md. Semua model dan panduan: https://doitong.com/developers/llms.txt