Retexture API

Retexture API, Meshy'nin yapay zeka destekli 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.

POST/openapi/v1/retexture

Yeniden Dokulama Görevi Oluştur

Bu uç nokta, yeni bir Yeniden dokulama görevi oluşturmanızı sağlar. Yeniden dokulama görevi nesnesiyle hangi özelliklerin dahil olduğunu görmek için Yeniden Dokulama Görevi Nesnesi bölümüne bakın.

Görev arka planda çalışır. Genellikle ne kadar sürdüğü hakkında bilgi için İşlem Süreleri sayfasına bakın.

Parametreler

input_task_id veya model_url parametrelerinden yalnızca biri gereklidir. Her ikisi de sağlanırsa input_task_id önceliklidir.

Name
input_task_id
Type
string
Zorunlu
Description
Yeniden dokulamak istediğiniz tamamlanmış Görselden 3D'ye veya Metinden 3D'ye görevinin kimliği. Bu görev şu görevlerden biri olmalıdır: Metinden 3D'ye Preview, Metinden 3D'ye Refine, Görselden 3D'ye veya Yeniden ağ. Ayrıca durumu SUCCEEDED olmalıdır.

Name
model_url
Type
string
Zorunlu
Description
Meshy'nin doku uygulayacağı bir 3D model sağlayın. Desteklenen formatlar: .glb, .gltf, .obj, .fbx, .stl.
Maksimum dosya boyutu: http veya https URL'si için 400 MB, data: URI'si için 100 MB.
100 MB'den büyük bir GLB, glTF, FBX veya OBJ dosyası en fazla 10.000.000 yüzeye sahip olabilir. Yüzeyler üçgen olarak sayılır: bir dörtgen 2 olarak sayılır ve birden fazla kez çizilen bir ağ her kopya için bir kez sayılır. 100 MB'nin üzerinde, bir FBX dosyası ikili FBX 7.1 veya daha yeni bir sürüm olmalı ve bir GLB veya glTF dosyası Draco sıkıştırması kullanmamalıdır.
Modeli sağlamanın iki yolu vardır:
- Herkese açık erişilebilir URL: Herkese açık internetten erişilebilen bir URL.
- Data URI: Modelin base64 ile kodlanmış bir data URI'si. application/octet-stream MIME type kullanın. Örnek: data:application/octet-stream;base64,<base64 ile kodlanmış model verileriniz>.

Tam olarak bir stil girdisi gereklidir: text_style_prompt, image_style_url veya multiview_image_urls. multiview_image_urls, diğer ikisinden biriyle birlikte kullanılamaz; hem text_style_prompt hem de image_style_url sağlanırsa, image_style_url önceliklidir.

Name
text_style_prompt
Type
string
Zorunlu
Description
Nesnenin istediğiniz doku stilini metin kullanarak açıklayın. Maksimum 800 karakter.

Name
image_style_url
Type
string
Zorunlu
Description
Dokulama sürecine rehberlik etmesi için bir 2D görsel sağlayın. Şu anda .jpg, .jpeg, .png ve .webp formatlarını destekliyoruz.
Maksimum dosya boyutu: 20 MB.
Görseli sağlamanın iki yolu vardır:
- Herkese açık erişilebilir URL: Herkese açık internetten erişilebilen bir URL
- Data URI: Görselin base64 ile kodlanmış bir data URI'si. Data URI örneği: data:image/jpeg;base64,<base64 ile kodlanmış görsel verileriniz>
Orijinal asset ile yüklenen görsel arasında önemli geometri farklılıkları varsa, görsel dokulama en iyi şekilde çalışmayabilir.

Name
multiview_image_urls
Type
string[]
Zorunlu
Description
Dokulamaya rehberlik etmesi için aynı nesnenin farklı açılardan 1 ila 4 görselini sağlayın. İlk görsel ana (ön) görünümdür; kalan görünümlerin (sol, arka, sağ) sırası önemli değildir.
Her bir öğe, image_style_url ile aynı formatları kabul eder (herkese açık erişilebilir bir URL veya base64 data URI, .jpg/.jpeg/.png/.webp).
Maksimum dosya boyutu: görsel başına 20 MB.
Açıkça belirtilmiş bir ai_model: "meshy-7" gerektirir.

