Yeniden Dokulama API'si

Mevcut bir 3D model için bir metin promptundan veya referans görsellerden yeni dokular oluşturun. Model, başka bir Meshy görevinden veya bir model dosyasından gelebilir.

POST/openapi/v1/retexture

Bir Yeniden dokulama görevi oluşturma

Bir Yeniden dokulama görevi oluşturur. Görev arka planda çalışır. Bir görevin genellikle ne kadar sürdüğü için İşlem süreleri bölümüne bakın.

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"
}

Parametreler

Name
input_task_id
Type
string
Zorunlu
Description
model_url göndermediğiniz sürece gereklidir. Dokulanacak bir 3D model üreten bir görevin kimliği, örneğin bir Metinden 3D'ye, Görselden 3D'ye, Yeniden ağ veya Yeniden dokulama görevi. Görev, API ile oluşturduğunuz ve durumu SUCCEEDED olan bir görev olmalıdır. Meshy, görevin GLB'sini dokular.

Name
model_url
Type
string
Zorunlu
Description
input_task_id göndermediğiniz sürece gereklidir. Dokulanacak model, genel bir URL veya bir data URI olarak. Her ikisini de gönderirseniz Meshy input_task_id'yi kullanır.
Model, bir http veya https URL'sinden en fazla 400 MB, ya da data URI olarak en fazla 100 MB büyüklüğünde bir GLB, glTF, OBJ, FBX veya STL dosyası olmalıdır. Data URI için application/octet-stream MIME type'ını kullanın, örneğin data:application/octet-stream;base64,<base64 kodlu model verileriniz>.
100 MB'ın üzerindeki bir dosya ayrıca şu kurallara da uymalıdır:
- Bir GLB, glTF, FBX veya OBJ dosyası en fazla 10.000.000 yüze sahip olabilir. Meshy, yüzleri üçgen olarak sayar, bu nedenle bir dörtgen 2 olarak sayılır ve birden fazla kez çizilen bir ağ her kopya için bir kez sayılır.
- Bir FBX dosyası, ikili FBX 7.1 veya daha yeni bir sürüm olmalıdır.
- Bir GLB veya glTF dosyası Draco sıkıştırması kullanmamalıdır.

Bu üç stil girdisinden birini gönderin.

Name
text_style_prompt
Type
string
Zorunlu
Description
image_style_url veya multiview_image_urls göndermediğiniz sürece gereklidir. İstediğiniz dokuyu açıklayan, en fazla 800 karakterlik metin. Daha uzun metin 400 döndürür.

Name
image_style_url
Type
string
Zorunlu
Description
text_style_prompt veya multiview_image_urls göndermediğiniz sürece gereklidir. Dokunun stilini takip edeceği bir 2D görsel, genel bir URL veya bir data URI (data:image/jpeg;base64,<base64 kodlu görsel verileriniz>) olarak. Hem text_style_prompt hem de image_style_url gönderirseniz Meshy image_style_url'yi kullanır.
Görsel, en fazla 20 MB büyüklüğünde bir .jpg, .jpeg, .png veya .webp dosyası olmalıdır.
Görseldeki nesnenin şekli modelden çok farklıysa doku iyi oturmayabilir.

Name
multiview_image_urls
Type
string[]
Zorunlu
Description
text_style_prompt veya image_style_url göndermediğiniz sürece gereklidir. Aynı nesnenin farklı açılardan bir ile dört arasında görseli. İlk görsel ana (ön) görünümdür. Diğer görünümlerin (sol, arka, sağ) sırası önemli değildir. Boş bir dizi veya dörtten fazla görsel 400 döndürür.
Her görsel, image_style_url ile aynı biçim ve boyut kurallarını izler, görsel başına en fazla 20 MB. multiview_image_urls'i text_style_prompt veya image_style_url ile birleştiremezsiniz.
multiview_image_urls, açık bir "ai_model": "meshy-7" gerektirir. Varsayılan latest dahil olmak üzere başka herhangi bir ai_model, 400 döndürür.

Name
ai_model
Type
string
varsayılan latest
Description
Dokuyu oluşturan yapay zeka modeli.
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 tane oluşturmak yerine modelin UV yerleşiminin korunup korunmayacağı.
- Meshy'nin oluşturduğu bir model için, input_task_id'den veya bir Meshy çıktısını işaret eden bir model_url'den, optimize edilmiş UV yerleşimini yeniden kullanmak için true kullanın.
- Başka bir yerden yüklediğiniz bir model için, zaten iyi olan UV'leri korumak amacıyla true kullanın. Meshy'nin uygun UV eşlemesi olmayan bir modele uygun yeni UV'ler oluşturmasına izin vermek için false bırakın.
Name
enable_pbr
Type
boolean
varsayılan false
Description
Temel renkle birlikte PBR haritalarının (metalik, pürüzlülük ve normal) da oluşturulup oluşturulmayacağı. meshy-6 ile Meshy, 8k doku çözünürlüğü hariç, bir emisyon haritası da oluşturur. meshy-6-lite, meshy-7 ve latest emisyon haritası oluşturmaz.
Name
texture_resolution
Type
string
varsayılan 2k
Description
Temel renk dokusunun boyutu. Daha yüksek çözünürlükler daha fazla yüzey ayrıntısı yakalar.
Kullanılabilir değerler:
- 2k: 2048 × 2048 piksel
- 4k: 4096 × 4096 piksel
- 8k: 8192 × 8192 piksel
4k ve 8k, meshy-6, meshy-7 veya latest bir ai_model gerektirir. meshy-6-lite ile 400 döndürürler. 8k'de Meshy bir emisyon haritası oluşturmaz.
Name
hd_texture
Type
boolean
⚠ kullanımdan kaldırıldı
varsayılan false
Description
Bunun yerine texture_resolution kullanın. true, texture_resolution: "4k" ile aynıdır. Her ikisini de gönderirseniz Meshy texture_resolution'ı kullanır.
Name
remove_lighting
Type
boolean
varsayılan true
Description
Temel renk dokusundan vurguların ve gölgelerin kaldırılıp kaldırılmayacağı. Sonuç, kendi aydınlatmanız altında daha iyi çalışır.
Meshy bunu yalnızca meshy-6 ile, 2k veya 4k doku çözünürlüğünde uygular. meshy-7 veya latest ile, ya da 8k'de, Meshy bunu kabul eder ve yok sayar. meshy-6-lite ile, herhangi bir değerle gönderilmesi 400 döndürür.
Name
target_formats
Type
string[]
Description
Oluşturulacak dosya biçimleri. Meshy yalnızca listelediğiniz biçimleri oluşturur, bu da görevi kısaltabilir. Bunu belirtmezseniz Meshy, 3mf dışındaki her biçimi oluşturur.
Kullanılabilir değerler:
- glb
- obj
- fbx
- stl
- usdz
- 3mf
Name
alpha_thumbnail
Type
boolean
varsayılan false
Description
Görevi aldığınızda alpha_thumbnail_url içinde döndürülen, şeffaf arka planlı (RGBA) bir önizlemenin de işlenip işlenmeyeceği. thumbnail_url değişmez.

Döndürülenler

Yanıtın result alanı, yeni Yeniden dokulama görevinin kimliğini tutar.

Hata durumları

Name
400 - Bad Request
Description
İstek çalıştırılamıyor. Hata mesajı hangi sorunu bulduğunu söyler. Örneğin:
- Eksik parametre: Ne model_url ne de input_task_id gönderildi.
- Eksik stil: text_style_prompt, image_style_url ve multiview_image_urls'den hiçbiri gönderilmedi.
- Çakışan stil girdileri: multiview_image_urls, text_style_prompt veya image_style_url ile birlikte gönderildi.
- Çoklu görünüm için desteklenmeyen model: multiview_image_urls, açık bir "ai_model": "meshy-7" olmadan gönderildi.
- Geçersiz girdi görevi: input_task_id, desteklenen bir türün başarılı bir görevi değil.
- Geçersiz model biçimi: model_url dosyası desteklenmeyen bir uzantıya sahip.
- Erişilemeyen URL: Meshy, model_url dosyasını, image_style_url görselini veya bir multiview_image_urls görselini indiremiyor.
- Model dosyası çok büyük: model_url dosyası bir http veya https URL'sinden 400 MB'ın üzerinde, ya da data URI olarak 100 MB'ın üzerinde.
- Çok fazla yüz: model_url dosyası 100 MB'ın üzerinde ve 10.000.000'dan fazla yüze sahip. Yüz sayısını azaltın, ardından dosyayı tekrar gönderin.
- 100 MB'ın üzerinde ASCII FBX: model_url dosyası 100 MB'ın üzerinde bir ASCII FBX. Onu ikili FBX veya GLB olarak gönderin.
- Okunamayan model dosyası: model_url dosyası 100 MB'ın üzerinde ve Meshy başlığını okuyamıyor. Örneğin, Draco sıkıştırmalı bir GLB veya glTF, ya da 7.1'den eski bir ikili FBX.
- Model başlığı çok karmaşık: model_url dosyası 100 MB'ın üzerinde ve başlığında kontrol edilecek çok fazla ağ, düğüm veya kayıt var. Dosyadaki nesne sayısını azaltın, ardından tekrar gönderin.
- Görsel çok büyük: image_style_url görseli veya bir multiview_image_urls görseli 20 MB'ın üzerinde.
İsteği düzeltin, ardından tekrar gönderin. Hatalar bölümüne bakın.
Name
401 - Unauthorized
Description
API anahtarı eksik veya geçersiz. Authorization başlığını kontrol edin.
Name
402 - Payment Required
Description
Örneğin:
- Yetersiz kredi: Hesapta bu görev için yeterli kredi yok veya hesap bir kredi sınırına ulaştı. Kredi bakiyenizi kontrol edin, ardından tekrar deneyin.
- Ücretsiz plan: Bir görev oluşturmak ücretli bir plan gerektirir. Abonelik ayarlarınızdan planınızı yükseltin, ardından tekrar deneyin.
Name
403 - Forbidden
Description
input_task_id, bu uç noktanın yeniden dokulayamayacağı bir kabartma modelidir. Mesaj This model type does not support this operation şeklindedir. Farklı bir model gönderin.
Name
404 - Not Found
Description
input_task_id, görevlerinizden hiçbiriyle eşleşmiyor. Görev kimliğini kontrol edin, ardından isteği tekrar gönderin.
Name
429 - Too Many Requests
Description
Hız sınırınızı aştınız. Bekleyin, ardından tekrar deneyin. Hız sınırları bölümüne bakın.

GET/openapi/v1/retexture/:id

Retexture görevini alma

Belirtilen ID'ye sahip Retexture görevini döndürür.

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
}

Parametreler

Name
id
Type
path
Description
Oluşturma yanıtından alınan görev ID'si.

Döndürülenler

Retexture görev nesnesi.

DELETE/openapi/v1/retexture/:id

Bir Yeniden dokulama görevini sil

Bir Yeniden dokulama görevini, modelleri ve verileriyle birlikte kalıcı olarak siler. Bir silme işlemini geri alamazsınız.

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 keeps 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."
}

Yol parametreleri

Name
id
Type
path
Description
Silinecek görevin kimliği.

Görev durumu

PENDING durumundaki bir görevi silmek, oluşturulduğunda kullandığı kredileri iade eder.

IN_PROGRESS durumundaki bir görev silinemez. İstek 409 Conflict döndürür ve görev çalışmaya devam eder. Meshy, başlamış olan bir görev için iade yapmaz, bu nedenle bu görevi silmek size hem kredilerinizi hem de sonucu kaybettirir. Görevin SUCCEEDED, FAILED veya CANCELED durumuna ulaşmasını bekleyin, ardından silin.

Nihai bir durumdaki (SUCCEEDED, FAILED veya CANCELED) bir görevi silmek kredilerini iade etmez.

Dönüş değerleri

Görev silindiğinde 200 OK, görev IN_PROGRESS durumundayken 409 Conflict döner.

GET/openapi/v1/retexture

Retexture görevlerini listele

Retexture görevlerinizin bir listesini 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
  }
]

Parametreler

Name
page_num
Type
integer
varsayılan 1
Description
Döndürülecek sayfa numarası.
Name
page_size
Type
integer
varsayılan 10
Description
Sayfa başına görev sayısı, en fazla 100.
Name
sort_by
Type
string
Description
Sıralama düzeni.
Kullanılabilir değerler:
- +created_at: en eskiden en yeniye
- -created_at: en yeniden en eskiye

Döndürülenler

Retexture görev nesnelerinin sayfalandırılmış bir listesi.

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

Bir Yeniden dokulama görevini akışla al

Bir Yeniden dokulama görevinin güncellemelerini Sunucu Tarafından Gönderilen Olaylar (SSE) olarak akışla iletir.

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.
// These examples are shortened. Each event holds the full task object.
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
}

Parametreler

Name
id
Type
path
Description
Oluşturma yanıtından alınan görev ID'si.

Dönüş Değerleri

Yeniden dokulama görev nesnelerinin Sunucu Tarafından Gönderilen Olaylar (SSE) olarak akışı.

Her olay, Get uç noktasının döndürdüğü biçimle aynı şekilde, görev nesnesinin tamamını içerir. Görev PENDING veya IN_PROGRESS durumundayken, sonuç alanlarının henüz değeri yoktur.

Yeniden dokulama görev nesnesi

Bir Yeniden dokulama görev nesnesi, bir 3D modelin tek bir yeniden dokulama işlemini tanımlar. Görev başarılı olduğunda durumu, progress'i ve model ile doku dosyalarını tutar.

Özellikler

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
}

Name
id
Type
string
Description
Görev kimliği. Bunu opak bir dize olarak kabul edin ve biçimine güvenmeyin.
Name
type
Type
string
Description
Görev türü, her zaman retexture.
Name
model_urls
Type
object
Description
Dokulu 3D model için indirme URL'leri, her dosya formatı için bir tane.
- Name
  glb
  Type
  string
  Description
  GLB dosyası.
- Name
  fbx
  Type
  string
  Description
  FBX dosyası.
- Name
  obj
  Type
  string
  Description
  OBJ dosyası.
- Name
  usdz
  Type
  string
  Description
  USDZ dosyası.
- Name
  mtl
  Type
  string
  Description
  MTL dosyası. Meshy, model dokulara sahip olduğunda bunu OBJ dosyasıyla birlikte döndürür.
- Name
  stl
  Type
  string
  Description
  STL dosyası.
- Name
  3mf
  Type
  string
  Description
  3MF dosyası. Yalnızca target_formats içinde 3mf bulunduğunda mevcuttur.
Name
text_style_prompt
Type
string
Description
Görevi oluştururken kullandığınız metin prompt'u.
Name
image_style_url
Type
string
Description
Görevi oluştururken kullandığınız stil görseli.
Name
multiview_image_urls
Type
string[]
Description
Görevi oluştururken kullandığınız çoklu görünüm referans görselleri için indirme URL'leri. Yalnızca görevi multiview_image_urls ile oluşturduğunuzda mevcuttur.
Name
thumbnail_url
Type
string
Description
Modelin küçük resmi için indirme URL'si.
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url değerinin şeffaf arka planlı (RGBA) bir sürümü için indirme URL'si. Yalnızca görevi alpha_thumbnail: true ile oluşturduğunuzda ve Meshy şeffaf önizlemeyi render ettiğinde mevcuttur.
Name
progress
Type
integer
Description
Görevin ne kadarının tamamlandığı, yüzde olarak. Görev başlayana kadar 0, başarılı olduğunda 100 olur.
Name
started_at
Type
timestamp
Description
Görevin başladığı zaman, Unix milisaniye cinsinden. Görev başlayana kadar 0 değerindedir.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zaman, Unix milisaniye cinsinden.
Name
expires_at
Type
timestamp
Description
Görevin sonuçlarının süresinin dolduğu zaman, Unix milisaniye cinsinden.
Name
finished_at
Type
timestamp
Description
Görevin tamamlandığı zaman, Unix milisaniye cinsinden. Görev tamamlanana kadar 0 değerindedir.
Name
status
Type
string
Description
Görev durumu, PENDING, IN_PROGRESS, SUCCEEDED, FAILED veya CANCELED değerlerinden biri.
Name
texture_urls
Type
array
Description
Oluşturulan dokular için indirme URL'leri, bir nesne dizisi olarak. Dizi genellikle bir nesne tutar. Her nesnede şu alanlar bulunur:
- Name
  base_color
  Type
  string
  Description
  Temel renk haritası için indirme URL'si.
- Name
  metallic
  Type
  string
  Description
  Metalik harita için indirme URL'si. Meshy, görevi enable_pbr: false ile oluşturduğunuzda bu alanı dışarıda bırakır.
- Name
  normal
  Type
  string
  Description
  Normal harita için indirme URL'si. Meshy, görevi enable_pbr: false ile oluşturduğunuzda bu alanı dışarıda bırakır.
- Name
  roughness
  Type
  string
  Description
  Pürüzlülük haritası için indirme URL'si. Meshy, görevi enable_pbr: false ile oluşturduğunuzda bu alanı dışarıda bırakır.
- Name
  emission
  Type
  string
  Description
  Emisyon haritası için indirme URL'si. Meshy, görevi aşağıdakilerden herhangi biriyle oluşturduğunuzda bu alanı dışarıda bırakır:
  
  enable_pbr: false
  
  meshy-6-lite, meshy-7 veya latest olan bir ai_model
  
  texture_resolution: 8k
Name
preceding_tasks
Type
integer
Description
Kuyrukta bu görevden önce bulunan görevlerin sayısı. Yalnızca görev PENDING durumundayken mevcuttur.
Name
task_error
Type
object
Description
Görev başarısız olduğunda hata ayrıntıları. Bkz. Hatalar.
Name
consumed_credits
Type
integer
Description
Görevin kullandığı kredi sayısı. Durum PENDING, IN_PROGRESS veya SUCCEEDED olduğunda mevcuttur. Bir FAILED görev için 0 değerindedir, çünkü Meshy bir görev başarısız olduğunda kredileri iade eder.