lowpoly 30 Eki 2026 tarihinde kaldırılıyor. 3D oluşturma modeli olarak meshy-7 31 Ara 2026 tarihinde kaldırılıyor; doku modeli olarak kullanılmaya devam ediyor. İstek hatalarını önlemek için bu tarihlerden önce model değiştirin. Tüm kullanımdan kaldırmaları görün

Görev yaşam döngüsü

Bir görevin istekten sonuca nasıl ilerlediğini, genellikle ne kadar sürdüğünü ve kodunuzun bunu ne kadar beklemesi gerektiğini öğrenin.


Bir görev nasıl çalışır

Bir oluşturma isteği, görevin çalışmasını beklemeden bir görev kimliği döndürür. Görev daha sonra arka planda çalışır ve siz onu üç yoldan biriyle takip edersiniz: GET uç noktasını yoklamak, stream uç noktasını açmak veya bir webhook almak.

Bir oluşturma isteği, görevi PENDING durumunda başlatır. Bir worker görevi devralır ve görev, çoğu zamanını geçirdiği IN_PROGRESS durumuna geçer. Görev SUCCEEDED veya FAILED ile sona erer ve nihai durum bir daha değişmez.
Oluşturma isteği
PENDING
Kuyrukta bekliyor
IN_PROGRESS
Sonuç oluşturuluyor
SUCCEEDED
Sonucu indir
FAILED
Kredi iade edildi

Görev, her adımı created_at, started_at ve finished_at alanlarına kaydeder.

Aşağıdaki tabloda, kodunuzun her durumda ne yapması gerektiği gösterilmektedir.

DurumKodunuzun ne yapması gerekir
PENDINGBeklemeye devam edin.
IN_PROGRESSprogress alanını takip edin: işin yüzde kaçının tamamlandığını gösterir, 0 ile 100 arasında.
SUCCEEDEDSonucu indirin. Meshy dosyaları sınırlı bir süre boyunca saklar. Bkz. Varlık saklama.
FAILEDtask_error alanını okuyun, ardından girdiyi düzeltin veya yeni bir görev oluşturun. Bkz. Hatalar.
CANCELEDBeklemeyi durdurun. Görev bir sonuç üretmeyecektir. Bu durumu yalnızca Creative Lab görevleri kullanır.

SUCCEEDED, FAILED ve CANCELED nihai durumlardır. Bir görev bunlardan birine ulaştıktan sonra durumu bir daha değişmez.

Kodunuzdan bakıldığında bu şöyle görünür:

Bir görev oluşturun, ardından tamamlanana kadar yoklayın.
  1. İstek: POST/image-to-3d

  2. Yanıt: 202{ "result": "<task_id>" }görev oluşturuldu

  3. Her birkaç saniyede bir tekrarlayın
    1. İstek: GET/image-to-3d/<task_id>

    2. Yanıt: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5

  4. İstek: GET/image-to-3d/<task_id>

  5. Yanıt: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }

Uygulamanız beklemeyi durdurursa görev çalışmaya devam eder. Daha sonra aynı görev kimliğiyle GET isteği gönderin.

İşlem süreleri

Aşağıdaki tablolarda, Eylül 2026'daki üretim API trafiğine ait medyan süreler gösterilmektedir.

Bir süre, görevin oluşturulmasından nihai duruma kadar olan zamanı kapsar. Bunun neredeyse tamamı işlemedir, çünkü bir görev genellikle yalnızca birkaç saniye PENDING durumunda kalır. Kuyruk yoğun olduğunda görevler başlamadan önce daha uzun bekleyebilir ve daha yüksek önceliğe sahip planlardaki görevler genellikle daha erken başlar.

2 dakikanın altındaki süreler saniye (s) cinsinden, daha uzun süreler dakika (min) cinsindendir. Desteklenmiyor, API'nin bu seçeneği ilgili modelle sunmadığı anlamına gelir.

3D oluşturma

APIYapılandırmameshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
Metinden 3D'ye (Preview)Yalnızca ağ75 s90 s45 s10 s
Görselden 3D'yeYalnızca ağ75 s90 s40 s4 s
2K dokulu ağ2 dk3 dk75 s60 s
4K dokulu ağ2,5 dk3,5 dkDesteklenmiyor80 s
8K dokulu ağ3,5 dk4 dkDesteklenmiyor2,5 dk
Çoklu görselden 3D'yeYalnızca ağ65 s2 dk30 sDesteklenmiyor
2K dokulu ağ2,5 dk3,5 dk85 sDesteklenmiyor
4K dokulu ağ3 dk4 dkDesteklenmiyorDesteklenmiyor
8K dokulu ağ3,5 dk4,5 dkDesteklenmiyorDesteklenmiyor

