Metinden 3D'ye API

Bir preview görevi oluştururken bu alan "preview" olarak ayarlanmalıdır.

3D modelin ne tür bir nesne olduğunu açıklayın. En fazla 800 karakter.

3D ağ oluşturma türünü belirtin.

Kullanılabilir değerler:

• standard: Normal, yüksek detaylı 3D ağ oluşturma.
• smart-topology: ai_model (meshy-t2) ile Smart Topology modelini seçin.
• lowpoly (kullanımdan kaldırıldı): Daha temiz poligonlar için optimize edilmiş low-poly ağ üretir. Bunun yerine smart-topology kullanmanızı öneririz.

Kullanılacak modelin ID'si. Kullanılabilir değerler model_type'a bağlıdır.

Standart oluşturma (model_type: standard):

• meshy-5, meshy-6, meshy-7, latest (Meshy 7)

Smart Topology oluşturma (model_type: smart-topology):

• meshy-t2 (varsayılan): Smart Topology modeli — daha temiz topology, doğal olarak ayrılmış parçalar, üçgen çıktı ve target_polycount ile ayarlayabileceğiniz bir yüzey sayısı.

Daha ince yüzey detayına sahip, daha yüksek doğrulukta geometri için Ultra oluşturmayı etkinleştirir. Oluşturma daha uzun sürer ve 5 kredi ekler.

Yeniden ağ aşamasının etkinleştirilip etkinleştirilmeyeceğini kontrol eder. En yüksek kaliteli model için should_remesh değerini false olarak ayarlamanızı öneririz.

Çıktıdaki hedef poligon (yüzey) sayısı. Gerçek sayı, geometriye bağlı olarak hedeften sapabilir.

target_polycount, iki bağımsız durumda etkili olur:

• Yeniden ağ — standard bir modelde should_remesh: true ile. Ağ, yaklaşık olarak bu sayıya yeniden ağlanır (küçültülür). Aralık 100 ile 300.000 arasında, varsayılan 30.000. decimation_mode ayarlanmışsa, öncelik ona aittir ve target_polycount yok sayılır.
• Smart Topology — model_type: smart-topology ve ai_model: meshy-t2 ile. Model doğrudan bu yüzey sayısında oluşturulur; yeniden ağ çalışmaz ve should_remesh gerekli değildir. Aralık 100 ile 15.000 arasında, varsayılan 4.000.

Kullanımdan kaldırıldı. Bu parametre artık çıktıyı etkilemez.

symmetry_mode alanı, model oluşturma işlemi sırasında simetri davranışını kontrol eder.

Geçerli değerler:

• off: Simetriyi devre dışı bırakır.
• auto: Girdi geometrisine göre simetriyi otomatik olarak belirler ve uygular.
• on: Oluşturma sırasında simetriyi zorunlu kılar.

Oluşturulan model için pose mode'unu belirtin.

Kullanılabilir değerler:

• a-pose: Modeli A pozunda oluşturur.
• t-pose: Modeli T pozunda oluşturur.
• "" (boş dize): Belirli bir poz uygulanmaz.

Bunun yerine pose_mode kullanın. Modelin A/T pozunda oluşturulup oluşturulmayacağı.

Meshy-6 tarafından desteklenmez. Meshy-6 kullanan istekler art_style'ı yok sayar ve bazı kombinasyonlar hatalara neden olabilir. Kullanılabilir değerler: realistic, sculpture.

true olarak ayarlandığında, girdi içeriği potansiyel olarak zararlı içerik açısından otomatik olarak taranır. Zararlı içerik tespit edilirse, görev oluşturma aşamasına geçmez.

prompt'tan gelen metin taranacaktır.

Çıktıya hangi 3D dosya formatlarının dahil edileceğini belirtir. Yalnızca istenen formatlar oluşturulur ve döndürülür; bu da görev tamamlanma süresini azaltabilir. Belirtilmediğinde, desteklenen tüm formatlar dahil edilir.

Kullanılabilir değerler: glb, obj, fbx, stl, usdz, 3mf

true olarak ayarlandığında, görev ek olarak preview'in şeffaf arka planlı (RGBA) bir sürümünü render eder ve bunu GET yanıtında alpha_thumbnail_url olarak döndürür. Mevcut thumbnail_url alanı değişmez.

