Creative Lab Figür API’si

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

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 ad. Bu ad, görevin name alanında geri döner. Daha uzun bir ad 400 döndürür.

Prototip görüntüsünden arka planın kaldırılıp kaldırılmayacağı. true, şeffaf bir RGBA PNG döndürür, böylece öznenizi istediğiniz herhangi bir arka plana yerleştirebilirsiniz. Build işlemi de arka planı olmayan görüntüden 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ın üzerinde.
• Meshy görüntüyü 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örüntü NSFW olarak işaretlendi.

Hata mesajı hangi sorunu bulduğunu belirtir. İsteği düzeltin, ardından tekrar 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 limitine 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örüntüyü üçüncü taraf fikri mülkiyeti nedeniyle işaretledi. Kullanım hakkına sahip olduğunuz bir görüntü 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. Hız sınırları'na bakın.
• Sıraya alınmış veya çalışan çok fazla göreviniz var. Bazılarının tamamlanmasını bekleyin, ardından yeniden deneyin.
• Kredisi kalmamış sınırsız bir plandaysanız, kredisiz çalışabilecek 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 yeniden deneyin.

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

API üzerinden oluşturduğunuz Figür prototip görevlerinden 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 görsel içermiyor. Yeni bir prototip görevi oluşturun.

Hata mesajı, hangi sorunu bulduğunu belirtir.

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 planda.

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

input_task_id, hesabınızın API ile oluşturduğu herhangi bir Figür prototip görevi ile eşleşmiyor. Web uygulamasında oluşturulan bir prototip de 404 döndürür. Bir prototip oluşturma yanıtından gelen result ID'sini gönderin.

Aşağıdaki 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ı.
• Görevlerinizden çok fazlası kuyrukta veya çalışır durumda. Bazılarının tamamlanmasını bekleyip tekrar deneyin.
• Kredisi olmayan 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 özelliği 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. Kullanma hakkına sahip olduğunuz bir görselden prototip görevi oluşturun.

Bu ID'ye sahip bir Figür görevi hesabınıza ait değil veya görevin aşaması yol ile eşleşmiyor. ID'yi kontrol edin ve göreve uygun şekilde /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 hiçbir Figure 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 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 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-figure-prototype.

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

Görevin durumu.

Kullanılabilir değerler:

• PENDING: sırada bekliyor
• IN_PROGRESS: sonucu oluşturuyor
• 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 işçinin göreve başladığı 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 sona erdiği zaman, Unix milisaniye cinsinden. Bu, finished_at'ten 3 gün sonra, görev tamamlanana 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 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, liste sonuçlarında ise 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 ücretlendirilen kredi sayısı. Hata döndüren bir istek ücretlendirilmez. Başarısız bir görev 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. Formatına güvenmeyin.

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

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

Görevin durumu.

Mevcut değerler:

• PENDING: sırada bekliyor
• IN_PROGRESS: sonuç oluşturuluyor
• SUCCEEDED: nihai, sonuçla birlikte
• FAILED: nihai, nedeni 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. finished_at'ten 3 gün sonra, veya görev tamamlanana kadar created_at'ten 3 gün sonra. API sonuçlarını süresiz olarak saklayan Kurumsal (Enterprise) hesaplar için bu süre yaklaşık 100 yıl sonrasıdı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, liste sonuçlarında ise 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'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.

Bir Figür build görevi için her zaman "".

prompt gibi, bir Figür build görevi için her zaman "".

prompt gibi, bir Figür build görevi için her zaman "".

prompt gibi, bir Figür build görevi için her zaman "".

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

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

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

Meshy'nin temel renk dokusundan vurguları ve gölgeleri kaldırıp kaldırmadığı.