Meshy API üzerinden 3D varlıklar oluşturduğunuzda, her görev sonucu geçici olarak Meshy'nin sunucularında saklanır. Saklama süresini anlamak entegrasyonunuzu planlamanıza yardımcı olur ve çıktıları süresi dolmadan önce indirmenizi sağlar.
Görev Türüne Göre Varlık Saklama
Saklama süreleri görev türüne göre değişir:
Görev Türü | Saklama Süresi |
Metinden 3D'ye | Görev tamamlandıktan 3 gün sonra |
Görselden 3D'ye | Görev tamamlandıktan 3 gün sonra |
Rigging | Görev tamamlandıktan 2 ay sonra |
Metinden 3D'ye ve Görselden 3D'ye
Görevler ve çıktıları — model dosyaları, önizleme görselleri ve dokular — görevin tamamlandığı andan itibaren 3 gün boyunca saklanır. Bu süreden sonra göreve ve ilişkili tüm indirme URL'lerine erişilemez.
Her API görev yanıtı, görevin tam olarak ne zaman silineceğini belirten bir expires_at alanı (milisaniye cinsinden Unix zaman damgası) içerir:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Bu değeri entegrasyonunuzda izleyin ve süresi dolmadan önce indirmeleri tetikleyin.
Rigging Görevleri
Rigging görevleri tamamlandıktan sonra 2 ay boyunca saklanır. Bu genişletilmiş süre, orijinal rig görev kimliğini kullanarak aynı rig'lenmiş karaktere yeni animasyonlar eklemeye devam etmenize olanak tanır — mesh'i yeniden rig'lemek zorunda kalmadan.
Mevcut bir rig'e animasyon eklemek için, 2 aylık saklama süresi içinde herhangi bir noktada animasyon isteğinizde rig görev kimliğine referans verin.
Varlıklarınıza Erişme
API ile oluşturulan varlıklara süreleri dolmadan önce erişmek için:
Hemen indirin. Bir görev
SUCCEEDEDdurumuna ulaştığı anda çıktı dosyalarını (GLB, FBX, OBJ vb.) kendi depolama alanınıza indirin.Görev listeleme uç noktasını kullanın. Metinden 3D'ye veya Görselden 3D'ye listeleme API uç noktaları aracılığıyla son görev kimliklerini ve çıktı URL'lerini alın.
SSS
1.API ile oluşturduğum model neden çalışma alanımda görünmüyor?
Bu beklenen bir davranıştır. API ile oluşturulan varlıklar Meshy Çalışma Alanı arayüzünde görünmez. Bu tasarım gereğidir — API ve Çalışma Alanı, farklı son kullanma kurallarına sahip ayrı varlık yaşam döngülerine sahiptir.
2.Görev URL'lerim neden 404 döndürüyor?
Görevin expires_at zaman damgası geçtiyse, varlık Meshy'nin sunucularından silinmiştir. Oluşturma görevini yeniden göndermeniz gerekecektir. Bundan kaçınmak için, görevler başarılı olur olmaz kendi depolama alanınıza otomatik indirmeler kurun.
3.Rig görevinin süresi dolduktan sonra bir karaktere yeni animasyonlar ekleyebilir miyim?
Rigging görevleri 2 ay boyunca kullanılabilir, bu da animasyon eklemeye devam etmeniz için geniş bir süre tanır. Rig görevinin süresi dolduysa (2 aydan eskiyse), orijinal mesh'i yeniden rig'lemeniz gerekecektir.
Not: Meshy, ayrı rigging işlemleri arasında iskelet uyumluluğunu garanti etmez.