Creative Lab Fidget Pixel API

Piksel sanatına dönüştürülecek fotoğraf; herkese açık bir URL veya bir data URI (data:image/jpeg;base64,<base64 ile kodlanmış görsel verileriniz>) olarak.

Görsel, en fazla 20 MB boyutunda bir JPG, JPEG, PNG veya WebP dosyası olmalıdır. Meshy, biçimi URL'deki dosya uzantısından değil, görsel verilerinden algılar. Uzantısız bir URL çalışır ve Meshy yönlendirmeleri takip eder.

Fotoğrafın neyi gösterdiği, piksel sanatı stilini belirler. İki stil birbirinden belirgin şekilde farklıdır. Başka herhangi bir değer 400 döndürür.

Kullanılabilir değerler:

• person: bir kişi, portre veya tam boy fotoğrafta. Meshy, chibi tarzında bir piksel sprite çizer.
• other: diğer herhangi bir konu, örneğin bir evcil hayvan, bir nesne, bir maskot, bir logo veya bir manzara. Meshy, boncuk sanatı tarzında bir piksel simgesi çizer.

Görev için en fazla 100 karakterlik bir ad. Bu ad, görevin name alanında geri döner. Daha uzun bir ad 400 döndürür.

İstek çalıştırılamıyor. Örneğin:

• image_url veya type eksik.
• type, person veya other değil.
• Görsel bir JPG, JPEG, PNG veya WebP dosyası değil.
• Görsel çok küçük, 20 MB'ı aşıyor veya maksimum piksel sayısını aşıyor.
• Meshy görseli indiremiyor, örneğin URL 404 döndürdüğü veya zaman aşımına uğradığı için.
• Data URI geçerli bir base64 değil.
• Görsel, müstehcen (NSFW) olarak işaretlendi.

Hata mesajı hangi sorunu bulduğunu belirtir. İsteği düzeltin, ardından yeniden gönderin.

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

Aşağıdakilerden biri geçerlidir:

• Hesapta yeterli kredi yok.
• API anahtarı, çalışma alanı veya üye kredi sınırına ulaştı.
• Hesap ücretsiz plandadır.

Kredilerinizi ve planınızı kontrol edin, ardından yeniden deneyin.

Ekibinizde IP Filtering açık ve Meshy, görseli üçüncü taraf fikri mülkiyeti nedeniyle işaretledi. Kullanma hakkına sahip olduğunuz bir görsel gönderin.

Şu sınırlardan biri aşıldı:

• Hız sınırınızın izin verdiğinden daha fazla istek gönderdiniz. Birkaç saniye bekleyin, ardından yeniden deneyin. Bkz. Hız sınırları.
• Görevlerinizin çok fazlası kuyrukta veya çalışıyor. Bazılarının bitmesini bekleyin, ardından yeniden deneyin.
• Kredisi kalmayan sınırsız bir planda, kredisiz çalıştırılabilecek görev sayısına ulaştınız. Bir görevin bitmesini bekleyin veya kredi ekleyin.

Meshy bir sunucu hatasıyla karşılaştı, örneğin görsel üzerinde fikri mülkiyet denetimini çalıştıramadığı için. Meshy görevi oluşturmaz ve tahsil ettiği tüm kredileri iade eder. İsteği yeniden deneyin.

Oluşturulacak prototip görevinin kimliği. POST /openapi/creative-lab/fidget-pixel/v1/prototype ile hesabınızın oluşturduğu, durumu SUCCEEDED olan bir görev olmalıdır.

API üzerinden oluşturduğunuz Fidget Pixel prototip görevlerinden biri olmayan bir kimlik, web uygulamasında oluşturulmuş bir prototip de dahil olmak üzere 404 döndürür.

Görev için en fazla 100 karakterlik bir ad. Görevin name alanında geri döner. Daha uzun bir ad 400 döndürür.

Her parçanın taban şekli. Başka herhangi bir değer 400 döndürür.

Kullanılabilir değerler:

• square: kare bir ızgara üzerinde kare parçalar
• hex: piece_size_mm değeri 6 veya 8 olarak ayarlanmış, altıgen bir ızgara üzerinde altıgen parçalar

Panonun her bir kenarı boyunca ızgara hücrelerinin sayısı, 16 veya 32. Başka herhangi bir değer 400 döndürür. 32 ızgara daha fazla ayrıntı korur. 16 ızgara, aynı boyutta daha az parça verir, bu nedenle pano yaklaşık olarak yarı genişlikte olur.

Her parçanın milimetre cinsinden kenar uzunluğu, 6, 8 veya 10. Başka herhangi bir değer 400 döndürür. grid_size ile birlikte, basılan panonun boyutunu belirler. Örneğin, 8 mm'lik parçalardan oluşan bir 32 ızgara, kenar başına yaklaşık 26,5 cm'dir.

10, hex ile çalışmaz ve 400 döndürür, çünkü eğik altıgen yüzü çoğu tüketici FDM yazıcısında çıkıntı yapar.

