İçeriğe geç

Trellis 2 · Retexture

Entegre et

Model kimliği 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu istek: $0,24 240 API kredisi Bu sayfada çalıştır

API anahtarı al
Microsoft Görselden 3D'ye #image-to-3d

Mevcut dokusuz bir 3D poligon ağını referans görsele uyacak şekilde yeniden dokular ve GLB çıktısı verir

Microsoft · 3D

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli image_url
Dosyayı bırakın veya

Doku oluşturma için kullanılan referans görsel URL'si.

resolution varsayılan 1024

Doku ayrıntısı ve işleme hızı bu dahili üretim çözünürlüğüne bağlıdır: artırılması daha ince ayrıntılar sağlar ancak daha uzun sürer.

•gerekli

GLB, OBJ, PLY veya STL biçimindeki dokusuz 3D mesh için yeniden doku oluşturma kaynak URL'si.

Gelişmiş 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 varsayılan 2048

Pişirme için ağ doku çözünürlüğü. Bu çözünürlük artırıldığında daha ince yüzey ayrıntısı daha büyük dosyalar oluşturur.

varsayılan 1

Doku renk sadakati denetimi: yüksek ayarlarda girdi görselindeki renklere daha yakın uyum canlılığı artırır ancak aşırı doygunluğa neden olabilir.

varsayılan 0

Gürültülü dokuları veya renk bantlarını düzeltmek için bu ayarı artırın: doku aşamasında güçlü yönlendirmeden kaynaklanan artefaktları azaltır.

varsayılan 0.6

Doku üretimi için sınıflandırıcısız yönlendirmenin etkinleşme noktası. Gürültü giderme ilerlemesinin kesri olarak ifade edilir, interval_start değerini belirler; yönlendirme yalnızca interval_start ve interval_end ile sınırlanan pencerede çalışır.

varsayılan 0.9

tex_slat_guidance_interval_start değerinden küçük olmayan bir gürültü giderme kesri olarak belirtilen doku aşaması sınıflandırıcısız yönlendirme durma sınırı.

varsayılan 12

Dokuları oluşturmak için kullanılan gürültü giderme adımı sayısı. Artırılması daha uzun sürer ancak daha temiz dokular sağlayabilir.

varsayılan 3

Doku oluşturma gürültü zamanlamasıyla doku ayrıntısı keskinliğini ayarlayın; bu değerin artırılması daha keskin ayrıntılar sağlar.

Tekrarlanabilir rastgele üretim için kullanılan tohum.

POST /run/trellis-2/retexture?wait=20 fiyat → $0,24
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Trellis 2 · Retexture hakkında

`mesh_url` adresindeki poligon ağına (GLB, OBJ, PLY veya STL) bir `image_url` referansına göre yeni doku uygular. `resolution` 512 veya 1024; `texture_size` ise 1024, 2048 veya 4096'dır. Doku aşaması yönlendirme ve örnekleme denetimleri kullanılabilir. Geometri yeniden üretilmez.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
image_urlgerekli image
Türurl · image
Doku oluşturma için kullanılan referans görsel URL'si.
mesh_urlgerekli
Türstring
GLB, OBJ, PLY veya STL biçimindeki dokusuz 3D mesh için yeniden doku oluşturma kaynak URL'si.
seedisteğe bağlı
Türinteger | null
Tekrarlanabilir rastgele üretim için kullanılan tohum.
resolutionisteğe bağlı
Türenum
Varsayılan1024
5121024
Doku ayrıntısı ve işleme hızı bu dahili üretim çözünürlüğüne bağlıdır: artırılması daha ince ayrıntılar sağlar ancak daha uzun sürer.
tex_slat_guidance_strengthisteğe bağlı
Türnumber
Varsayılan1
0 – 10
Doku renk sadakati denetimi: yüksek ayarlarda girdi görselindeki renklere daha yakın uyum canlılığı artırır ancak aşırı doygunluğa neden olabilir.
tex_slat_guidance_rescaleisteğe bağlı
Türnumber
Varsayılan0
0 – 1
Gürültülü dokuları veya renk bantlarını düzeltmek için bu ayarı artırın: doku aşamasında güçlü yönlendirmeden kaynaklanan artefaktları azaltır.
tex_slat_guidance_interval_startisteğe bağlı
Türnumber
Varsayılan0.6
0 – 1
Doku üretimi için sınıflandırıcısız yönlendirmenin etkinleşme noktası. Gürültü giderme ilerlemesinin kesri olarak ifade edilir, interval_start değerini belirler; yönlendirme yalnızca interval_start ve interval_end ile sınırlanan pencerede çalışır.
tex_slat_guidance_interval_endisteğe bağlı
Türnumber
Varsayılan0.9
0 – 1
tex_slat_guidance_interval_start değerinden küçük olmayan bir gürültü giderme kesri olarak belirtilen doku aşaması sınıflandırıcısız yönlendirme durma sınırı.
tex_slat_sampling_stepsisteğe bağlı
Türinteger
Varsayılan12
1 – 50
Dokuları oluşturmak için kullanılan gürültü giderme adımı sayısı. Artırılması daha uzun sürer ancak daha temiz dokular sağlayabilir.
tex_slat_rescale_tisteğe bağlı
Türnumber
Varsayılan3
1 – 6
Doku oluşturma gürültü zamanlamasıyla doku ayrıntısı keskinliğini ayarlayın; bu değerin artırılması daha keskin ayrıntılar sağlar.
texture_sizeisteğe bağlı
Türenum
Varsayılan2048
102420484096
Pişirme için ağ doku çözünürlüğü. Bu çözünürlük artırıldığında daha ince yüzey ayrıntısı daha büyük dosyalar oluşturur.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
model_glb
object {url, content_type, file_name, file_size}GLB biçiminde oluşturulan 3D model.

Daha fazla model: Görselden 3D'ye

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/trellis-2/retexture.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt