İçeriğe geç

Trellis 2

Entegre et

Model kimliği 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"

Bu istek: $0,30 300 API kredisi Bu sayfada çalıştır

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

Tek görseli, ayarlanabilir yapı, şekil, doku ve UV ayarlarına sahip dokulu bir GLB 3D poligon ağına dönüştürür

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

3D dönüşüm için kaynak görsele işaret eden URL.

resolution varsayılan 1024

Çıktının çözünürlüğü; artırılması ayrıntı ekler ancak daha uzun sürer.

Gelişmiş 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 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 7.5

İlk 3D yapı sadakati denetimi: artırılması, ek gürültü pahasına girdi görseline daha yakın uyumu destekler.

varsayılan 0.7

Aşama 1 yönlendirme artefaktı denetimi; düşük ayarlarda daha güçlü yönlendirme etkileri, yüksek ayarlarda ise daha kararlı çıktı sağlar.

varsayılan 0.6

1. aşamadaki (seyrek yapı) sınıflandırıcısız yönlendirme penceresinin başlangıç sınırı; gürültü giderme kesri olarak ifade edilir. Daha düşük ayarlar yönlendirmeyi daha erken başlatır; yalnızca interval_start ile interval_end arasındaki aralık yönlendirme kullanır.

varsayılan 1

1. aşama (seyrek yapı) için yönlendirme kesme noktası: ss_guidance_interval_start değerine eşit veya daha büyük bir değer seçin. Değer, sınıflandırıcısız yönlendirmenin durduğu gürültü giderme kesrini belirtir.

varsayılan 12

İlk yapı gürültü giderme sayısı: ek adımlardan gelebilecek kalite kazanımları daha yavaş işlemeyle birlikte gelir.

varsayılan 5

Yapı oluşturma gürültü zamanlamasıyla geçiş keskinliğini ayarlayın; bu değerin artırılması geçişleri keskinleştirir.

varsayılan 7.5

Ayrıntılı geometri sadakati denetimi: girdi görseline uyumun artırılması ek ayrıntı sağlar ancak gürültü riskini artırır.

varsayılan 0.5

Geometri gürültülü göründüğünde bu ayarı artırın: şekil aşamasında güçlü yönlendirmeden kaynaklanan artefaktları azaltır.

varsayılan 0.6

2. aşamada şekil iyileştirme 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 1

2. aşama (şekil iyileştirme) için yönlendirme kesme noktası: shape_slat_guidance_interval_start değerine eşit veya daha büyük bir değer seçin. Değer, sınıflandırıcısız yönlendirmenin durduğu gürültü giderme kesrini belirtir.

varsayılan 12

Şekil iyileştirme gürültü giderme sayısı: ek adımlar kullanıldığında daha pürüzsüz geometri hız pahasına elde edilebilir.

varsayılan 3

Şekil iyileştirme gürültü zamanlamasıyla geometrik ayrıntı keskinliğini ayarlayın; bu değerin artırılması ayrıntıları keskinleştirir.

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

3. aşamada 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

3. aşama (doku) için yönlendirme kesme noktası: tex_slat_guidance_interval_start değerine eşit veya daha büyük bir değer seçin. Değer, sınıflandırıcısız yönlendirmenin durduğu gürültü giderme kesrini belirtir.

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.

varsayılan 500000

Mesh köşe sayısı hedefi; genel kullanım için 500k, web/mobil için 20k–50k önerilir. Hedefin azaltılması mesh ayrıntısını azaltarak daha küçük dosyalar sağlar.

varsayılan 1

Yeniden mesh oluşturma hareket payı: bu değer artırıldığında ek yumuşatma ince ayrıntılardan ödün verebilir. Ayar, köşe yer değiştirmesini özgün yüzeye göre sınırlar.

varsayılan 0

Yeniden mesh oluşturulan köşeleri özgün yüzeye döndürmek için projeksiyon gücü: 1 tam projeksiyonla ayrıntıyı korur, 0 ise projeksiyonu kapatarak daha yumuşak sonuç verir.

varsayılan 90