Görselden 3D'ye ve Çoklu görselden 3D'ye için "Yalnızca ağ", should_texture: false anlamına gelir. Aşağıdaki seçenekler ve girdiler süreyi değiştirir:

  • PBR haritaları (enable_pbr) 30 ile 60 saniye ekler.
  • Ultra geometri (geometry_resolution: "2k" veya "4k") en fazla 1 dakika ekler.
  • Aynı ayarlarla, daha karmaşık girdi görselleri daha uzun sürer.

Dokulama

APIDoku çözünürlüğüTipik süre
Metinden 3D'ye (Refine)2K veya 4K80 s
8K3,5 dk
Yeniden dokulama2K55 s
4K90 s
8K2,5 dk

Görsel oluşturma

APInano-banananano-banana-2nano-banana-proGPT Image modelleri
Metinden görsele20 s15 s25 s20 ile 35 s
Görselden görsele40 s20 s30 s20 ile 40 s

Rigging ve Animasyon

APIYapılandırmaTipik süre
Otomatik RiggingOtomatik rigging40 s
Animasyonİstek başına15 s
Metinden Hareketеprime mode15 s
swift mode10 s

Son işleme

3D baskı

APIYapılandırmaTipik süre
Basılabilirliği analiz etYalnızca ağ kontrolleri1 s
Ağ ve ince duvar kontrolleri10 s
Multi-Colorİstek başına30 s
Basılabilirliği onarYalnızca ağ onarımı10 s
İnce duvar kontrolü, duvarlar korunur20 s
İnce duvar kontrolü, duvarlar kalınlaştırılır100 s
Auto SplitDüz renkli parçalar70 s
Dokulu parçalar (keep_texture: true)170 s

v2'de, Basılabilirliği onar ve Basılabilirliği analiz et işlemleri her zaman ince duvar kontrolünü çalıştırır. v1'de bu kontrol, bir yazıcı türü veya baskı boyutu gönderdiğinizde çalışır.


Ne kadar beklenmeli

Kodunuz beklemeyi durdursa bile görev çalışmaya devam eder. İsteğinizde timeout oluşursa, bağlantınız kesilirse veya stream'iniz kapanırsa görev başarısız olmaz ve iptal edilmez.

  • Beklemeyi durdurmadan önce, görevin created_at alanından itibaren sayarak en az 60 dakika bekleyin. Daha erken durursanız, daha sonra başarıyla tamamlanan bir görevi kaçırabilirsiniz. Bu durum çoğunlukla yoğun dönemlerde yaşanır.
  • Görev kimliğini saklayın. Görevi istediğiniz zaman tekrar alabilirsiniz. 60 dakika sonra hâlâ nihai duruma ulaşmadıysa daha sonra tekrar kontrol edin. Durum böyle devam ederse destek ekibiyle iletişime geçin.
  • Yalnızca FAILED durumu görevin başarısız olduğu anlamına gelir. Meshy, başarısız görevler için kredileri otomatik olarak iade eder.

Kodunuzda şu değerleri kullanın:

AyarÖnerilen değer
Oluşturma isteği (POST) timeout60 saniye
100 MB'tan büyük bir model_url dosyası içeren oluşturma isteği (POST) timeout120 saniye. Meshy yanıt vermeden önce dosyayı indirir.
Durum isteği (GET) timeout30 saniye
Yoklama aralığıRetry-After başlığı, yoksa 5 saniye. Yoklamalar hız sınırınıza dahildir.
Başarısız durum isteği (timeout, 429 veya 5xx)Bir sonraki yoklamada tekrar deneyin. Bu, görevin başarısız olduğu anlamına gelmez.
Görev başına toplam beklemecreated_at'ten itibaren en az 60 dakika. Bir stream'e yeniden bağlandığınızda bu sayacı yeniden başlatmayın.
StreamBir stream, görev tamamlanmadan önce kapanabilir. Nihai bir durum olmadan kapanırsa, yeniden bağlanın veya yoklamaya geçin.

Aynı anda birçok görev için, her birini tek tek yoklamak yerine webhook kullanın. Bir görevin nihai olayı, tipik süresinin yaklaşık iki katından sonra hâlâ gelmediyse, görevi GET uç noktasından alın.