Creative Lab Lamba API

Lamba abajurunun temel alınacağı fotoğraf; genel bir URL veya bir data URI olarak (data:image/jpeg;base64,<base64 ile kodlanmış görsel verileriniz>).

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

Fotoğraftaki öznenin türü; bu, Meshy'nin görseli nasıl stilize edeceğini belirler.

Kullanılabilir değerler:

• character: figürin, hayvan veya maskot gibi tek bir karakter veya nesne
• landscape: dağ, şehir manzarası veya orman gibi açık hava sahnesi ya da panorama

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örselinden arka planın kaldırılıp kaldırılmayacağı. true değeri, özneyi herhangi bir arka plana yerleştirebilmeniz için saydam bir RGBA PNG döndürür. Meshy, 3D modeli de görselin arka planı olmadan oluşturur. Meshy arka planı kaldıramazsa, görseli arka planıyla birlikte kullanır ve görev yine de başarılı olur.

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

• image_url eksik.
• 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ürüyor ya da zaman aşımına uğruyor.
• Data URI geçerli base64 değil.
• Görsel NSFW olarak işaretlendi.
• image_subject, character veya landscape değil.

Hata mesajı, hangi sorunun bulunduğunu belirtir. İsteği düzeltip tekrar gönderin.

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

Aşağıdakilerden biri geçerli:

• 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 özelliği etkin ve Meshy görseli üçüncü taraf fikri mülkiyet nedeniyle işaretledi. Kullanım 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 bekleyip tekrar deneyin. Bkz. Hız sınırları.
• Sırada bekleyen veya çalışan görevleriniz çok fazla. Bazılarının bitmesini 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 bitmesini bekleyin veya kredi ekleyin.

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

Oluşturulacak prototip görevinin kimliği. Bu, POST /openapi/creative-lab/lamp/v1/prototype ile hesabınız tarafından oluşturulmuş, durumu SUCCEEDED olan bir görev olmalıdır.

API üzerinden oluşturulan Lamp prototip görevlerinizden 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 karakter uzunluğunda bir ad. Bu ad, görevin name alanında geri döner. Daha uzun bir ad 400 döndürür.

Lamba abajurunun en büyük boyutu, milimetre cinsinden, 50 ile 400 arasında. Meshy, modeli sığacak şekilde eşit biçimde ölçeklendirir. 0 varsayılan değeri kullanır ve aralığın dışındaki diğer herhangi bir değer 400 döndürür.

Lamba abajurunun duvar kalınlığı, milimetre cinsinden, en fazla 10. 0 varsayılan değeri kullanır, negatif bir değer veya 10'un üzerindeki bir değer 400 döndürür.

Modelin yüksekliğinin altında düz olarak kesilecek yüzdesi, 1 ile 100 arasında. Düz taban, lamba abajurunun baskı tablasına oturmasını sağlar ve fikstür için yer bırakır. Aralığın dışındaki bir değer 400 döndürür.

Meshy'nin altı nasıl oluşturacağını belirleyen ışık fikstürü ön ayarı.

Kullanılabilir değerler:

• bambu_mh001_60mm: 60 mm'lik fikstür deliğine sahip bir taban plakası olan, altı açık bir lamba abajuru; her ikisi de model_urls.lamp_stl içinde, fikstür montaj parçası ise model_urls.base_stl içinde
• none: model_urls.base_stl olmadan, model_urls.lamp_stl içinde tek parça, kapalı bir lamba abajuru

Fikstür deliğinin, lamba abajurunun merkezinden X ekseni boyunca ne kadar hareket ettirileceği, milimetre cinsinden, -80 ile 80 arasında. Yalnızca light_source_preset değeri none olmadığında geçerlidir.

Fikstür deliğinin, lamba abajurunun merkezinden Z ekseni (derinlik) boyunca ne kadar hareket ettirileceği, milimetre cinsinden, -80 ile 80 arasında. Yalnızca light_source_preset değeri none olmadığında geçerlidir.

Meshy modeli işlemeden önce X ekseni etrafında uygulanacak döndürme, derece cinsinden, -360 ile 360 arasında. Meshy, üç döndürmeyi modelin merkezi etrafında XYZ Euler açıları olarak uygular.