Derece cinsinden UV chart açı sınırı; tek bir chart içindeki komşu yüz normallerinin ne kadar farklı olabileceğini sınırlar. Sınırın artırılması gerilme riskiyle daha az ve daha büyük chart'ı, azaltılması ise daha fazla chart'ı ve daha az bozulmayı tercih eder.

varsayılan 0

UV chart'larını hesaplamak için kullanılan yerel iyileştirme geçişlerinin sayısı.

varsayılan 1

Chart'ları hesaplamak için kullanılan global kümeleme geçişlerinin sayısı artırılarak UV chart dengesi iyileştirilebilir.

varsayılan 1

UV chart kenarlarının ne kadar güçlü yumuşatılacağını ayarlar; daha yüksek ayarlarda daha az görünür dikişler, UV bozulması riski taşır.

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

POST /run/trellis-2?wait=20 fiyat → $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"

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 hakkında

Tek bir görselden (`image_url`) bir 3D varlık oluşturur ve GLB dosyası döndürür. `resolution` 512, 1024 veya 1536; `texture_size` ise 1024, 2048 veya 4096'dır. Üç aşamanın (yapı, şekil, doku) her birinin kendi yönlendirme ve örnekleme adımı denetimleri vardır. `decimation_target`, poligon ağı köşe sayısını belirler (5,000 ile 2,000,000); yeniden poligonlama ve UV açma seçenekleri sunulur.

Parametreler

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

