Görev yaşam döngüsü
Bir görevin istekten sonuca nasıl ilerlediğini, genellikle ne kadar sürdüğünü ve kodunuzun bunun için 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 ardından arka planda çalışır ve siz bunu üç yoldan biriyle takip edersiniz: GET uç noktasını sorgulayarak, stream uç noktasını açarak veya bir webhook alarak.
PENDING durumunda bir görev başlatır. Bir worker bunu alı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 bir 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 tamamlanma yüzdesi, 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 yapın.İşlem süreleri
Aşağıdaki tablolarda, Eylül 2026'daki üretim API trafiğine dayalı medyan süreler gösterilmektedir.
Bir süre, görevin oluşturulmasından nihai duruma kadar geçen zamanı kapsar. Bunun neredeyse tamamı işlem süresidir, çü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 öncelik içeren planlardaki görevler genellikle daha erken başlar.
2 dakikanın altındaki süreler saniye (sn) cinsindendir, daha uzun süreler ise dakika (dk) cinsindendir. "Desteklenmiyor" ifadesi, API'nin bu seçeneği o 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ürebilir ve yine de başarıyla tamamlanabilir. Meshy'nin durumunu kontrol etmek için durum sayfasına bakın. Bu süreleri kodunuzda timeout 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 sn | 90 sn | 45 sn | 10 sn |
| Görselden 3D'ye | Yalnızca ağ | 75 sn | 90 sn | 40 sn | 4 sn |
| 2K dokulu ağ | 2 dk | 3 dk | 75 sn | 60 sn | |
| 4K dokulu ağ | 2,5 dk | 3,5 dk | Desteklenmiyor | 80 sn | |
| 8K dokulu ağ | 3,5 dk | 4 dk | Desteklenmiyor | 2,5 dk | |
| Çoklu görselden 3D'ye | Yalnızca ağ | 65 sn | 2 dk | 30 sn | Desteklenmiyor |
| 2K dokulu ağ | 2,5 dk | 3,5 dk | 85 sn | 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 ila 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 sn |
| 8K | 3,5 dk | |
| Yeniden dokulama | 2K | 55 sn |
| 4K | 90 sn | |
| 8K | 2,5 dk |
Görsel oluşturma
| API | nano-banana | nano-banana-2 | nano-banana-pro | GPT Image modelleri |
|---|---|---|---|---|
| Metinden görsele | 20 sn | 15 sn | 25 sn | 20 ila 35 sn |
| Görselden görsele | 40 sn | 20 sn | 30 sn | 20 ila 40 sn |
Rigging ve Animasyon
| API | Yapılandırma | Tipik süre |
|---|---|---|
| Otomatik Rigging | Otomatik rigging | 40 sn |
| Animasyon | İstek başına | 15 sn |
| Metinden Harekete | prime mode | 15 sn |
swift mode | 10 sn |
Son işleme
| API | Tipik süre |
|---|---|
| Yeniden ağ | 2 dk |
| UV açma | 35 sn |
| Dönüştür | 7 sn |
| Yeniden boyutlandır | 15 sn |
3D baskı
| API | Yapılandırma | Tipik süre |
|---|---|---|
| Basılabilirliği analiz et | Yalnızca ağ kontrolleri | 1 sn |
| Ağ ve ince duvar kontrolleri | 10 sn | |
| Çok Renkli | İstek başına | 30 sn |
| Basılabilirliği onar | Yalnızca ağ onarımı | 10 sn |
| İnce duvar kontrolü, duvarlar korunur | 20 sn | |
| İnce duvar kontrolü, duvarlar kalınlaştırılır | 100 sn | |
| Auto Split | İstek başına | 70 sn |
v2'de, Basılabilirliği onar ve Basılabilirliği analiz et her zaman ince duvar kontrolünü çalıştırır. v1'de ise bunu yalnızca bir yazıcı türü veya baskı boyutu gönderdiğinizde çalıştırırlar.
Ne kadar beklenmeli
Kodunuz beklemeyi durdursa bile görev çalışmaya devam eder. İsteğiniz timeout olursa, 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_atdeğerinden itibaren en az 60 dakika bekleyin. Daha erken durursanız, daha sonra başarıyla sonuçlanan bir görevi kaçırabilirsiniz. Bu durum genellikle 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 bir durumda değilse, 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 otomatik olarak kredi iadesi yapar.
Kodunuzda şu değerleri kullanın:
| Ayar | Önerilen değer |
|---|---|
Oluşturma isteği (POST) timeout | 60 saniye |
100 MB'den 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 |
| Sorgulama aralığı | Retry-After başlığı, eksikse 5 saniye. Sorgulamalar hız sınırınıza dahil edilir. |
Başarısız durum isteği (timeout, 429 veya 5xx) | Bir sonraki sorgulamada tekrar deneyin. Bu, görevin başarısız olduğu anlamına gelmez. |
| Görev başına toplam bekleme süresi | created_at değerinden itibaren en az 60 dakika. Bir stream'i yeniden bağladığı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 sorgulamaya geçin. |
Aynı anda birçok görev için, her birini tek tek sorgulamak yerine webhook kullanın. Bir görevin nihai olayı, tipik süresinin yaklaşık iki katı geçtikten sonra hâlâ gelmediyse, görevi GET uç noktasından alın.