true olarak ayarlandığında, servis nesnenin gerçek dünyadaki yüksekliğini otomatik olarak tahmin etmek için yapay zeka görüşünü kullanır ve modeli buna göre yeniden boyutlandırır. origin_at açıkça ayarlanmadıkça, orijin varsayılan olarak bottom olur.

İstek kabul edilemedi. Yaygın nedenler:

• Eksik parametre: Gerekli bir parametre (ör. prompt, mode) eksik.
• Geçersiz parametre: art_style izin verilen değerlerden biri değil.
• Prompt çok uzun: prompt, karakter sınırını aşıyor.

Kimlik doğrulama başarısız oldu. Lütfen API anahtarınızı kontrol edin.

Bu görevi gerçekleştirmek için yetersiz kredi.

Hız sınırınızı aştınız.

Bir refine görevi oluştururken bu alan "refine" olarak ayarlanmalıdır.

İlgili preview görevinin id'si.

Verilen preview görevinin durumu SUCCEEDED olmalıdır.

Temel renge ek olarak PBR haritaları (metallic, roughness, normal) oluşturur. ai_model değeri meshy-6 olduğunda, texture_resolution: 8k hariç, bir emission haritası da dahil edilir (8k'da emission haritası üretilmez). meshy-7 (ve latest) emission haritası üretmez.

Temel renk dokusu çözünürlüğü. 2k (2048×2048), 4k (4096×4096) veya 8k (8192×8192) değerlerinden biri. Daha yüksek çözünürlükler daha fazla yüzey detayı yakalar. Yalnızca refine mode için geçerlidir.

Bunun yerine texture_resolution kullanın — texture_resolution: "4k" ile eşdeğerdir. Her ikisi de ayarlandığında texture_resolution önceliklidir.

Dokulandırma sürecine rehberlik etmesi için ek bir metin promptu sağlayın. Maksimum 800 karakter.

Dokulandırma sürecine rehberlik etmesi için 2 boyutlu bir görsel sağlayın. Şu anda .jpg, .jpeg ve .png formatlarını destekliyoruz.

Görseli sağlamanın iki yolu vardır:

• Herkese açık erişilebilir URL: Genel internetten erişilebilen bir URL
• Data URI: Görselin base64 ile kodlanmış bir data URI'si. Bir data URI örneği: data:image/jpeg;base64,<your base64-encoded image data>

Refine işlemi için kullanılacak modelin ID'si. Kullanılabilir değerler: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Preview görevinde kullanılan modeli devralmak için bu parametreyi atlayın; bu, bir preview ve onun refine işlemini uçtan uca aynı modelde tutar. Bu devralmayı geçersiz kılmak için açık bir değer verin.

true olarak ayarlandığında, girdi içeriği otomatik olarak potansiyel olarak zararlı içerik açısından taranır. Zararlı içerik tespit edilirse görev üretim aşamasına geçmez.

Hem texture_prompt metni hem de texture_image_url görseli taranacaktır.

Temel renk dokusundan vurguları ve gölgeleri kaldırarak özel aydınlatma kurulumları altında daha iyi çalışan daha temiz bir sonuç üretir.

Çıktıda hangi 3D dosya formatlarının yer alacağını belirtir. Yalnızca talep edilen formatlar oluşturulup döndürülür, bu da görev tamamlanma süresini azaltabilir. Belirtilmediğinde, desteklenen tüm formatlar dahil edilir.

Kullanılabilir değerler: glb, obj, fbx, stl, usdz, 3mf

true olarak ayarlandığında, görev ek olarak preview'in şeffaf arka planlı (RGBA) bir sürümünü render eder ve bunu GET yanıtında alpha_thumbnail_url olarak döndürür. Mevcut thumbnail_url alanı değişmeden kalır.

true olarak ayarlandığında, servis nesnenin gerçek dünyadaki yüksekliğini otomatik olarak tahmin etmek için AI görüşünü kullanır ve modeli buna göre yeniden boyutlandırır. origin_at açıkça ayarlanmadığı sürece orijin varsayılan olarak bottom olur.

İstek kabul edilemedi. Yaygın nedenler:

• Geçersiz görev ID'si: preview_task_id geçersiz veya mevcut değil.
• Görev hazır değil: Preview görevi henüz başarılı olmadı.
• Model uyuşmazlığı: Preview görevinin AI modeli, talep edilen refine modeliyle uyumsuz.

Kimlik doğrulama başarısız oldu. Lütfen API anahtarınızı kontrol edin.

Bu görevi gerçekleştirmek için yetersiz kredi.

preview_task_id ile belirtilen preview görevi bulunamadı.

Hız sınırınızı aştınız.

Getirilecek Metinden 3D'ye görevi için benzersiz tanımlayıcı.

Silinecek Metinden 3D'ye görevinin kimliği.

Sayfalama için sayfa numarası.

Sayfa boyutu limiti. İzin verilen maksimum 50 öğedir.

Sıralama yapılacak alan.

Kullanılabilir değerler:

• +created_at: Oluşturulma zamanına göre artan sırada sıralar.
• -created_at: Oluşturulma zamanına göre azalan sırada sıralar.

Akışı alınacak Metinden 3D'ye görevi için benzersiz tanımlayıcı.

Görev için benzersiz tanımlayıcı. Görev id'leri için uygulama detayı olarak k-sıralanabilir bir UUID kullansak da, id'nin biçimi hakkında hiçbir varsayımda bulunmamalısınız.

Metinden 3D'ye görevinin türü. Olası değerler, preview aşaması görevleri için text-to-3d-preview ve refine aşaması görevleri için text-to-3d-refine'dır.

Meshy tarafından oluşturulan dokulu 3D model dosyasına indirilebilir URL. Boş bir dize döndürmek yerine, bir biçim oluşturulmadıysa o biçime ait özellik atlanır.

Bu, görevi oluşturmak için kullanılan değiştirilmemiş prompttur.

Geriye dönük uyumluluk için korunmaktadır. Bu alanın oluşturulan modeller üzerinde işlevsel bir etkisi yoktur.

Preview görevini oluşturmak için kullanılan değiştirilmemiş art_style. Meshy-6 tarafından desteklenmez.

Geriye dönük uyumluluk için korunmaktadır. Bu alanın oluşturulan modeller üzerinde işlevsel bir etkisi yoktur.

Refine aşaması sırasında dokulama sürecine rehberlik etmek için sağlanan ek metin promptu.

Preview görevinin oluşturulduğu ultra_mode değerini yansıtır. Yalnızca ultra_mode'u açıkça ayarlayan meshy-7 (veya latest) preview görevleri için bulunur; aksi takdirde atlanır.

Dokulama sürecine rehberlik etmek için kullanılan doku görüntüsüne indirilebilir URL.

Model dosyasının küçük resmine indirilebilir URL.

thumbnail_url'nin şeffaf arka planlı (RGBA) versiyonuna indirilebilir URL. Yalnızca görev alpha_thumbnail: true ile oluşturulduğunda ve şeffaf önizleme başarıyla oluşturulduğunda bulunur; aksi takdirde bu alan atlanır.

Önizleme videosuna indirilebilir URL. Gelecekteki bir sürümde kaldırılacaktır.

Görevin ilerlemesi (progress). Görev henüz başlamadıysa, bu özellik 0 olacaktır. Görev başarılı olduğunda, bu değer 100 olacaktır.

Görevin başlatıldığı zamanın milisaniye cinsinden zaman damgası. Görev henüz başlamadıysa, bu özellik 0 olacaktır.

Görevin oluşturulduğu zamanın milisaniye cinsinden zaman damgası.

Görevin tamamlandığı zamanın milisaniye cinsinden zaman damgası. Görev henüz tamamlanmadıysa, bu özellik 0 olacaktır.

Görevin durumu. Olası değerler PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED'dan biridir.

Görevden oluşturulan doku URL nesnelerinin bir dizisi. Normalde bu yalnızca bir doku URL nesnesi içerir. Her doku URL'sinin aşağıdaki özellikleri vardır:

Önceki görevlerin sayısı.

Başarısız görevler için hata ayrıntıları. Tam task_error nesne referansı için Hatalar bölümüne bakın.

Bu görev tarafından tüketilen kredi sayısı. Görev durumu PENDING, IN_PROGRESS veya SUCCEEDED olduğunda bulunur. FAILED görevler için 0 döndürür (başarısızlık durumunda krediler iade edilir).