Creative Lab Vinyl Figure API

Büyük kafalı bir vinyl figüre dönüştürülecek fotoğraf; genel erişime açık bir URL veya bir data URI (data:image/jpeg;base64,<base64 ile kodlanmış görüntü verileriniz>) olarak belirtilir.

Görüntü, en fazla 20 MB boyutunda bir JPG, JPEG, PNG veya WebP dosyası olmalıdır.

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

Prototip görüntüsünden arka planın kaldırılıp kaldırılmayacağı. true değeri, öznenin herhangi bir arka plana yerleştirilebilmesi için şeffaf bir RGBA PNG döndürür. Build işlemi de görüntünün arka planı olmayan haliyle başlar. Meshy arka planı kaldıramazsa, görüntüyü arka planıyla birlikte döndürür ve görev yine de başarılı olur.

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

• image_url eksik.
• Görüntü bir JPG, JPEG, PNG veya WebP dosyası değil.
• Görüntü çok küçük, 20 MB'den büyük veya maksimum piksel sayısını aşıyor.
• Meshy görüntüyü indiremiyor, örneğin URL 404 döndürüyor veya zaman aşımına uğruyor.
• Data URI geçerli bir base64 değil.
• Görüntü NSFW olarak işaretlendi.

Hata mesajı hangi sorunu bulduğunu belirtir. İsteği düzeltip tekrar gönderin.

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 tekrar deneyin.

Ekibinizde IP Filtering açık ve Meshy görüntüyü üçüncü taraf fikri mülkiyeti nedeniyle işaretledi. Kullanım hakkına sahip olduğunuz bir görüntü gönderin.

Bu 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 tekrar deneyin. Hız sınırları bölümüne bakın.
• Kuyrukta veya çalışan görevlerinizin sayısı çok fazla. Bazılarının tamamlanmasını bekleyip tekrar 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 görüntü üzerinde fikri mülkiyet kontrolünü çalıştıramadığı için. Meshy görevi oluşturmaz ve varsa tahsil ettiği kredileri iade eder. İsteği tekrar deneyin.

Oluşturulacak prototip görevinin ID'si. Bu, hesabınızın POST /openapi/creative-lab/vinyl-figure/v1/prototype ile oluşturduğu ve durumu SUCCEEDED olan bir görev olmalıdır.

API üzerinden oluşturduğunuz Vinyl Figure prototip görevlerinizden biri olmayan bir ID, web uygulamasında oluşturulan bir prototip de dahil olmak üzere 404 döndürür.

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:

• input_task_id eksik veya geçerli bir görev ID'si değil.
• Prototip görevinin durumu SUCCEEDED değil. Hâlâ çalışıyorsa bekleyip tekrar deneyin. Başarısız olduysa veya iptal edildiyse yeni bir prototip görevi oluşturun.
• Prototip görevi başarılı oldu ancak hiçbir görüntüye sahip değil. Yeni bir prototip görevi oluşturun.

Hata mesajı, hangi sorunun bulunduğunu belirtir.

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

Aşağıdakilerden biri geçerlidir:

• Hesabın yeterli kredisi 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 edip tekrar deneyin.

input_task_id, hesabınızın API ile oluşturduğu herhangi bir Vinyl Figure prototip göreviyle eşleşmiyor. Web uygulamasında oluşturulan bir prototip de 404 döndürür. Bir prototip oluşturma yanıtındaki result ID'sini 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 tekrar deneyin. Bkz. Hız sınırları.
• Çok fazla göreviniz sırada bekliyor veya çalışıyor. Bazılarının tamamlanmasını bekleyip tekrar 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.

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

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

Takımınızda IP Filtering açık ve Meshy, görevin görselini üçüncü taraf fikri mülkiyet açısından işaretledi. Enterprise plandaki takımlar bu hatayı almaz. Kullanım haklarına sahip olduğunuz bir görselden prototype görevi oluşturun.

Bu ID'ye sahip bir Vinyl Figure görevi hesabınıza ait değil ya da görevin aşaması yolla eşleşmiyor. ID'yi kontrol edin ve göreve uyacak şekilde /prototype veya /build kullanın.

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

İptal edilecek görevin kimliği.

Aşağıdakilerden biri geçerlidir:

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

Bu kimliğe sahip bir Vinyl Figure görevi hesabınıza ait değil veya görevin aşaması yol ile eşleşmiyor. Kimliği kontrol edin ve göreve uygun olarak /prototype veya /build kullanın.

Oluşturma yanıtından alınan 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, 0 ise 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: en yeniden en eskiye
• +created_at: en eskiden en yeniye

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

Görev türü, her zaman creative-lab-vinyl-figure-prototype.

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

Görevin durumu.

Mevcut değerler:

• PENDING: kuyrukta bekliyor
• IN_PROGRESS: sonuç üretiliyor
• SUCCEEDED: tamamlandı, sonuçla birlikte
• FAILED: tamamlandı, nedeni task_error içinde
• CANCELED: tamamlandı, 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 dolacağı zaman, Unix milisaniye cinsinden. Bu, finished_at değerinden 3 gün sonra, ya da görev tamamlanana kadar created_at değerinden 3 gün sonradır. API sonuçlarını süresiz olarak saklayan Enterprise hesaplar için bu süre yaklaşık 100 yıl sonradır. Bkz. Varlık saklama.

Görevin PENDING durumundayken kuyruktaki konumu. 1, görevin sırada bir sonraki 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, varsa herhangi bir iade sonrasında tahsil edilen kredi sayısı. Hata döndüren bir istekten ücret alınmaz. Başarısız bir görev için bu değer 0'dır, çünkü Meshy bunu iade eder. İptal etme, bir görevi yalnızca PENDING durumundayken iade eder. 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 yeniden deneyin.

Konsept görsel için indirme URL'leri. Görev başarılı olduktan sonra dizi bir URL içerir, o zamana kadar boştur.

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

Görev türü, her zaman creative-lab-vinyl-figure-build.

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

Görevin durumu.

Kullanılabilir değerler:

• PENDING: sırada bekliyor
• IN_PROGRESS: sonuç üretiliyor
• SUCCEEDED: sonlandı, sonuçla birlikte
• FAILED: sonlandı, nedeni task_error içinde
• CANCELED: sonlandı, 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 duruma ulaştığı zaman, Unix milisaniye cinsinden. O zamana kadar null.

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

Görevin PENDING durumundayken sıradaki konumu. 1, bir sonraki sırada başlayacağı anlamına gelir. Görev sıradan çıktıktan sonra 0, ve liste sonuçlarında her zaman 0.

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

Herhangi bir iade sonrası 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 olur, çünkü Meshy bunu iade eder. İptal etme, yalnızca görev PENDING durumundayken görevi iade eder. 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 yeniden deneyin.

Bir Vinyl Figure oluşturma görevi için her zaman "".

prompt gibi, bir Vinyl Figure oluşturma görevi için her zaman "".

prompt gibi, bir Vinyl Figure oluşturma görevi için her zaman "".

prompt gibi, bir Vinyl Figure oluşturma görevi için her zaman "".

3D model için indirme URL'leri; dokulu bir GLB olarak ve MTL dosyasıyla birlikte bir OBJ dosyası olarak.

Modelin önizleme görüntüsü için indirme URL'si.

Doku haritaları, taban renk haritasını tutan tek bir nesneden oluşan bir dizi olarak.