Yeniden ağ API'si

model_url göndermediğiniz sürece zorunludur. Yeniden ağ oluşturmak istediğiniz modele sahip görevin ID'si; örneğin bir Metinden 3D'ye, Görselden 3D'ye, Yeniden dokulama veya Remesh görevi. Görev, API ile oluşturduğunuz ve durumu SUCCEEDED olan bir görev olmalıdır.

input_task_id göndermediğiniz sürece zorunludur. Yeniden ağ oluşturulacak model; genel bir URL veya bir data URI olarak. Her ikisini de gönderirseniz, Meshy input_task_id'yi kullanır.

Model, bir http veya https URL'sinden en fazla 400 MB, ya da data URI olarak en fazla 100 MB boyutunda bir GLB, glTF, OBJ, FBX veya STL dosyası olmalıdır. Data URI için application/octet-stream MIME type'ını kullanın.

100 MB'ı aşan bir dosya ayrıca şu kurallara uymalıdır:

• Bir GLB, glTF, FBX veya OBJ dosyası en fazla 10.000.000 yüze sahip olabilir. Meshy yüzleri üçgen olarak sayar, bu nedenle bir dörtgen 2 olarak sayılır ve birden fazla kez çizilen bir ağ, her kopya için bir kez sayılır.
• Bir FBX dosyası, ikili (binary) FBX 7.1 veya daha yenisi olmalıdır.
• Bir GLB veya glTF dosyası Draco sıkıştırması kullanmamalıdır.

Oluşturulacak dosya formatları.

Kullanılabilir değerler:

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

Yeniden ağ oluşturulan modelin yüz türü.

Kullanılabilir değerler:

• quad: dörtgen ağırlıklı bir ağ
• triangle: küçültülmüş (decimated) bir üçgen ağ

Hedeflenen yüz sayısı, 100 ile 300000 arasında. Sonuç, modelin geometrisine bağlı olarak hedeften farklı olabilir. Aralık dışındaki bir değer 400 döndürür.

Seviyeye göre uyarlanabilir yüz sayısı. Bunu ayarladığınızda Meshy target_polycount'u yok sayar.

Kullanılabilir değerler:

• 1: ultra
• 2: yüksek
• 3: orta
• 4: düşük

Bunun yerine Resize API kullanın. Modelin yeniden boyutlandırılacağı yükseklik, metre cinsinden. resize_height, resize_longest_side ve auto_size'dan en fazla birini gönderin.

Bunun yerine Resize API kullanın. Modelin sınırlayıcı kutusunun en uzun kenarının yeniden boyutlandırılacağı uzunluk, metre cinsinden. resize_height, resize_longest_side ve auto_size'dan en fazla birini gönderin.

Bunun yerine Resize API kullanın. Nesnenin gerçek dünyadaki yüksekliğinin AI görüşüyle tahmin edilip modelin buna göre yeniden boyutlandırılıp boyutlandırılmayacağı. resize_height, resize_longest_side ve auto_size'dan en fazla birini gönderin.

Bunun yerine Resize API kullanın. Modelin orijininin nereye konulacağı, bottom veya center. Varsayılan değer, resize_height, resize_longest_side veya auto_size gönderdiğinizde uygulanır. Bunlardan biri olmadan, Meshy orijini yalnızca origin_at gönderirseniz taşır.

Bunun yerine Convert API kullanın. Modelin yalnızca target_formats'a dönüştürülüp dönüştürülmeyeceği. true olduğunda Meshy topology, target_polycount, decimation_mode, resize_height, resize_longest_side ve auto_size'ı yok sayar, ancak yine de değerlerini kontrol eder, bu nedenle geçersiz bir değer 400 döndürür. convert_format_only: true ile boş veya null bir target_formats değeri 400 döndürür.

Görevi aldığınızda alpha_thumbnail_url içinde döndürülen, şeffaf arka planlı (RGBA) bir önizlemenin de oluşturulup oluşturulmayacağı. thumbnail_url değişmez.

İstek çalıştırılamıyor. Hata mesajı hangi sorunu bulduğunu belirtir. Örneğin:

