Basılabilirliği Onar API'si

model_url göndermediğiniz sürece zorunludur. Modelini onarmak istediğiniz görevin kimliği; örneğin bir Görselden 3D'ye, Çoklu görselden 3D'ye, Metinden 3D'ye, Yeniden ağ, Yeniden dokulama veya Basılabilirliği analiz et görevi. Görev, API ile oluşturduğunuz, durumu SUCCEEDED olan ve bir GLB modeline sahip bir görev olmalıdır.

Duvar kalınlığını kontrol eden bir Basılabilirliği analiz et görevi, yazıcısını ve boyutunu da aktarır. Bu durumda onarım, siz hiçbirini göndermeseniz bile duvar kalınlığını kontrol eder ve ince duvarları kalınlaştırır. Göndereceğiniz bir printer_type veya baskı boyutu, analizden gelenin yerini alır. model_url üzerinden gelen bir .stl, .fbx veya .gltf dosyasına ait bir Basılabilirliği analiz et görevi çalışmaz. Bunun yerine bu dosyayı model_url olarak gönderin.

input_task_id göndermediğiniz sürece zorunludur. Onarılacak model; genel bir URL veya bir data URI olarak. İkisini de gönderirseniz Meshy input_task_id kullanır.

Bir http veya https URL'sinden, model en fazla 400 MB olan bir .glb, .gltf, .obj, .fbx veya .stl dosyası olmalıdır. Bir data URI yalnızca base64 kodlu, en fazla 100 MB olan bir GLB (data:model/gltf-binary;base64,...) veya glTF (data:model/gltf+json;base64,...) dosyası tutabilir. Bir .obj, .fbx veya .stl dosyasını http veya https URL'si olarak gönderin.

100 MB üzerindeki 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ğ, kopya başına bir kez sayılır.
• Bir FBX dosyası, ikili (binary) FBX 7.1 veya daha yeni olmalıdır.
• Bir GLB veya glTF dosyası Draco sıkıştırması kullanmamalıdır.

Bir Meshy indirme URL'si (assets.meshy.ai/…?Expires=…&Signature=…) imzalıdır ve görevinin expires_at değerinde çalışmayı durdurur. Görevi yeniden okumak bunu yenilemez. Meshy ile oluşturduğunuz bir model için bunun yerine input_task_id gönderin; bu, Meshy kaynak görevi tuttuğu sürece çalışır (bkz. Varlık saklama). Modeli bu süreden sonra kullanmak için expires_at tarihinden önce indirin ve kendi kopyanızı gönderin.

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

Kullanmayı planladığınız yazıcı. Onarımın hedeflediği minimum duvar kalınlığını belirler. printer_type olmadan bir baskı boyutu gönderirseniz, input_task_id içindeki bir Basılabilirliği analiz et görevi yazıcıyı sağlamadığı sürece Meshy fdm kullanır.

Kullanılabilir değerler:

• fdm: filament, 1,0 mm minimum duvar
• sla: reçine, 0,8 mm minimum duvar
• full_color: tam renkli, 2,0 mm minimum duvar

Başka herhangi bir değer 400 döndürür.

Baskının milimetre cinsinden yüksekliği, 1 ile 1000 arasında. Aralık dışındaki bir değer 400 döndürür. Bunu veya intended_print_longest_side_mm'yi gönderin, ikisini birden değil.

Yalnızca GLB girdisiyle çalışır. .glb dosyası olmayan bir model_url için bunun yerine intended_print_longest_side_mm gönderin.

Baskının en uzun kenarının milimetre cinsinden uzunluğu, 1 ile 1000 arasında. Aralık dışındaki bir değer 400 döndürür. Her girdi formatıyla çalışır.

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