Meshy modeli işlemeden önce Y ekseni etrafında uygulanacak döndürme, derece cinsinden, -360 ile 360 arasında.

Meshy modeli işlemeden önce Z ekseni etrafında uygulanacak döndürme, derece cinsinden, -360 ile 360 arasında.

Çalıştırılan iş akışının adı, uyarılar ve dosya yollarıyla birlikte zip paketine bir result.json dosyası eklenip eklenmeyeceği. output.format değerinin zip olarak ayarlanmasını gerektirir. stl ile birlikte true kullanımı 400 döndürür.

Oluşturma işleminin döndüreceği dosyalar.

Kullanılabilir değerler:

• stl: bir fikstür ön ayarı olduğunda taban plakasıyla birlikte lamba abajurunu içeren model_urls.lamp_stl ve light_source_preset değeri none olmadığında model_urls.base_stl
• zip: lamp.stl ile, geçerli olduklarında base.stl ve result.json içeren, model_urls.bundle_zip içindeki tek bir zip 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 bekleyin ve 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 3D modeli yok. Yeni bir prototip görevi oluşturun.
• Bir options alanı aralığının dışında veya kullanılabilir bir değer değil.
• output.format değeri stl veya zip değil, ya da include_result_json değeri zip olmadan true.

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:

• 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 edin, ardından yeniden deneyin.

input_task_id, hesabınızın API ile oluşturduğu herhangi bir Lamp 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ı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 bekleyin, ardından yeniden deneyin. Bkz. Rate limits.
• Görevlerinizden çok fazlası kuyruğa alınmış veya çalışıyor durumda. Bazılarının tamamlanmasını bekleyin, ardından yeniden deneyin.
• Krediniz kalmayan 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, prototip görevinin görselini üçüncü taraf fikri mülkiyet açısından işaretledi. Build görevleri ve Enterprise plandaki takımlar bu hatayı almaz. Kullanım hakkına sahip olduğunuz bir görselden prototip görevi oluşturun.

Bu ID'ye sahip hiçbir Lamba görevi hesabınıza ait değil veya görevin aşaması yolla 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 tekrar 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ından gelen result ID'sini gönderin.
• Görev zaten nihai bir durumda (SUCCEEDED, FAILED veya CANCELED), bu yüzden iptal edilemez.

Bu ID'ye sahip bir Lamp 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 kimliği.

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 değeri 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 kimliği. Biçimine güvenmeyin.

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

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

Görevin durumu.

Kullanılabilir değerler:

• PENDING: kuyrukta 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. Bu olana kadar null.

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

Görevin sonucunun süresinin dolacağı zaman, Unix milisaniye cinsinden. Bu, finished_at'ten 3 gün sonrasıdır ya da görev tamamlanana kadar 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, 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 iade sonrası 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.

Konsept görselden oluşturulan 3D model için indirme URL'leri. Görev başarılı olana kadar {}.

3D modelin önizleme görseli için indirme URL'si. Görev başarılı olana kadar "".

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

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

Görev türü, her zaman creative-lab-lamp-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: sonuç oluşturuluyor
• SUCCEEDED: kesin, sonuçla birlikte
• FAILED: kesin, nedeni task_error içinde
• CANCELED: kesin, 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 kesin 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 değerinden 3 gün sonrası, görev tamamlanana kadar da 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ıradaki görev olduğu anlamına gelir. Görev kuyruktan çıktıktan sonra 0 olur ve liste sonuçlarında her zaman 0 değerindedir.

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

Görev için, varsa iade sonrasında tahsil edilen kredi sayısı. Hata döndüren bir istek ücretlendirilmez. Başarısız bir görev 0 değerindedir, çünkü Meshy bu görevi iade eder. İptal etme, yalnızca görev PENDING durumundayken ücretini iade eder. Meshy ücretlendirmeyi 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.

Basılabilir dosyalar için indirme URL'leri. Hangi anahtarların görüneceği output.format ve options.light_source_preset değerlerine bağlıdır.