Name
ai_model
Type
string
varsayılan latest
Description
Yeniden dokulama için kullanılacak AI modelinin kimliği. Kullanılabilir değerler: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).
Name
enable_original_uv
Type
boolean
varsayılan false
Description
Yeni bir UV yerleşimi oluşturmak yerine modelin mevcut UV yerleşimini koruyun.
- Meshy tarafından oluşturulmuş bir modeli (bir input_task_id üzerinden veya bir Meshy çıktısına işaret eden bir model_url üzerinden) yeniden dokuluyorsanız, optimize edilmiş UV yerleşimini yeniden kullanmak için bunu true olarak ayarlayın.
- Yüklediğiniz üçüncü taraf bir modeli yeniden dokuluyorsanız, zaten korumak istediğiniz iyi UV'lere sahipse true olarak ayarlayın, ya da Meshy'nin yeni UV'ler açmasına izin vermek için false bırakın (uygun UV eşlemesi olmayan modeller için en iyisidir).
Name
enable_pbr
Type
boolean
varsayılan false
Description
Temel renge ek olarak PBR haritaları (metalik, pürüzlülük, normal) oluşturun. ai_model değeri meshy-6 olduğunda, texture_resolution: 8k hariç, bir emisyon haritası da dahil edilir. meshy-6-lite, meshy-7 ve latest emisyon haritası üretmez.
Name
texture_resolution
Type
string
varsayılan 2k
Description
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.
4k ve 8k, ai_model değerinin meshy-6, meshy-7 veya latest olmasını gerektirir. 8k çözünürlükte emisyon haritası üretilmez.
Name
hd_texture
Type
boolean
⚠ kullanımdan kaldırıldı
varsayılan false
Description
Bunun yerine texture_resolution kullanın — texture_resolution: "4k" ile eşdeğerdir. Her ikisi de ayarlandığında texture_resolution önceliklidir.
Name
remove_lighting
Type
boolean
varsayılan true
Description
Temel renk dokusundan vurguları ve gölgeleri kaldırarak, özel aydınlatma kurulumlarında daha iyi çalışan daha temiz bir sonuç üretir.
Yalnızca ai_model değeri meshy-6 ve texture_resolution değeri 2k veya 4k olduğunda uygulanır. meshy-7 veya latest ile ve 8k çözünürlükte kabul edilir ancak göz ardı edilir. meshy-6-lite ile, herhangi bir değerle gönderilmesi 400 döndürür.
Name
target_formats
Type
string[]
Description
Çıktıya hangi 3D dosya formatlarının dahil edileceğini belirtir. Yalnızca istenen 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
Belirtilmediğinde, 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ü oluşturur ve bunu GET yanıtında alpha_thumbnail_url olarak döndürür. Mevcut thumbnail_url alanı değişmeden kalır.

Dönüş Değerleri

Yanıtın result özelliği, yeni oluşturulan Yeniden dokulama görevinin id değerini içerir.

Hata Modları

Name
400 - Bad Request
Description
İstek kabul edilemedi. Yaygın nedenler:
- Eksik parametre: model_url veya input_task_id değerlerinden biri sağlanmalıdır.
- Eksik stil: text_style_prompt, image_style_url veya multiview_image_urls değerlerinden biri sağlanmalıdır.
- Çelişen stil girdileri: multiview_image_urls, text_style_prompt veya image_style_url ile birlikte kullanılamaz.
- Çoklu görünüm için desteklenmeyen model: multiview_image_urls açıkça belirtilmiş bir ai_model: "meshy-7" gerektirir.
- Model henüz kullanılabilir değil: ai_model: "meshy-7" ve ai_model: "meshy-6-lite" kademeli olarak kullanıma sunulmaktadır ve hesabınız için henüz etkinleştirilmemiş olabilir.
- Geçersiz giriş görevi: input_task_id, desteklenen bir modelden başarılı bir görevi işaret etmelidir.
- Geçersiz model formatı: model_url, desteklenmeyen bir uzantıya sahip bir dosyayı işaret ediyor.
- Erişilemeyen URL: model_url, image_style_url veya bir multiview_image_urls öğesi indirilemedi.
- Model dosyası çok büyük: model_url dosyası 400 MB'yi (http veya https URL'si) veya 100 MB'yi (data: URI'si) aşıyor.
- Çok fazla yüzey: model_url dosyası 100 MB'den büyük ve 10.000.000'den fazla yüzeye sahip. Yüzey sayısını azaltıp dosyayı tekrar gönderin.
- 100 MB'nin üzerinde ASCII FBX: model_url dosyası 100 MB'den büyük bir ASCII FBX. Bunu ikili FBX veya GLB olarak gönderin.
- Okunamayan model dosyası: model_url dosyası 100 MB'den büyük ve başlığı okunamıyor, örneğin Draco ile sıkıştırılmış bir GLB veya glTF, ya da 7.1'den eski bir ikili FBX.
- Model başlığı çok karmaşık: model_url dosyası 100 MB'den büyük ve başlığında kontrol edilmesi gereken çok fazla ağ, düğüm veya kayıt var. Dosyadaki nesne sayısını azaltıp tekrar gönderin.
- Görsel çok büyük: image_style_url görseli veya bir multiview_image_urls öğesi 20 MB'yi aşıyor.
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 prompt
curl 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 PBR
curl 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": "<your publicly accessible image url or base64-encoded data URI>",
    "ai_model": "latest",
    "enable_pbr": true,
    "enable_original_uv": true
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