• Eksik parametre: Ne model_url ne de input_task_id gönderildi.
• Geçersiz giriş görevi: input_task_id başarılı bir API görevi değil veya AI modeli yeniden ağ oluşturmayı desteklemiyor.
• Geçersiz model formatı: model_url dosyasının desteklenmeyen bir uzantısı var.
• Erişilemeyen URL: Meshy model_url dosyasını indiremiyor.
• Model dosyası çok büyük: model_url dosyası, bir http veya https URL'sinden 400 MB'ın üzerinde, ya da data URI olarak 100 MB'ın üzerinde.
• Çok fazla yüz: model_url dosyası 100 MB'ın üzerinde ve 10.000.000'dan fazla yüze sahip. Yüz sayısını azaltın, sonra dosyayı tekrar gönderin.
• 100 MB üzeri ASCII FBX: model_url dosyası 100 MB'ın üzerinde bir ASCII FBX. Bunu ikili (binary) FBX veya GLB olarak gönderin.
• Okunamayan model dosyası: model_url dosyası 100 MB'ın üzerinde ve Meshy başlığını okuyamıyor. Örneğin, Draco sıkıştırmalı bir GLB veya glTF, ya da 7.1'den eski bir ikili FBX.
• Model başlığı çok karmaşık: model_url dosyası 100 MB'ın üzerinde ve başlığında kontrol edilecek çok fazla ağ, düğüm veya kayıt var. Dosyadaki nesne sayısını azaltın, sonra tekrar gönderin.
• Geçersiz topology: topology, quad veya triangle değil.
• Birbirini dışlayan parametreler: İstekte auto_size, resize_height ve resize_longest_side'dan birden fazlası var. Yalnızca birini gönderin.

İsteği düzeltin, sonra tekrar gönderin. Bkz. Hatalar.

API anahtarı eksik veya geçersiz. Authorization başlığını kontrol edin.

Örneğin:

• Yetersiz kredi: Hesapta bu görev için yeterli kredi yok, veya hesap bir kredi sınırına ulaştı. Kredi bakiyenizi kontrol edin, sonra tekrar deneyin.
• Ücretsiz plan: Görev oluşturmak ücretli bir plan gerektirir. abonelik ayarlarınızdan planınızı yükseltin, sonra tekrar deneyin.

input_task_id, bu uç noktanın yeniden ağ oluşturamadığı bir kabartma (bas-relief) modeli. Mesaj This model type does not support this operation şeklindedir. Farklı bir model gönderin.

input_task_id, görevlerinizden hiçbiriyle eşleşmiyor. Görev ID'sini kontrol edin, sonra isteği tekrar gönderin.

Hız sınırınızı aştınız. Bekleyin, sonra tekrar deneyin. Bkz. Hız sınırları.

Oluşturma yanıtından alınan görev kimliği.

Silinecek görevin kimliği.

Döndürülecek sayfa numarası, en fazla 255. Daha büyük bir değer 400 döndürür.

Sayfa başına görev sayısı, en fazla 100.

Sıralama düzeni.

Kullanılabilir değerler:

• +created_at: en eskiden en yeniye
• -created_at: en yeniden en eskiye

Oluşturma yanıtından alınan görev ID'si.

Görev kimliği. Bunu anlamsız bir dize olarak değerlendirin ve biçimine güvenmeyin.

Görev türü, her zaman remesh.

Yeniden ağı oluşturulmuş model için indirme URL'leri, her dosya biçimi için bir tane. Görevin oluşturmadığı bir biçimin, boş bir dize yerine hiç anahtarı yoktur.

Yeniden ağı oluşturulmuş modelin önizleme görseli için indirme URL'si.

thumbnail_url adresinin saydam arka planlı (RGBA) bir sürümü için indirme URL'si. Yalnızca görevi alpha_thumbnail: true ile oluşturduğunuzda ve Meshy saydam önizlemeyi render ettiğinde mevcuttur.

Görevin ne kadarının tamamlandığı, yüzde olarak. Görev başlayana kadar 0, başarılı olduğunda 100 değerindedir.

Görev durumu, PENDING, IN_PROGRESS, SUCCEEDED, FAILED veya CANCELED değerlerinden biri.

Kuyrukta bu görevden önce gelen görev sayısı. Bu değer yalnızca görev PENDING durumundayken anlamlıdır.

Görevin oluşturulduğu zaman, Unix milisaniye cinsinden.

Görevin başladığı zaman, Unix milisaniye cinsinden. Görev başlayana kadar 0 değerindedir.

Görevin bittiği zaman, Unix milisaniye cinsinden. Görev bitene kadar 0 değerindedir.

Görevin indirme URL'lerinin süresinin dolduğu zaman, Unix milisaniye cinsinden. Görev bitene kadar 0 değerindedir.

Görev başarılı olduğunda, modelin doku haritaları için indirme URL'leri: her doku seti için bir tane olmak üzere nesnelerden oluşan bir dizi. Her nesnede bir base_color URL'si bulunur ve ayrıca metallic, roughness, normal, emission ve metallic_roughness URL'leri de bulunabilir. Görev başarılı olana kadar null değerindedir ve modelin doku haritası yoksa boş bir dizidir.

Görev başarısız olduğunda hata ayrıntıları. Bkz. Hatalar.

Görevin kullandığı kredi sayısı. Durum PENDING, IN_PROGRESS veya SUCCEEDED olduğunda mevcuttur. FAILED bir görev için 0 değerindedir, çünkü Meshy bir görev başarısız olduğunda kredileri iade eder.