Langkau ke kandungan

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

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

Mentekstur semula mesh 3D tanpa tekstur sedia ada agar sepadan dengan imej rujukan, menghasilkan GLB

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

resolution lalai 1024

Perincian tekstur dan kelajuan pemprosesan bergantung pada resolusi penjanaan dalaman ini: meningkatkannya menghasilkan perincian lebih halus tetapi mengambil masa lebih lama.

•diperlukan

URL sumber tekstur semula 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 lalai 2048

Resolusi tekstur mesh untuk baking. Perincian permukaan yang lebih halus menghasilkan fail yang lebih besar apabila resolusi ini ditingkatkan.

lalai 1

Kawalan kesetiaan warna tekstur: pematuhan yang lebih dekat kepada warna dalam imej input pada tetapan lebih tinggi meningkatkan kecerahan tetapi boleh menyebabkan terlebih tepu.

lalai 0

Tingkatkan tetapan ini untuk menangani tekstur bising atau jalur warna: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat tekstur.

lalai 0.6

Titik pengaktifan panduan tanpa pengelas untuk penjanaan tekstur. Dinyatakan sebagai pecahan kemajuan penyahhingaran, ia menetapkan interval_start; panduan hanya beroperasi dalam tetingkap antara interval_start dan interval_end.

lalai 0.9

Sempadan berhenti panduan tanpa pengelas peringkat tekstur, dinyatakan sebagai pecahan penyahhingaran yang tidak kurang daripada tex_slat_guidance_interval_start.

lalai 12

Bilangan langkah penyahhingaran yang digunakan untuk menjana tekstur. Meningkatkan bilangan langkah mengambil masa lebih lama tetapi mungkin menghasilkan tekstur yang lebih bersih.

lalai 3

Tetapkan ketajaman perincian tekstur melalui jadual hingar penjanaan tekstur; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.

Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.

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

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

Menggunakan tekstur baharu pada jejaring di `mesh_url` (GLB, OBJ, PLY atau STL) berdasarkan imej rujukan `image_url`. `resolution` ialah 512 atau 1024, manakala `texture_size` ialah 1024, 2048 atau 4096. Panduan dan kawalan pensampelan peringkat tekstur tersedia. Geometri tidak dijana semula.

Parameter

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

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL imej rujukan yang digunakan untuk tekstur.
mesh_urldiperlukan
Jenisstring
URL sumber tekstur semula untuk mesh 3D tanpa tekstur dalam format GLB, OBJ, PLY atau STL.
seedpilihan
Jenisinteger | null
Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.
resolutionpilihan
Jenisenum
Lalai1024
5121024
Perincian tekstur dan kelajuan pemprosesan bergantung pada resolusi penjanaan dalaman ini: meningkatkannya menghasilkan perincian lebih halus tetapi mengambil masa lebih lama.
tex_slat_guidance_strengthpilihan
Jenisnumber
Lalai1
0 – 10
Kawalan kesetiaan warna tekstur: pematuhan yang lebih dekat kepada warna dalam imej input pada tetapan lebih tinggi meningkatkan kecerahan tetapi boleh menyebabkan terlebih tepu.
tex_slat_guidance_rescalepilihan
Jenisnumber
Lalai0
0 – 1
Tingkatkan tetapan ini untuk menangani tekstur bising atau jalur warna: ia mengurangkan artifak yang disebabkan oleh panduan kuat semasa peringkat tekstur.
tex_slat_guidance_interval_startpilihan
Jenisnumber
Lalai0.6
0 – 1
Titik pengaktifan panduan tanpa pengelas untuk penjanaan tekstur. Dinyatakan sebagai pecahan kemajuan penyahhingaran, ia menetapkan interval_start; panduan hanya beroperasi dalam tetingkap antara interval_start dan interval_end.
tex_slat_guidance_interval_endpilihan
Jenisnumber
Lalai0.9
0 – 1
Sempadan berhenti panduan tanpa pengelas 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 yang digunakan untuk menjana tekstur. Meningkatkan bilangan langkah mengambil masa lebih lama tetapi mungkin menghasilkan tekstur yang lebih bersih.
tex_slat_rescale_tpilihan
Jenisnumber
Lalai3
1 – 6
Tetapkan ketajaman perincian tekstur melalui jadual hingar penjanaan tekstur; meningkatkan nilai ini menghasilkan perincian yang lebih tajam.
texture_sizepilihan
Jenisenum
Lalai2048
102420484096
Resolusi tekstur mesh untuk baking. Perincian permukaan yang lebih halus menghasilkan fail yang lebih besar apabila resolusi ini ditingkatkan.
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/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"
  }
}
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}Model 3D yang dijana dalam format GLB.

Lebih banyak model: Imej ke 3D

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