GET/openapi/v1/retexture/:id

Yeniden Dokulama Görevini Al

Bu uç nokta, geçerli bir görev id'si verildiğinde bir Yeniden dokulama görevini almanızı sağlar. Yeniden dokulama görev nesnesiyle hangi özelliklerin dahil edildiğini görmek için Yeniden Dokulama Görevi 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ı.

Dönüş Değerleri

Yanıt, Yeniden dokulama görev nesnesini içerir. Ayrıntılar için Yeniden Dokulama Görevi Nesnesi bölümüne bakın.

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "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"
    }
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

DELETE/openapi/v1/retexture/:id

Bir Yeniden Dokulama Görevini Sil

Bu uç nokta, ilişkili tüm modeller ve veriler dahil olmak üzere bir yeniden dokulama görevini kalıcı olarak siler. Bu işlem geri alınamaz.

Yol Parametreleri

Name
id
Type
path
Description
Silinecek yeniden dokulama görevinin ID'si.

Görev Durumu

Hâlâ PENDING durumunda olan bir görev silinir ve oluşturma sırasında harcanan kredi iade edilir.

Zaten IN_PROGRESS durumunda olan bir görev silinemez: istek 409 Conflict ile reddedilir ve görev çalışmaya devam eder. Çalışanın (worker) zaten başlatmış olduğu bir görev için kredi iade edilmez, bu nedenle çalışma sırasında silmek hem krediyi hem de sonucu kaybetmenize neden olur. Görevin SUCCEEDED, FAILED veya CANCELED durumuna ulaşmasını bekleyin, ardından silin.

Son durumda (SUCCEEDED, FAILED veya CANCELED) olan bir görev, iade yapılmadan silinir.

Dönüş Değerleri

Başarı durumunda 200 OK döner, görev IN_PROGRESS durumundaysa 409 Conflict döner.

Request

DELETE

/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/retexture/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS — the task is left running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

GET/openapi/v1/retexture

Yeniden Dokulama Görevlerini Listele

Bu uç nokta, Yeniden dokulama görevlerinin bir listesini almanızı sağlar.

Parametreler

Name
page_num
Type
integer
varsayılan 1
Description
Sayfalama için sayfa numarası.
Name
page_size
Type
integer
varsayılan 10
Description
Sayfa boyutu sınırı. İzin verilen maksimum 100 öğedir.
Name
sort_by
Type
string
Description
Sıralanacak alan.
Kullanılabilir değerler:
- +created_at: Oluşturulma zamanına göre artan sırada sırala.
- -created_at: Oluşturulma zamanına göre azalan sırada sırala.

Döndürülenler

Yeniden Dokulama Görevi Nesneleri için sayfalanmış bir liste döndürür.

Request

GET

/openapi/v1/retexture

curl https://api.meshy.ai/openapi/v1/retexture?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "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"
      }
    ],
    "preceding_tasks": 0,
    "task_error": {

      "message": ""

    },

    "consumed_credits": 10
  }
]

GET/openapi/v1/retexture/:id/stream

Bir Yeniden Dokulama Görevini Akışla Al

Bu uç nokta, Server-Sent Events (SSE) kullanarak bir Yeniden Dokulama görevi için gerçek zamanlı güncellemeleri akış olarak sunar.

Parametreler

Name
id
Type
path
Description
Akışı alınacak Yeniden Dokulama görevinin benzersiz tanımlayıcısı.

Dönüş Değerleri

Yeniden Dokulama Görevi Nesnelerinin Server-Sent Events olarak bir akışını döndürür.

PENDING veya IN_PROGRESS durumundaki görevler için yanıt akışı yalnızca gerekli progress ve status alanlarını içerecektir.

Request

GET

/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/retexture/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 50,
  "status": "IN_PROGRESS"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "retexture",
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "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=***"
  },
  "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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}

Yeniden Dokulama Görev Nesnesi

Yeniden Dokulama Görev nesnesi, Meshy'nin metin veya görsel girdilerinden bir 3D doku oluşturmak için kullandığı bir iş birimidir. Modelin aşağıdaki özellikleri vardır:

Özellikler

Name
id
Type
string
Description
Görev için benzersiz tanımlayıcı. Uygulama detayı olarak görev kimlikleri için k-sıralanabilir bir UUID kullansak da, kimliğin 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 şeklindedir.
Name
model_urls
Type
object
Description
Meshy tarafından oluşturulan dokulu 3D model dosyasına indirilebilir URL.
- Name
  glb
  Type
  string
  Description
  GLB dosyasına indirilebilir URL.
- Name
  fbx
  Type
  string
  Description
  FBX dosyasına indirilebilir URL.
- Name
  obj
  Type
  string
  Description
  OBJ dosyasına indirilebilir URL.
- Name
  usdz
  Type
  string
  Description
  USDZ dosyasına indirilebilir URL.
- Name
  mtl
  Type
  string
  Description
  Dokular mevcut olduğunda OBJ dışa aktarımlarıyla birlikte döndürülen MTL dosyasına indirilebilir URL.
- Name
  stl
  Type
  string
  Description
  STL dosyasına indirilebilir URL.
- Name
  3mf
  Type
  string
  Description
  3MF dosyasına indirilebilir URL. Yalnızca target_formats aracılığıyla 3mf istendiğinde mevcuttur.
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örsel girdidir.
Name
multiview_image_urls
Type
string[]
Description
Dokulama görevini oluşturmak için kullanılan çoklu görünüm referans görsellerine indirilebilir URL'ler. Yalnızca görev multiview_image_urls ile oluşturulduğunda mevcuttur.
Name
thumbnail_url
Type
string
Description
Model dosyasının küçük resim görseline indirilebilir URL.
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url değerinin şeffaf arka planlı (RGBA) bir sürümüne indirilebilir URL. Yalnızca görev alpha_thumbnail: true ile oluşturulduğunda ve şeffaf önizleme başarıyla oluşturulduğunda mevcuttur; aksi takdirde bu alan atlanır.
Name
progress
Type
integer
Description
Görevin ilerlemesi. Görev henüz başlamadıysa bu özellik 0 olacaktır. Görev başarıyla tamamlandığında bu değer 100 olur.
Name
started_at
Type
timestamp
Description
Görevin başlatıldığı zamanın milisaniye cinsinden zaman damgası. Görev henüz başlamadıysa bu özellik 0 olacaktır.
Bir zaman damgası, RFC 3339 standardını takip ederek 1 Ocak 1970 UTC'den bu yana geçen milisaniye sayısını temsil eder. Örneğin, 1 Eylül 2023 Cuma, GMT saatiyle 12:00:00, 1693569600000 olarak temsil edilir. Bu, Meshy API'deki tüm zaman damgaları için geçerlidir.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zamanın milisaniye cinsinden zaman damgası.
Name
expires_at
Type
timestamp
Description
Görev sonucunun süresinin dolduğu zamanın milisaniye cinsinden zaman damgası.
Name
finished_at
Type
timestamp
Description
Görevin tamamlandığı zamanın milisaniye cinsinden zaman damgası. Görev henüz tamamlanmadıysa bu özellik 0 olacaktır.
Name
status
Type
string
Description
Görevin durumu. Olası değerler PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED değerlerinden biridir.
Name
texture_urls
Type
array
Description
Görevden oluşturulan doku URL nesnelerinin bir dizisi. 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örseline indirilebilir URL.
- Name
  metallic
  Type
  string
  Description
  Metalik harita görseline indirilebilir URL.
  Görev enable_pbr: false ile oluşturulduysa bu özellik atlanır.
- Name
  normal
  Type
  string
  Description
  Normal harita görseline indirilebilir URL.
  Görev enable_pbr: false ile oluşturulduysa bu özellik atlanır.
- Name
  roughness
  Type
  string
  Description
  Pürüzlülük haritası görseline indirilebilir URL.
  Görev enable_pbr: false ile oluşturulduysa bu özellik atlanır.
- Name
  emission
  Type
  string
  Description
  Emisyon haritası görseline indirilebilir URL.
  Görev enable_pbr: false ile, ai_model değeri meshy-6-lite, meshy-7 veya latest ile ya da texture_resolution: 8k ile oluşturulduysa 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 mevcuttur.
Name
task_error
Type
object
Description
Başarısız görevler için hata ayrıntıları. task_error nesnesinin tam 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 mevcuttur. FAILED görevler için 0 döner (kredi, başarısızlık durumunda 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"
    }
  ],
  "preceding_tasks": 0,
  "task_error": {

    "message": ""

  },

  "consumed_credits": 10
}