• Eksik parametre: Ne input_task_id ne de model_url gönderildi.
• Geçersiz UUID: input_task_id geçerli bir UUID değil.
• Geçersiz model URL'si: model_url hatalı biçimlendirilmiş, desteklenmeyen bir şema kullanıyor veya desteklenmeyen bir dosya uzantısına sahip.
• Model dosyası çok büyük: model_url dosyası, bir http veya https URL'sinden 400 MB'den büyük ya da data URI olarak 100 MB'den büyük.
• Çok fazla yüz: model_url dosyası, 10.000.000'den fazla yüze sahip, 100 MB'den büyük bir GLB, glTF, FBX veya OBJ dosyası. Yüz sayısını azaltıp dosyayı yeniden gönderin.
• 100 MB'ın üzerinde ASCII FBX: model_url dosyası 100 MB'den büyük bir ASCII FBX. İkili (binary) FBX veya GLB olarak gönderin.
• Okunamayan model dosyası: model_url dosyası 100 MB'den büyük 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'den büyük ve başlığı kontrol edilemeyecek kadar çok ağ, düğüm veya kayıt içeriyor. Dosyadaki nesne sayısını azaltıp yeniden gönderin.
• Model dosyası indirilemiyor: model_url bir hata döndürdü; bu genellikle imzalı bir Meshy indirme URL'sinin süresinin dolması nedeniyle olur. Görevi yeniden okumak aynı sona erme süresine sahip aynı URL'yi döndürür. Dosyanın kendi kopyanızı gönderin veya Meshy kaynak görevi tutarken input_task_id gönderin.
• Görev başarılı değil: input_task_id görevi hâlâ bekliyor, devam ediyor veya başarısız oldu.
• GLB eksik: input_task_id görevinin onarılacak bir GLB modeli yok.
• Geçersiz baskı boyutu: intended_print_height_mm veya intended_print_longest_side_mm, 1 ile 1000 aralığının dışında, veya istek her ikisini birden içeriyor.
• Bilinmeyen yazıcı türü: printer_type, fdm, sla veya full_color değil.
• GLB olmayan bir modelde yükseklik: İstek, intended_print_height_mm ve .glb dosyası olmayan bir model_url içeriyor. Bunun yerine intended_print_longest_side_mm gönderin.
• Bu model yüksekliğe göre boyutlandırılamıyor: İstenen yükseklikte veya varsayılan 150 mm'de, modelin en uzun kenarı 1 ila 1.000 mm aralığının dışında kalır. Bu durum, model düzse veya Meshy boyutunu belirleyemiyorsa da ortaya çıkar. Bunun yerine intended_print_longest_side_mm gönderin. Bir .glb model_url'si ve bazı input_task_id görevleri için Meshy bunu yalnızca görev başladıktan sonra fark eder ve görev bunun yerine FAILED olarak sona erer.
• STL boyutu kullanılamaz: İstek, boyut belirtmeden printer_type içeriyor ve Meshy .stl dosyasının kendi en uzun kenarını okuyamıyor ya da bu değer 1 ila 1.000 mm aralığının dışında. intended_print_longest_side_mm gönderin.

İsteği düzeltip yeniden 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 edip yeniden deneyin.
• Ücretsiz plan: Bir görev oluşturmak ücretli bir plan gerektirir. Abonelik ayarlarınızdan planınızı yükseltip yeniden deneyin.

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

input_task_id görevi mevcut değil veya başka bir kullanıcıya ait. Kimliği kontrol edin ve görevi oluşturan hesaba ait bir API anahtarı kullanın.

Hız sınırınızı aştınız veya çok fazla bekleyen göreviniz var. Bekleyip yeniden deneyin. Bkz. Hız sınırları.

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

Silinecek görevin ID'si.

Döndürülecek sayfa numarası, 1'den başlar.

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

Sıralama düzeni.

Kullanılabilir değerler:

• +created_at: önce en eski
• -created_at: önce en yeni

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

Görev kimliği. Bunu opak bir dize olarak kabul edin ve biçimine güvenmeyin.

Görev türü, her zaman print-repair.

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

Görevin ne kadarının tamamlandığı, yüzde olarak. Görev başlayana kadar 0'dır ve başarılı olduğunda 100 olur.

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'dır.

Görevin bittiği zaman, Unix milisaniye cinsinden. Görev bitene kadar 0'dır.

Görevin sonucunun süresinin dolduğu zaman, Unix milisaniye cinsinden. Görev bitene kadar 0'dır.

Görev başarısız olduğunda hata ayrıntıları. Görev başarısız olmadıysa null'dur. Bkz. Hatalar.

Onarılmış model için indirme URL'leri. Yalnızca giriş biçimiyle eşleşen anahtara sahiptir. Görevin oluşturmadığı bir biçimin, boş bir dize yerine hiç anahtarı yoktur.

Onarılmış modelin önizleme görüntüsü için indirme URL'si.

thumbnail_url değerinin şeffaf 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 şeffaf önizlemeyi render ettiğinde mevcuttur.

Her zaman boş bir dizi. Onarma yalnızca girdi geometrisini korur ve texture'ları yeniden pişirmez (bake).

Görevin kullandığı kredi sayısı. Görev SUCCEEDED olduğunda 10'dur ve FAILED bir görev için 0'dır, çünkü Meshy bir görev başarısız olduğunda kredileri iade eder.

Onarımın kullandığı yazıcı ve boyut; bunları siz göndermiş olsanız da Meshy bunları bir Basılabilirliği analiz et görevinden yeniden kullanmış olsa da. Bir duvar kalınlığı onarımında, görev PENDING durumundayken bile baştan itibaren mevcuttur. Meshy'nin henüz bilmediği bir değer null'dur.

Duvar kalınlığı onarımının ne yaptığı. Bir duvar kalınlığı onarımı başarılı olduktan sonra mevcuttur.