Piksel-art paletindeki maksimum renk sayısı, 1 ile 8 arasında. Aralık dışındaki bir değer 400 döndürür. Baskı yapmak için, biri her renk için biri de gri gövdeler için olmak üzere color_count artı bir filamente kadar ihtiyacınız vardır.

Her parçanın milimetre cinsinden yüksekliği, 10 ile 80 arasında. Aralık dışındaki bir değer 400 döndürür.

Sonucun dosya biçimi. Başka herhangi bir değer 400 döndürür.

Kullanılabilir değerler:

• 3mf: model_urls.3mf içinde döndürülen, çok renkli tek bir model.3mf dosyası

İstek çalıştırılamıyor. Örneğin:

• input_task_id eksik veya geçerli bir görev kimliği değil.
• Prototip görevinin durumu SUCCEEDED değil. Hâlâ çalışıyorsa bekleyip yeniden deneyin. Başarısız olduysa veya iptal edildiyse yeni bir prototip görevi oluşturun.
• Prototip görevi başarılı oldu ancak bir görseli yok. Yeni bir prototip görevi oluşturun.
• Bir options alanı izin verilen değerlerin dışında, örneğin 16 veya 32 dışında bir grid_size.
• piece_size_mm değeri 10 ve shape değeri hex. Altıgen parçalar yalnızca 6 ve 8 mm olarak gelir.
• output.format değeri 3mf değil.

Hata mesajı hangi sorunu bulduğunu belirtir.

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

Bunlardan biri geçerlidir:

• Hesapta yeterli kredi yok.
• API anahtarı, çalışma alanı veya üye kredi limitine ulaştı.
• Hesap ücretsiz plandadır.

Kredilerinizi ve planınızı kontrol edip yeniden deneyin.

Ekibinizde IP Filtering açık ve Meshy, prototip görevinin görselini üçüncü taraf fikri mülkiyeti nedeniyle işaretledi. Kullanım haklarına sahip olduğunuz bir görselden bir prototip görevi oluşturun.

input_task_id, hesabınızın API ile oluşturduğu herhangi bir Fidget Pixel prototip göreviyle eşleşmiyor. Web uygulamasında oluşturulmuş bir prototip de 404 döndürür. Bir prototip oluşturma yanıtından gelen result kimliğini gönderin.

Şu sınırlardan biri aşıldı:

• Hız sınırınızın izin verdiğinden daha fazla istek gönderdiniz. Birkaç saniye bekleyip yeniden deneyin. Bkz. Rate limits.
• Çok fazla göreviniz sırada bekliyor veya çalışıyor. Bazılarının tamamlanmasını bekleyip yeniden deneyin.
• Kredisi kalmamış sınırsız bir planda, kredisiz çalıştırılabilecek görev sayısına ulaştınız. Bir görevin tamamlanmasını bekleyin veya kredi ekleyin.

Meshy bir sunucu hatasıyla karşılaştı, örneğin prototip görevinin görseli üzerinde fikri mülkiyet denetimini çalıştıramadığı için. Meshy görevi oluşturmaz ve tahsil ettiği kredileri iade eder. İsteği yeniden deneyin.

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

id geçerli bir görev ID'si değil. Oluşturma yanıtındaki result ID'sini gönderin.

Ekibinizde IP Filtering özelliği etkin ve Meshy, prototip görevinin görselini üçüncü taraf fikri mülkiyeti açısından işaretledi. Build görevleri ve Enterprise plandaki ekipler bu hatayı almaz. Kullanım haklarına sahip olduğunuz bir görselden prototip görevi oluşturun.

Bu ID'ye sahip bir Fidget Pixel görevi hesabınıza ait değil veya görevin aşaması yol ile eşleşmiyor. ID'yi kontrol edin ve görevle eşleşmesi için /prototype veya /build kullanın.

Meshy, fikri mülkiyet kontrolünü çalıştıramadı. İsteği yeniden deneyin.

İptal edilecek görevin ID'si.

Aşağıdakilerden biri geçerlidir:

• id geçerli bir görev ID'si değil. Oluşturma yanıtındaki result ID'sini gönderin.
• Görev zaten nihai bir durumda (SUCCEEDED, FAILED veya CANCELED), bu nedenle iptal edilemez.

Bu ID'ye sahip bir Fidget Pixel görevi hesabınıza ait değil veya görevin aşaması yol ile eşleşmiyor. ID'yi kontrol edin ve görevle eşleşmesi için /prototype veya /build kullanın.

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

Listelenecek aşama, prototype veya build.

Döndürülecek sayfa, 1 ile 255 arasında. 0 ilk sayfayı döndürür. 0 ile 255 dışındaki bir değer 400 döndürür.

Sayfa başına görev sayısı, en fazla 100. 101 ile 255 arasındaki bir değer 100 görev döndürür ve 0 varsayılanı kullanır. 0 ile 255 dışındaki bir değer 400 döndürür.

Sıralama düzeni.

Kullanılabilir değerler:

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

Görev ID'si. Biçimine güvenmeyin.

Görev türü, her zaman creative-lab-fidget-pixel-prototype.

Görevi oluştururken gönderdiğiniz name, göndermediyseniz "".

Görevin durumu.

Kullanılabilir değerler:

• PENDING: kuyrukta bekliyor
• IN_PROGRESS: sonucu üretiyor
• SUCCEEDED: nihai, sonuçla birlikte
• FAILED: nihai, sebebi task_error içinde
• CANCELED: nihai, sonuç yok

Tamamlanan işin yüzdesi, 0 ile 100 arasında. Görev başlayana kadar 0, başarılı olduğunda 100 olur.

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

Bir çalışanın görevi başlattığı zaman, Unix milisaniye cinsinden. O zamana kadar null.

Görevin nihai bir duruma ulaştığı zaman, Unix milisaniye cinsinden. O zamana kadar null.

Görevin sonucunun süresinin dolduğu zaman, Unix milisaniye cinsinden. Bu, finished_at'ten 3 gün sonra, görev bitene kadar ise created_at'ten 3 gün sonrasıdır. API sonuçlarını süresiz olarak saklayan Enterprise hesapları için bu süre yaklaşık 100 yıl sonrasıdır. Bkz. Varlık saklama.

Görev PENDING durumundayken kuyruktaki konumu. 1, sıradaki görev olduğu anlamına gelir. Görev kuyruktan çıktıktan sonra 0'dır ve liste sonuçlarında her zaman 0'dır.

Görevin neden başarısız olduğu. status değeri FAILED olmadığı sürece null. Bkz. Hatalar.

Herhangi bir geri ödemeden sonra görev için tahsil edilen kredi sayısı. Hata döndüren bir istekten ücret alınmaz. Başarısız bir görev 0'dır, çünkü Meshy bunu geri öder. İptal etme, bir görevi yalnızca PENDING durumundayken geri öder. Meshy ücreti okuyamazsa, bir get veya stream yanıtı bu alanı dışarıda bırakır ve bir liste isteği 500 döndürür. Bu durumda, isteği tekrar deneyin.

Piksel-sanat görüntüsü için indirme URL'leri. Görev başarılı olduktan sonra dizi bir URL içerir, o zamana kadar boştur.

URL'ler imzalıdır, bu yüzden bunları bir Authorization başlığı olmadan alın. expires_at'e kadar geçerli kalırlar. Görevi o zamandan önce tekrar almak, yeniden imzalanmış değil, aynı URL'leri döndürür. Süresi dolmuş bir URL yenilenemez, bu yüzden dosyaları o zamandan önce indirip saklayın.

Görev kimliği. Biçimine güvenmeyin.

Görev türü, her zaman creative-lab-fidget-pixel-build.

Görevi oluştururken gönderdiğiniz name değeri, göndermediyseniz "".

Görevin durumu.

Kullanılabilir değerler:

• PENDING: kuyrukta bekliyor
• IN_PROGRESS: sonucu oluşturuyor
• SUCCEEDED: nihai durum, sonuçla birlikte
• FAILED: nihai durum, nedeni task_error içinde
• CANCELED: nihai durum, sonuç yok

Tamamlanan işin yüzdesi, 0 ile 100 arasında. Görev başlayana kadar 0, başarılı olduğunda 100 olur.

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

Bir çalışanın göreve başladığı zaman, Unix milisaniye cinsinden. O ana kadar null.

Görevin nihai duruma ulaştığı zaman, Unix milisaniye cinsinden. O ana kadar null.

Görevin sonucunun sona erdiği zaman, Unix milisaniye cinsinden. finished_at değerinden 3 gün sonra, görev tamamlanana kadar ise created_at değerinden 3 gün sonrasıdır. API sonuçlarını süresiz olarak saklayan Enterprise hesaplar için bu değer yaklaşık 100 yıl sonrasıdır. Bkz. Varlık saklama.

Görev PENDING durumundayken kuyruktaki konumu. 1, sırada bir sonraki görev olduğu anlamına gelir. Görev kuyruktan çıktıktan sonra 0 olur ve liste sonuçlarında her zaman 0'dır.

Görevin neden başarısız olduğu. status değeri FAILED olmadıkça null. Bkz. Hatalar.

Görev için ücretlendirilen, varsa iadeden sonraki kredi sayısı. Hata döndüren bir istekten ücret alınmaz. Başarısız bir görev 0'dır, çünkü Meshy bunu iade eder. İptal etme, yalnızca görev PENDING durumundayken bir görevi iade eder. Meshy ücreti okuyamazsa, bir get veya stream yanıtı bu alanı dışarıda bırakır ve bir list isteği 500 döndürür. Bu durumda isteği yeniden deneyin.

Sonuç için dosya biçimine göre anahtarlanmış indirme URL'leri. Nesnenin, gönderdiğiniz output.format için bir girişi vardır ve görev başarılı olana kadar boştur.

URL'ler imzalıdır, bu nedenle bunları bir Authorization başlığı olmadan alın. expires_at zamanına kadar geçerli kalırlar. O zamandan önce görevi tekrar almak, yeniden imzalanmış URL'ler değil, aynı URL'leri döndürür. Süresi dolmuş bir URL yenilenemez, bu nedenle dosyaları o zamandan önce indirip saklayın.