Yeniden dokulama API'si, Meshy'nin yapay zekâ ile yeniden dokulama yeteneklerini kendi uygulamanıza entegre etmenizi sağlayan bir özelliktir. Bu bölümde, bu API ile
başlamak için ihtiyacınız olan tüm bilgileri bulacaksınız.
Bu uç nokta yeni bir Yeniden dokulama görevi oluşturmanıza olanak tanır. Yeniden dokulama görevi nesnesine hangi
özelliklerin dahil olduğunu görmek için
Yeniden Dokulama Görevi Nesnesi bölümüne bakın.
Parametreler
input_task_id veya model_url değerlerinden yalnızca biri gereklidir. İkisi de sağlanırsa, input_task_id öncelik alır.
Name
input_task_id
Type
string
Zorunlu
Description
Yeniden dokulamak istediğiniz tamamlanmış Görselden 3D'ye veya Metinden 3D'ye görevinin ID'si.
Bu görev şu görevlerden biri olmalıdır: Metinden 3D'ye Önizleme, Metinden 3D'ye İyileştirme, Görselden 3D'ye veya Yeniden ağ. Ayrıca, durumu SUCCEEDED olmalıdır.
Name
model_url
Type
string
Zorunlu
Description
Meshy'nin dokulaması için bir 3D model sağlayın. Desteklenen formatlar: .glb, .gltf, .obj, .fbx, .stl.
Modeli sağlamanın iki yolu vardır:
Herkese açık erişilebilir URL: Genel internetten erişilebilen bir URL.
Data URI: Modelin base64 ile kodlanmış Data URI'si. MIME type olarak application/octet-stream kullanın. Örnek: data:application/octet-stream;base64,<your base64-encoded model data>.
text_style_prompt veya image_style_url değerlerinden yalnızca biri gereklidir. İkisi de sağlanırsa, image_style_url öncelik alır.
Name
text_style_prompt
Type
string
Zorunlu
Description
Nesnenin istediğiniz doku stilini metin kullanarak açıklayın. Maksimum 600 karakter.
Name
image_style_url
Type
string
Zorunlu
Description
Dokulama sürecini yönlendirmek için 2B 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ış Data URI'si. Bir Data URI örneği: data:image/jpeg;base64,<your base64-encoded image data>
Orijinal asset ile yüklenen görsel arasında önemli geometri farkları varsa, görsel dokulama en iyi şekilde çalışmayabilir.
Name
ai_model
Type
string
varsayılan latest
Description
Yeniden dokulama için kullanılacak AI modelinin ID'si. Kullanılabilir değerler: meshy-5, meshy-6, latest (Meshy 6).
Name
enable_original_uv
Type
boolean
varsayılan false
Description
Yeni bir tane oluşturmak yerine modelin mevcut UV yerleşimini koruyun.
Meshy'nin oluşturduğu bir modeli yeniden dokuluyorsanız (input_task_id aracılığıyla veya Meshy çıktısına işaret eden bir model_url ile), optimize edilmiş UV yerleşimini yeniden kullanmak için bunu true olarak ayarlayın.
Yüklediğiniz üçüncü taraf bir modeli yeniden dokuluyorsanız, korumak istediğiniz iyi UV'lere zaten sahipse true olarak ayarlayın veya Meshy'nin yeni UV'ler açmasına izin vermek için false olarak bırakın (uygun UV eşlemesi olmayan modeller için en iyisi).
Name
enable_pbr
Type
boolean
varsayılan false
Description
Temel renge ek olarak PBR haritaları (metallic, roughness, normal) oluşturun. ai_modelmeshy-6 veya latest olduğunda bir emisyon haritası da dahil edilir.
Name
hd_texture
Type
boolean
varsayılan false
Description
Daha yüksek ayrıntı için temel renk dokusunu 4K (4096×4096) çözünürlükte oluşturun.
Yalnızca ai_modelmeshy-6 veya latest olduğunda desteklenir. PBR haritaları her zaman 2K'da oluşturulur.
Name
remove_lighting
Type
boolean
varsayılan true
Description
Temel renk dokusundan parlak vurguları ve gölgeleri kaldırarak özel aydınlatma kurulumları altında daha iyi çalışan daha temiz bir sonuç üretir.
Yalnızca ai_modelmeshy-6 veya latest olduğunda desteklenir.
Name
target_formats
Type
string[]
Description
Çı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 tamamlama süresini azaltabilir. Atlandığında, desteklenen tüm formatlar dahil edilir.
Atlandığında, 3mf dışındaki tüm formatlar oluşturulur. 3mf yalnızca açıkça belirtildiğinde dahil edilir.
Name
alpha_thumbnail
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, görev ayrıca önizlemenin şeffaf arka planlı (RGBA) bir sürümünü işler ve GET yanıtında bunu alpha_thumbnail_url olarak döndürür. Mevcut thumbnail_url alanı değişmeden kalır.
Döndürür
Yanıtın result özelliği, yeni oluşturulan Yeniden dokulama görevinin görev id değerini içerir.
Hata Modları
Name
400 - Bad Request
Description
İstek kabul edilemezdi. Yaygın nedenler:
Eksik parametre: model_url veya input_task_id sağlanmalıdır.
Eksik stil: text_style_prompt veya image_style_url sağlanmalıdır.
Geçersiz giriş görevi: input_task_id, desteklenen bir modelden başarılı bir göreve başvurmalıdır.
Geçersiz model formatı: model_url, desteklenmeyen uzantıya sahip bir dosyaya işaret ediyor.
Erişilemeyen URL: model_url veya image_style_url indirilemedi.
Name
401 - Unauthorized
Description
Kimlik doğrulama başarısız oldu. Lütfen API anahtarınızı kontrol edin.
Name
402 - Payment Required
Description
Bu görevi gerçekleştirmek için yetersiz kredi.
Name
429 - Too Many Requests
Description
Hız sınırınızı aştınız.
Request
POST
/openapi/v1/retexture
# Retexture with text promptcurl https://api.meshy.ai/openapi/v1/retexture \ -H "Authorization: Bearer ${YOUR_API_KEY}" \ -H 'Content-Type: application/json' \ -d '{ "model_url": "https://cdn.meshy.ai/model/example_model_2.glb", "text_style_prompt": "red fangs, Samurai outfit that fused with japanese batik style", "enable_original_uv": true, "enable_pbr": true }'# Retexture with image style and PBRcurl https://api.meshy.ai/openapi/v1/retexture \ -H "Authorization: Bearer ${YOUR_API_KEY}" \ -H 'Content-Type: application/json' \ -d '{ "model_url": "https://cdn.meshy.ai/model/example_model_2.glb", "image_style_url": "https://cdn.meshy.ai/image/example_image.jpg", "ai_model": "latest", "enable_pbr": true, "enable_original_uv": true }'
Bu uç nokta, geçerli bir görev id değeri verildiğinde bir Yeniden dokulama görevini almanıza olanak tanır.
Yeniden dokulama görev nesnesine hangi özelliklerin dahil olduğunu görmek için
Yeniden dokulama Görev Nesnesi bölümüne bakın.
Parametreler
Name
id
Type
path
Description
Alınacak Yeniden dokulama görevi için benzersiz tanımlayıcı.
{"id":"018a210d-8ba4-705c-b111-1f1776f7f578","type":"retexture","model_urls": {"glb":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***","fbx":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***","obj":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***","usdz":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***","mtl":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.mtl?Expires=***","stl":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***" },"thumbnail_url":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***","text_style_prompt":"red fangs, Samurai outfit that fused with japanese batik style","texture_image_url":"","progress":100,"started_at":1692771667037,"created_at":1692771650657,"expires_at":1692771679037,"finished_at":1692771669037,"status":"SUCCEEDED","texture_urls": [ {"base_color":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***","metallic":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX","normal":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX","roughness":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX","emission":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX" } ],"task_error": {"message":"" },"consumed_credits":10}
[ {"id":"018a210d-8ba4-705c-b111-1f1776f7f578","type":"retexture","model_urls": {"glb":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***","fbx":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***","usdz":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***" },"thumbnail_url":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***","text_style_prompt":"red fangs, Samurai outfit that fused with japanese batik style","progress":100,"started_at":1692771667037,"created_at":1692771650657,"expires_at":1692771679037,"finished_at":1692771669037,"status":"SUCCEEDED","texture_urls": [ {"base_color":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***","metallic":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX","normal":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX","roughness":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX","emission":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX" } ],"preceding_tasks":0,"task_error": {"message":"" },"consumed_credits":10 }]
Yeniden dokulama Görev nesnesi, Meshy'nin metin veya görsel girdilerden 3D doku oluşturmak için kullandığı bir iş birimidir.
Model şu özelliklere sahiptir:
Özellikler
Name
id
Type
string
Description
Görev için benzersiz tanımlayıcı. Görev kimlikleri için uygulama ayrıntısı olarak k-sıralanabilir bir UUID kullansak da,
id biçimi hakkında hiçbir varsayımda bulunmamalısınız.
Name
type
Type
string
Description
Yeniden dokulama görevinin türü. Değer retexture olur.
Name
model_urls
Type
object
Description
Meshy tarafından oluşturulan dokulanmış 3D model dosyasına ait indirilebilir URL.
Name
glb
Type
string
Description
GLB dosyasına ait indirilebilir URL.
Name
fbx
Type
string
Description
FBX dosyasına ait indirilebilir URL.
Name
obj
Type
string
Description
OBJ dosyasına ait indirilebilir URL.
Name
usdz
Type
string
Description
USDZ dosyasına ait indirilebilir URL.
Name
mtl
Type
string
Description
MTL dosyasına ait indirilebilir URL; dokular mevcut olduğunda OBJ dışa aktarımlarıyla birlikte döndürülür.
Name
stl
Type
string
Description
STL dosyasına ait indirilebilir URL.
Name
3mf
Type
string
Description
3MF dosyasına ait indirilebilir URL. Yalnızca target_formats aracılığıyla 3mf istendiğinde bulunur.
Name
text_style_prompt
Type
string
Description
Bu, dokulama görevini oluşturmak için kullanılan metin prompt'udur.
Name
image_style_url
Type
string
Description
Bu, dokulama görevini oluşturmak için kullanılan görüntü girdisidir.
Name
thumbnail_url
Type
string
Description
Model dosyasının küçük resim görüntüsüne ait indirilebilir URL.
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url öğesinin şeffaf arka planlı (RGBA) sürümüne ait indirilebilir URL. Yalnızca görev alpha_thumbnail: true ile oluşturulduğunda ve şeffaf önizleme başarıyla render edildiğinde bulunur; aksi takdirde bu alan atlanır.
Name
progress
Type
integer
Description
Görevin progress değeri. Görev henüz başlatılmadıysa bu özellik 0 olur. Görev başarıyla tamamlandığında bu değer 100 olur.
Name
started_at
Type
timestamp
Description
Görevin ne zaman başlatıldığının milisaniye cinsinden zaman damgası. Görev henüz başlatılmadıysa bu özellik 0 olur.
Bir zaman damgası, RFC 3339 standardına göre
1 Ocak 1970 UTC'den bu yana geçen milisaniye sayısını temsil eder.
Örneğin, 1 Eylül 2023 Cuma 12:00:00 GMT 1693569600000 olarak temsil edilir. Bu, Meshy API içindeki
tüm zaman damgaları için geçerlidir.
Name
created_at
Type
timestamp
Description
Görevin ne zaman oluşturulduğunun milisaniye cinsinden zaman damgası.
Name
expires_at
Type
timestamp
Description
Görev sonucunun ne zaman sona ereceğinin milisaniye cinsinden zaman damgası.
Name
finished_at
Type
timestamp
Description
Görevin ne zaman tamamlandığının milisaniye cinsinden zaman damgası. Görev henüz tamamlanmadıysa bu özellik 0 olur.
Görevden oluşturulan doku URL nesnelerinden oluşan bir dizi. Normalde bu yalnızca bir doku URL nesnesi içerir. Her doku URL'si aşağıdaki özelliklere sahiptir:
Name
base_color
Type
string
Description
Temel renk haritası görüntüsüne ait indirilebilir URL.
Name
metallic
Type
string
Description
Metalik harita görüntüsüne ait indirilebilir URL.
Görev enable_pbr: false ile oluşturulursa bu özellik atlanır.
Name
normal
Type
string
Description
normal harita görüntüsüne ait indirilebilir URL.
Görev enable_pbr: false ile oluşturulursa bu özellik atlanır.
Name
roughness
Type
string
Description
Pürüzlülük haritası görüntüsüne ait indirilebilir URL.
Görev enable_pbr: false ile oluşturulursa bu özellik atlanır.
Name
emission
Type
string
Description
Emisyon haritası görüntüsüne ait indirilebilir URL.
Görev enable_pbr: false ile oluşturulursa veya ai_modelmeshy-5 ise bu özellik atlanır.
Name
preceding_tasks
Type
integer
Description
Önceki görevlerin sayısı.
Bu özellik yalnızca görev durumu PENDING olduğunda bulunur.
Name
task_error
Type
object
Description
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.
Name
consumed_credits
Type
integer
Description
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).
Example Retexture Task Model
{"id":"018a210d-8ba4-705c-b111-1f1776f7f578","type":"retexture","model_urls": {"glb":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***","fbx":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***","usdz":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***" },"text_style_prompt":"red fangs, Samurai outfit that fused with japanese batik style","image_style_url":"https://assets.meshy.ai/***/image/example_image.jpg?Expires=***","thumbnail_url":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***","progress":100,"started_at":1692771667037,"created_at":1692771650657,"expires_at":1692771679037,"finished_at":1692771669037,"status":"SUCCEEDED","texture_urls": [ {"base_color":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***","metallic":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX","normal":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX","roughness":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX","emission":"https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_emission.png?Expires=XXX" } ],"preceding_tasks":0,"task_error": {"message":"" },"consumed_credits":10}