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.
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.PENDINGIN_PROGRESSSUCCEEDEDFAILEDGö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.
| Durum | Kodunuzun ne yapması gerekir |
|---|---|
PENDING | Beklemeye devam edin. |
IN_PROGRESS | progress alanını takip edin: işin yüzde kaçının tamamlandığını gösterir, 0 ile 100 arasında. |
SUCCEEDED | Sonucu indirin. Meshy dosyaları sınırlı bir süre boyunca saklar. Bkz. Varlık saklama. |
FAILED | task_error alanını okuyun, ardından girdiyi düzeltin veya yeni bir görev oluşturun. Bkz. Hatalar. |
CANCELED | Beklemeyi 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:
İstek: POST/image-to-3d
Yanıt: 202{ "result": "<task_id>" }görev oluşturuldu
- Her birkaç saniyede bir tekrarlayın
İstek: GET/image-to-3d/<task_id>
Yanıt: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5
İstek: GET/image-to-3d/<task_id>
Yanıt: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }
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.
Bunlar tipik sürelerdir, garanti edilen tamamlanma süreleri değildir. Yoğun dönemlerde bazı görevler daha uzun sürer ve yine de başarıyla tamamlanır. Meshy'nin durumunu kontrol etmek için durum sayfasına bakın. Bu süreleri kodunuzda timeout değeri olarak kullanmayın. Timeout değerleri için bkz. Ne kadar beklenmeli.
3D oluşturma
| API | Yapılandırma | meshy-7.1 (latest) | meshy-6 | meshy-6-lite | meshy-t2 |
|---|---|---|---|---|---|
| Metinden 3D'ye (Preview) | Yalnızca ağ | 75 s | 90 s | 45 s | 10 s |
| Görselden 3D'ye | Yalnızca ağ | 75 s | 90 s | 40 s | 4 s |
| 2K dokulu ağ | 2 dk | 3 dk | 75 s | 60 s | |
| 4K dokulu ağ | 2,5 dk | 3,5 dk | Desteklenmiyor | 80 s | |
| 8K dokulu ağ | 3,5 dk | 4 dk | Desteklenmiyor | 2,5 dk | |
| Çoklu görselden 3D'ye | Yalnızca ağ | 65 s | 2 dk | 30 s | Desteklenmiyor |
| 2K dokulu ağ | 2,5 dk | 3,5 dk | 85 s | Desteklenmiyor | |
| 4K dokulu ağ | 3 dk | 4 dk | Desteklenmiyor | Desteklenmiyor | |
| 8K dokulu ağ | 3,5 dk | 4,5 dk | Desteklenmiyor | Desteklenmiyor |
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
| API | Doku çözünürlüğü | Tipik süre |
|---|---|---|
| Metinden 3D'ye (Refine) | 2K veya 4K | 80 s |
| 8K | 3,5 dk | |
| Yeniden dokulama | 2K | 55 s |
| 4K | 90 s | |
| 8K | 2,5 dk |
Görsel oluşturma
| API | nano-banana | nano-banana-2 | nano-banana-pro | GPT Image modelleri |
|---|---|---|---|---|
| Metinden görsele | 20 s | 15 s | 25 s | 20 ile 35 s |
| Görselden görsele | 40 s | 20 s | 30 s | 20 ile 40 s |
Rigging ve Animasyon
| API | Yapılandırma | Tipik süre |
|---|---|---|
| Otomatik Rigging | Otomatik rigging | 40 s |
| Animasyon | İstek başına | 15 s |
| Metinden Hareketе | prime mode | 15 s |
swift mode | 10 s |
Son işleme
| API | Tipik süre |
|---|---|
| Yeniden ağ | 2 dk |
| UV açma | 35 s |
| Dönüştür | 7 s |
| Yeniden boyutlandır | 15 s |
3D baskı
| API | Yapılandırma | Tipik süre |
|---|---|---|
| Basılabilirliği analiz et | Yalnızca ağ kontrolleri | 1 s |
| Ağ ve ince duvar kontrolleri | 10 s | |
| Multi-Color | İstek başına | 30 s |
| Basılabilirliği onar | Yalnızca ağ onarımı | 10 s |
| İnce duvar kontrolü, duvarlar korunur | 20 s | |
| İnce duvar kontrolü, duvarlar kalınlaştırılır | 100 s | |
| Auto Split | Düz renkli parçalar | 70 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_atalanı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
FAILEDdurumu 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) timeout | 60 saniye |
100 MB'tan büyük bir model_url dosyası içeren oluşturma isteği (POST) timeout | 120 saniye. Meshy yanıt vermeden önce dosyayı indirir. |
Durum isteği (GET) timeout | 30 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 bekleme | created_at'ten itibaren en az 60 dakika. Bir stream'e yeniden bağlandığınızda bu sayacı yeniden başlatmayın. |
| Stream | Bir 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.