AdTür Varsayılanİzin verilen Açıklama
seedisteğe bağlı
Türinteger | null
Tekrarlanabilir rastgele üretim için kullanılan tohum.
resolutionisteğe bağlı
Türenum
Varsayılan1024
51210241536
Çıktının çözünürlüğü; artırılması ayrıntı ekler ancak daha uzun sürer.
ss_guidance_strengthisteğe bağlı
Türnumber
Varsayılan7.5
0 – 10
İlk 3D yapı sadakati denetimi: artırılması, ek gürültü pahasına girdi görseline daha yakın uyumu destekler.
ss_guidance_rescaleisteğe bağlı
Türnumber
Varsayılan0.7
0 – 1
Aşama 1 yönlendirme artefaktı denetimi; düşük ayarlarda daha güçlü yönlendirme etkileri, yüksek ayarlarda ise daha kararlı çıktı sağlar.
ss_guidance_interval_startisteğe bağlı
Türnumber
Varsayılan0.6
0 – 1
1. aşamadaki (seyrek yapı) sınıflandırıcısız yönlendirme penceresinin başlangıç sınırı; gürültü giderme kesri olarak ifade edilir. Daha düşük ayarlar yönlendirmeyi daha erken başlatır; yalnızca interval_start ile interval_end arasındaki aralık yönlendirme kullanır.
ss_guidance_interval_endisteğe bağlı
Türnumber
Varsayılan1
0 – 1
1. aşama (seyrek yapı) için yönlendirme kesme noktası: ss_guidance_interval_start değerine eşit veya daha büyük bir değer seçin. Değer, sınıflandırıcısız yönlendirmenin durduğu gürültü giderme kesrini belirtir.
ss_sampling_stepsisteğe bağlı
Türinteger
Varsayılan12
1 – 50
İlk yapı gürültü giderme sayısı: ek adımlardan gelebilecek kalite kazanımları daha yavaş işlemeyle birlikte gelir.
ss_rescale_tisteğe bağlı
Türnumber
Varsayılan5
1 – 6
Yapı oluşturma gürültü zamanlamasıyla geçiş keskinliğini ayarlayın; bu değerin artırılması geçişleri keskinleştirir.
shape_slat_guidance_strengthisteğe bağlı
Türnumber
Varsayılan7.5
0 – 10
Ayrıntılı geometri sadakati denetimi: girdi görseline uyumun artırılması ek ayrıntı sağlar ancak gürültü riskini artırır.
shape_slat_guidance_rescaleisteğe bağlı
Türnumber
Varsayılan0.5
0 – 1
Geometri gürültülü göründüğünde bu ayarı artırın: şekil aşamasında güçlü yönlendirmeden kaynaklanan artefaktları azaltır.
shape_slat_guidance_interval_startisteğe bağlı
Türnumber
Varsayılan0.6
0 – 1
2. aşamada şekil iyileştirme 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.
shape_slat_guidance_interval_endisteğe bağlı
Türnumber
Varsayılan1
0 – 1
2. aşama (şekil iyileştirme) için yönlendirme kesme noktası: shape_slat_guidance_interval_start değerine eşit veya daha büyük bir değer seçin. Değer, sınıflandırıcısız yönlendirmenin durduğu gürültü giderme kesrini belirtir.
shape_slat_sampling_stepsisteğe bağlı
Türinteger
Varsayılan12
1 – 50
Şekil iyileştirme gürültü giderme sayısı: ek adımlar kullanıldığında daha pürüzsüz geometri hız pahasına elde edilebilir.
shape_slat_rescale_tisteğe bağlı
Türnumber
Varsayılan3
1 – 6
Şekil iyileştirme gürültü zamanlamasıyla geometrik ayrıntı keskinliğini ayarlayın; bu değerin artırılması ayrıntıları keskinleştirir.
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
3. aşamada 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
3. aşama (doku) için yönlendirme kesme noktası: tex_slat_guidance_interval_start değerine eşit veya daha büyük bir değer seçin. Değer, sınıflandırıcısız yönlendirmenin durduğu gürültü giderme kesrini belirtir.
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.
decimation_targetisteğe bağlı
Türinteger
Varsayılan500000
5.000 – 2.000.000
Mesh köşe sayısı hedefi; genel kullanım için 500k, web/mobil için 20k–50k önerilir. Hedefin azaltılması mesh ayrıntısını azaltarak daha küçük dosyalar 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.
remeshisteğe bağlı
Türboolean
Varsayılantrue
Daha temiz mesh üçgenleri oluşturan topoloji yeniden oluşturma; daha yavaş işleme karşılığında animasyon veya 3D baskı gibi sonraki kullanımlara uygunluğu genellikle artırır.
remesh_bandisteğe bağlı
Türnumber
Varsayılan1
0 – 4
Yeniden mesh oluşturma hareket payı: bu değer artırıldığında ek yumuşatma ince ayrıntılardan ödün verebilir. Ayar, köşe yer değiştirmesini özgün yüzeye göre sınırlar.
remesh_projectisteğe bağlı
Türnumber
Varsayılan0
0 – 1
Yeniden mesh oluşturulan köşeleri özgün yüzeye döndürmek için projeksiyon gücü: 1 tam projeksiyonla ayrıntıyı korur, 0 ise projeksiyonu kapatarak daha yumuşak sonuç verir.
uv_unwrap_angle_threshold_degisteğe bağlı
Türnumber
Varsayılan90
0 – 180
Derece cinsinden UV chart açı sınırı; tek bir chart içindeki komşu yüz normallerinin ne kadar farklı olabileceğini sınırlar. Sınırın artırılması gerilme riskiyle daha az ve daha büyük chart'ı, azaltılması ise daha fazla chart'ı ve daha az bozulmayı tercih eder.
uv_unwrap_refine_iterationsisteğe bağlı
Türinteger
Varsayılan0
0 – 10
UV chart'larını hesaplamak için kullanılan yerel iyileştirme geçişlerinin sayısı.
uv_unwrap_global_iterationsisteğe bağlı
Türinteger
Varsayılan1
1 – 10
Chart'ları hesaplamak için kullanılan global kümeleme geçişlerinin sayısı artırılarak UV chart dengesi iyileştirilebilir.
uv_unwrap_smooth_strengthisteğe bağlı
Türnumber
Varsayılan1
0 – 10
UV chart kenarlarının ne kadar güçlü yumuşatılacağını ayarlar; daha yüksek ayarlarda daha az görünür dikişler, UV bozulması riski taşır.
image_urlgerekli image
Türurl · image
3D dönüşüm için kaynak görsele işaret eden URL.
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",
  "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"
  }
}
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.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt