Retexture API

Mevcut bir 3D model için metin tabanlı bir prompt 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

Retexture görevi oluşturma

Bir Retexture görevi oluşturur. Görev arka planda çalışır. Bir görevin genellikle ne kadar sürdüğü için bkz. İşlem süreleri.

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

# Retexture with Meshy N1 from front and back views
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",
    "ai_model": "meshy-n1",
    "multiview_image_urls": [
      "<your front view image url or data URI>",
      "<your back view image url or data URI>"
    ]
  }'

Response

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

Parametreler

Name
input_task_id
Type
string
Zorunlu
Description
model_url göndermediğiniz sürece gereklidir. Dokulandırılacak bir 3D model üreten bir görevin kimliği; örneğin bir Metinden 3D'ye, Görselden 3D'ye, Yeniden ağ veya Retexture görevi. Görev, API ile oluşturduğunuz ve durumu SUCCEEDED olan bir görev olmalıdır. Meshy, görevin GLB'sini dokulandırır.
meshy-n1 ile görevin modeli, üçgen olarak sayıldığında en fazla 7.999.999 yüze sahip olabilir (bir dörtgen 2 olarak sayılır).

Name
model_url
Type
string
Zorunlu
Description
input_task_id göndermediğiniz sürece gereklidir. Dokulandırılacak model; genel bir URL veya bir data URI olarak. İkisini 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 olan 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'den büyük 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, dolayısıyla 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 (binary) FBX 7.1 veya daha yeni olmalıdır.
- Bir GLB veya glTF dosyası Draco sıkıştırması kullanmamalıdır.
meshy-n1 ile model, dosya boyutu ne olursa olsun, üçgen olarak sayıldığında en fazla 7.999.999 yüze sahip olabilir (bir dörtgen 2 olarak sayılı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 anlatan, en fazla 800 karakterlik metin. Daha uzun metin 400 döndürür. meshy-n1 ile bunu image_style_url olmadan göndermek 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 izleyeceği bir 2D görsel; genel bir URL veya bir data URI olarak (data:image/jpeg;base64,<base64 kodlu görsel verileriniz>). Hem text_style_prompt hem de image_style_url gönderirseniz, Meshy image_style_url'yi kullanır.
Görsel, en fazla 20 MB boyutunda ve her kenarı en az 32 piksel olan bir .jpg, .jpeg, .png veya .webp dosyası olmalıdır.
Görseldeki nesnenin şekli modelden çok farklıysa doku iyi uymayabilir. meshy-n1 ile Meshy, görseli ön görünüm olarak ele alır.

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ı 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ına uyar, görsel başına en fazla 20 MB. multiview_image_urls'yi text_style_prompt veya image_style_url ile birleştiremezsiniz.
multiview_image_urls, açıkça meshy-7 veya meshy-n1 olarak belirtilen bir ai_model 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 üreten yapay zeka modeli.
Kullanılabilir değerler:
- meshy-6-lite
- meshy-6
- meshy-7
- meshy-n1: yalnızca referans görsellerden 2K temel renk dokusu. Metin promptu yok, PBR haritaları yok, 4K veya 8K yok. En fazla 7.999.999 yüz.
- latest: Meshy 7
Name
enable_original_uv
Type
boolean
varsayılan false
Description
Yeni bir tane üretmek yerine modelin UV yerleşimini koruyup korumayacağı.
- Meshy tarafından üretilen bir model için, input_task_id'den veya bir Meshy çıktısına işaret eden bir model_url'den geliyorsa, 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 yeni UV'ler üretmesine izin vermek için false bırakın; bu, düzgün UV eşlemesi olmayan bir model için uygundur.
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 üretilip üretilmeyeceği. meshy-6 ile Meshy, 8k dokuyla çözünürlük (texture_resolution) hariç, bir emisyon haritası da üretir. meshy-6-lite, meshy-7 ve latest emisyon haritası üretmez. meshy-n1 ile true göndermek 400 döndürür.
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 veya meshy-n1 ile 400 döndürürler. 8k'de Meshy emisyon haritası üretmez.
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. İkisini 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 ışıklandırmanız altında daha iyi çalışır.
Meshy bunu yalnızca meshy-6 ile, 2k veya 4k texture_resolution'da uygular. meshy-7 veya latest ile ya da 8k'de Meshy bunu kabul eder ancak yok sayar. meshy-6-lite veya meshy-n1 ile herhangi bir değerle göndermek 400 döndürür.
Name
target_formats
Type
string[]
Description
Üretilecek dosya biçimleri. Meshy yalnızca listelediğiniz biçimleri üretir, bu da görevi kısaltabilir. Belirtmezseniz, Meshy 3mf dışındaki her biçimi üretir.
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, saydam arka planlı (RGBA) bir önizlemenin de oluşturulup oluşturulmayacağı. thumbnail_url değişmez.

Dönüş değerleri

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

Hata durumları

Name
400 - Bad Request
Description
İstek çalıştırılamıyor. Hata mesajı hangi sorunun bulunduğunu belirtir. Örneğin:
- Eksik parametre: Ne model_url ne de input_task_id gönderilmedi.
- 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ça meshy-7 veya meshy-n1 olarak belirtilmiş bir ai_model olmadan gönderildi.
- Meshy N1 için desteklenmeyen seçenek: meshy-n1; enable_pbr: true, remove_lighting, 4k veya 8k bir texture_resolution, texture_resolution olmadan hd_texture: true, veya image_style_url olmadan text_style_prompt ile gönderildi.
- Meshy N1 için çok fazla üçgen: meshy-n1 ile, 3D model 7.999.999'dan fazla üçgene sahip. Üçgen sayısını azaltın veya başka bir ai_model kullanın.
- Meshy N1 için model çok karmaşık: meshy-n1 ile, model_url dosyası Meshy'nin üçgenlerini saymak için çok karmaşık. Üçgen sayısını azaltın, ardından dosyayı tekrar gönderin.
- Üçgen sayımı zaman aşımına uğradı: meshy-n1 ile, model_url dosyasının üçgenlerini saymak çok uzun sürdü. Tekrar deneyin veya modelin boyutunu azaltın.
- 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ının desteklenmeyen bir uzantısı var.
- 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ı, http veya https URL'sinden 400 MB'den büyük, ya da data URI olarak 100 MB'den büyük.
- Çok fazla yüz: model_url dosyası 100 MB'den büyük ve 10.000.000'dan fazla yüze sahip. Yüz sayısını azaltın, ardından dosyayı tekrar gönderin.
- 100 MB'den büyük ASCII FBX: model_url dosyası, 100 MB'den büyük bir ASCII FBX. Onu ikili (binary) FBX veya GLB olarak gönderin.
- Okunamayan model dosyası: model_url dosyası 100 MB'den büyük 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'den büyük 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'den büyük.
meshy-n1 ile, Meshy'nin görev başlamadan önce kontrol edemediği bir model (örneğin bir STL dosyası) burada reddedilmez. 7.999.999'dan fazla üçgene sahipse görev başarısız olur ve Meshy kredilerini iade eder.
İsteği düzeltin, ardından tekrar gönderin. Bkz. Hatalar.
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, ya da hesap bir kredi sınırına ulaştı. Kredi bakiyenizi kontrol edin, ardından tekrar deneyin.
- Ücretsiz plan: 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
Şunlardan biri geçerlidir:
- İçerik moderasyonu, promptu veya bir girdi görselini engelledi. Girdiyi değiştirin, ardından tekrar deneyin.
- input_task_id, bu uç noktanın yeniden dokulayamayacağı bir kabartma (bas-relief) modeldir. 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 herhangi 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. Bkz. Hız sınırları.

GET/openapi/v1/retexture/:id

Bir Yeniden dokulama görevini alma

Kimliğine göre bir Yeniden dokulama 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": null,

  "consumed_credits": 10
}

Parametreler

Name
id
Type
path
Description
Oluşturma yanıtından alınan görev kimliği.

Dönüş Değerleri

Yeniden dokulama görevi nesnesi.

DELETE/openapi/v1/retexture/:id

Yeniden dokulama görevini sil

Bir Yeniden dokulama görevini, modelleri ve verileri dahil olmak üzere 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, görevi oluştururken kullanılan kredileri iade eder.

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

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

Dönüşler

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

GET/openapi/v1/retexture

Yeniden dokulama görevlerini listele

Yeniden dokulama görevlerinizin 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"
      }
    ],
    "task_error": null,

    "consumed_credits": 10
  }
]

Parametreler

Name
page_num
Type
integer
varsayılan 1
Description
Döndürülecek sayfa numarası, 255'e kadar. Daha büyük bir değer 400 döndürür.
Name
page_size
Type
integer
varsayılan 10
Description
Sayfa başına görev sayısı, 100'e kadar.
Name
sort_by
Type
string
Description
Sıralama düzeni.
Kullanılabilir değerler:
- +created_at: önce en eski
- -created_at: önce en yeni

Döndürülenler

Yeniden dokulama görevi 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 Server-Sent Events (SSE) olarak akışla aktarır.

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

  "consumed_credits": 10
}

Parametreler

Name
id
Type
path
Description
Oluşturma yanıtından alınan görev kimliği.

Dönüş Değerleri

Yeniden dokulama görev nesnelerinin Server-Sent Events olarak bir akışı.

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

Yeniden dokulama görev nesnesi

Bir Yeniden dokulama görev nesnesi, bir 3D modelin tek bir yeniden dokulamasını 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"
    }
  ],
  "task_error": null,

  "consumed_credits": 10
}

Name
id
Type
string
Description
Görev ID'si. 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
Dokulandırılmış 3D model için indirme URL'leri, her dosya biçimi 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 dokuya sahipse 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 değeri 3mf içeriyorsa 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 görüntüsünün şeffaf arka planlı (RGBA) sürümü için indirme URL'si. Yalnızca görevi alpha_thumbnail: true ile oluşturduğunuzda ve Meshy şeffaf önizlemeyi oluşturduğunda 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 değerindedir.
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 dolacağı 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 tek bir nesne tutar. Her nesnenin şu alanları vardır:
- 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
  Yayılım 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 bir ai_model
  
  texture_resolution: 8k
Name
preceding_tasks
Type
integer
Description
Kuyrukta bu görevin önünde bulunan görev sayısı. Yalnızca görev PENDING durumundayken mevcuttur; değer 0 olduğunda alan dışarıda bırakılır.
Name
task_error
Type
object
Description
Görev başarısız olduğunda hata ayrıntıları. Hatalar bölümüne bakın.
Name
consumed_credits
Type
integer
Description
Görevin kullandığı kredi sayısı. Durum PENDING, IN_PROGRESS veya SUCCEEDED olduğunda mevcuttur. FAILED bir görev için 0 değerindedir, çünkü Meshy bir görev başarısız olduğunda kredileri iade eder.