Auto Split API

Bir 3D modeli ayrı ayrı yazdırabileceğiniz parçalara bölün. Meshy kesimleri kendisi belirler ya da belirttiğiniz parçalar veya renk bölgeleri boyunca keser ve bağlayıcılar ekleyebilir. Meshy, bir kesimin bıraktığı ince bölgeleri her zaman güçlendirir, böylece her parça dolu olarak yazdırılır.

Varsayılan olarak, bölünmüş model girdinin dokusunu korumaz. Dokulu bir modeli bölebilirsiniz, bu nedenle onu should_texture: false ile yeniden oluşturmanıza gerek yoktur. Meshy, kesilen parçaları yeniden oluşturur ve her birine düz bir köşe (vertex) rengi verir. Dokuyu her parçada korumak için keep_texture: true gönderin.

POST/openapi/v1/print/split

Auto Split görevi oluştur

Bir Auto Split görevi oluşturur. Bu görev, önceki bir görevin modelini ayrı ayrı yazdırabileceğiniz parçalara keser. Her parçanın dosya içinde ayrı bir nesne olduğu, bölünmüş modeli döndürür.

Görev arka planda çalışır. Bir görevin genellikle ne kadar sürdüğünü öğrenmek için İşlem süreleri sayfasına bakın.

Request

POST

/openapi/v1/print/split

# Simple request: let Meshy choose the cuts
curl https://api.meshy.ai/openapi/v1/print/split \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Advanced request: name the parts, keep the texture, add connectors, export glb and obj
curl https://api.meshy.ai/openapi/v1/print/split \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "mode": "by_parts",
    "prompt": "split into the figure and the base",
    "target_formats": ["glb", "obj"],
    "layout": "on_plate",
    "keep_texture": true,
    "connectors": true,
    "connector_type": "cylinder",
    "connector_size": 0.4
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

Parametreler

Name
input_task_id
Type
string
Zorunlu
Description
Modeli bölünecek olan görevin kimliği. Görevin durumu SUCCEEDED olmalıdır. Şu görev türleri çalışır:
- Görselden 3D'ye
- Çoklu görselden 3D'ye
- Metinden 3D'ye, bir preview veya refine görevi
- Yeniden dokulama
- Yeniden ağ
- Dönüştür
- Yeniden boyutlandır
Model, Meshy 6 veya Meshy 7 ile, yani ai_model değeri meshy-6-lite, meshy-6, meshy-7, meshy-7.1 veya latest olarak ayarlanmış şekilde oluşturulmuş olmalıdır. Smart Topology modelleri (meshy-t2 ve meshy-t2.5) desteklenmez. Bir refine, Yeniden dokulama, Yeniden ağ, Dönüştür veya Yeniden boyutlandır görevi için bu kural, görevin başladığı modele uygulanır. Yüklenen bir modelden yapılan Yeniden dokulama, Yeniden ağ, Dönüştür veya Yeniden boyutlandır görevi 400 döndürür.
Model en fazla 8.000.000 yüze sahip olabilir. Daha fazla yüze sahip bir model 400 döndürür. Bu durumda önce model üzerinde bir Yeniden ağ görevi çalıştırın ve bunun yerine Yeniden ağ görevinin kimliğini gönderin.
Dokulu bir modeli bölebilirsiniz. Dokuyu parçalarda korumak için keep_texture: true gönderin.

Name
mode
Type
string
varsayılan auto
Description
Modelin parçalara nasıl bölüneceği.
Kullanılabilir değerler:
- auto: Meshy kesimleri kendisi seçer ve prompt değerini yok sayar. 600 karakterden uzun bir prompt yine de 400 döndürür.
- by_parts: Meshy, prompt içinde belirttiğiniz yapısal parçalar boyunca keser, örneğin kafa, kollar ve gövde.
- by_color: Meshy, prompt içinde belirttiğiniz renk bölgeleri boyunca keser. Meshy bu bölgeleri, girdi modelin dokusunda değil, kaynak görselde bulur. Girdi, yüklenen bir görselden Görselden 3D'ye veya Çoklu görselden 3D'ye ile oluşturulmuş olmalıdır. Diğer girdiler 400 döndürür. Çoklu görselden 3D'ye için Meshy, ilk kaynak görseli kullanır.

Yalnızca şu durumlarda geçerli mode = by_parts or by_color

Name
prompt
Type
string
Zorunlu
Description
Modelin bölüneceği parçalar, herhangi bir dilde, 600 karaktere kadar. Daha uzun metin, mode değeri auto olsa bile 400 döndürür.
Meshy, prompt'tan 1 ila 10 parça adı okur, bu yüzden modeli tanımlamak yerine parçaları adlandırın. Örneğin, figürü ve tabanı ayır veya kafa, gövde, sol kol, sağ kol, bacaklar. Tek bir parça adlandırabilirsiniz. Adlandırmadığınız her şey bir parça daha oluşturur, bu yüzden kafa, web uygulamasında olduğu gibi modeli kafa ve geri kalanı olarak böler.
Hiçbir bölme istemeyen veya 10'dan fazla parça adlandıran bir prompt 400 döndürür ve Meshy bunun için ücret almaz.
Meshy, prompt'tan herhangi bir parça adı okuyamazsa, bunun yerine modelin referans görselini kullanır. Seçtiğiniz mode'da, orada bulduğu parçalar boyunca böler. Görev yine de çalışır, Meshy bunun için ücret alır ve görevde prompt_ignored: true olur. Modelin referans görseli yoksa veya Meshy içinde 2'den az parça bulursa, istek 400 döndürür ve Meshy bunun için ücret almaz.

Name
target_formats
Type
array
varsayılan ["glb"]
Description
Oluşturulacak dosya formatları. Meshy her zaman glb oluşturur ve bunu model_urls içinde döndürür, listelediğiniz diğer formatlara ek olarak.
Kullanılabilir değerler:
- glb
- obj
- fbx
- stl
- usdz
- blend
- 3mf
stl dışındaki her format sahne nesnelerini destekler ve her parçayı ayrı bir nesne olarak tutar. Bir STL dosyası ayrı nesneleri tutamaz, bu yüzden Meshy parçaları layout tarafından düzenlenmiş tek bir katıda birleştirir. Bir dilimleyicide ayrı ayrı seçebileceğiniz parçalar almak için 3mf isteyin.
keep_texture: true ile şu formatlar dokuyu tutar:
- glb, fbx, usdz ve blend: Doku dosyanın içindedir.
- obj: Doku, model_urls içinde mtl altında döndürülen malzeme dosyasındadır.
- stl ve 3mf: Dosya yalnızca geometri tutar, doku olmadan.
Name
layout
Type
string
varsayılan assembled
Description
Meshy'nin parçaları her dosya formatında ve küçük resimde nasıl düzenlediği.
Kullanılabilir değerler:
- assembled: Meshy, parçaları kaynak modelde oldukları yerde tutar.
- on_plate: Meshy, parçaları düz yatırır ve dilimlemeye hazır şekilde yapı tablasına yayar. Bu, web uygulamasındaki On Plate görünümüyle aynı düzendir.
Her iki düzende de Meshy, dışa aktarmadan önce bir kesimin bıraktığı çökmüş ince veya nokta benzeri parçaları kaldırır, böylece elde ettiğiniz her parça basılabilir olur. Sahne nesnelerini destekleyen formatlar parça başına bir nesne tutar ve stl parçaları tek bir katıda birleştirir.
Name
keep_texture
Type
boolean
varsayılan false
Description
Girdi modelin dokusunun parçalarda korunup korunmayacağı. true, her parçaya girdinin dokusunu verir ve görev haritaları texture_urls içinde döndürür. false, her parçaya düz bir köşe (vertex) rengi verir.
true ile görev yaklaşık iki kat uzun sürer ve kredi maliyeti değişmez. Dokusuz bir girdi, false ile aynı şekilde bölünür. Meshy dokuyu koruyamazsa, görev textured_split_refused hata koduyla başarısız olur. Bkz. Hatalar.
Name
connectors
Type
boolean
varsayılan false
Description
Basılan parçaların birbirine oturması için her kesimde geçme (zıvana) bağlantı parçaları eklenip eklenmeyeceği.

Yalnızca şu durumlarda geçerli connectors = true

Name
connector_type
Type
string
varsayılan cube
Description
Her kesim yüzeyindeki bağlantı parçasının şekli, cube veya cylinder.
Name
connector_size
Type
number
varsayılan 0.5
Description
Bağlantı parçasının boyutu, kesim yüzeyine göre, 0.1 ile 0.8 arasında. Bu aralığın dışındaki bir değer, connectors değeri false olsa bile 400 döndürür.
Name
connector_height
Type
number
varsayılan 0.1
Description
Bağlantı parçasının kesim yüzeyinden ne kadar dışarı çıktığı, kesim yüzeyine göre, 0.1 ile 0.8 arasında. Bu aralığın dışındaki bir değer, connectors değeri false olsa bile 400 döndürür.

Dönüş değerleri

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

Başarısızlık durumları

Name
400 - Bad Request
Description
İstek çalıştırılamıyor. Hata mesajı hangi sorunu bulduğunu söyler. Örneğin:
- Eksik prompt: mode değeri by_parts veya by_color ve prompt eksik.
- Prompt hiçbir bölme istemiyor veya çok fazla parça adlandırıyor: Prompt, modeli tek parça halinde tutmayı istiyor veya 10'dan fazla parça adlandırıyor. by_parts ve by_color, 1 ila 10 adlandırılmış parça kabul eder. Meshy bu istek için ücret almaz.
- Desteklenmeyen girdi görevi: input_task_id, Meshy 6 veya Meshy 7 ile oluşturulmuş, desteklenen bir türde başarılı bir görev değil.
- Referans görsel yok: mode değeri by_color ve girdi, yüklenen bir görselden oluşturulmamış.
- Aralık dışı bağlantı parçası: connector_size veya connector_height, 0.1 ile 0.8 aralığının dışında.
İsteği düzeltin, ardından yeniden 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 veya hesap bir kredi sınırına ulaştı. Kredi bakiyenizi kontrol edin, ardından yeniden deneyin.
- Ücretsiz plan: Görev oluşturmak ücretli bir plan gerektirir. Abonelik ayarlarınızda planınızı yükseltin, ardından yeniden deneyin.
Name
403 - Forbidden
Description
Şunlardan biri geçerlidir:
- İçerik moderasyonu prompt'u engelledi. Mesaj explicit content veya prohibited content şeklindedir. Prompt'u değiştirin, ardından yeniden deneyin.
- input_task_id, bu uç noktanın bölemeyeceği bir kabartma (bas-relief) modelidir. Mesaj This model type does not support this operation şeklindedir. Farklı bir model gönderin.
Name
404 - Not Found
Description
input_task_id mevcut değil veya hesabınıza ait değil. Kimliği kontrol edin ve görevi oluşturan hesaba ait bir API anahtarı kullanın.
Name
429 - Too Many Requests
Description
Hız sınırınızı aştınız. Bekleyin, ardından yeniden deneyin. Bkz. Hız sınırları.
by_parts ve by_color istekleri ayrıca, hesap başına dakikada 12 istek olan bir prompt okuma sınırını paylaşır.
Name
503 - Service Unavailable
Description
Prompt'a göre bölme (by_parts ve by_color) geçici olarak kullanılamıyor. Daha sonra yeniden deneyin veya yine çalışan mode: "auto" gönderin. Meshy bu istek için ücret almaz.

GET/openapi/v1/print/split/:id

Bir Auto Split görevini alın

Kimliğine (ID) göre bir Auto Split görevini döndürür.

Request

GET

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

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

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-split",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_metallic.png?Expires=***",
      "normal": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_normal.png?Expires=***",
      "roughness": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_roughness.png?Expires=***"
    }
  ],
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "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

Auto Split görev nesnesi.

DELETE/openapi/v1/print/split/:id

Bir Auto Split görevini sil

Bir Auto Split görevini, modelleri ve verileri dahil olmak üzere kalıcı olarak siler. Bir silme işlemini geri alamazsınız.

Request

DELETE

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

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/split/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öndürür ve görev çalışmaya devam eder. Meshy, başlamış olan bir görev için iade yapmaz, bu yüzden görevi silmek size hem kredileri 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öndürülenler

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

GET/openapi/v1/print/split

Auto Split görevlerini listele

Auto Split görevlerinizin bir listesini döndürür.

Request

GET

/openapi/v1/print/split

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-split",
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "part_count": 4,
    "progress": 100,
    "status": "SUCCEEDED",
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000082000,
    "task_error": null,
    "consumed_credits": 10
  }
]

Parametreler

Name
page_num
Type
integer
Description
Döndürülecek sayfa numarası. 1'den başlar ve varsayılan değeri 1'dir.
Name
page_size
Type
integer
Description
Sayfa başına görev sayısı, en fazla 100. Varsayılan değeri 10'dur. Meshy, daha büyük bir değeri 100 olarak işler.
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

Auto Split görev nesnelerinin sayfalanmış bir listesi.

GET/openapi/v1/print/split/:id/stream

Auto Split görevini akış olarak alma

Bir Auto Split görevinin güncellemelerini Server-Sent Events (SSE) olarak akışa alır.

Request

GET

/openapi/v1/print/split/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream

curl -N https://api.meshy.ai/openapi/v1/print/split/a43b5c6d-7e8f-901a-234b-567c890d1e2f/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 (other task fields omitted here for brevity;
// each frame is the full task object).
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-split",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "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

Server-Sent Events olarak Auto Split görev nesnelerinin bir akışı.

Her message olayı, Bir Auto Split görevini al işleminin döndürdüğüyle aynı olan tam görev nesnesini içerir. Buna consumed_credits, zaman damgaları ve prompt_ignored dahildir. Görev PENDING veya IN_PROGRESS durumundayken, olaylar arasında değişen alanlar progress, status, started_at ve preceding_tasks'tır. Görev SUCCEEDED durumuna ulaştığında model_urls ve thumbnail_url değerlerini alır ve part_count görünür.

Bir error olayı yalnızca status_code ve message içerir, bu nedenle status alanını okumadan önce olay adını kontrol edin.

Auto Split görev nesnesi

Bir Auto Split görev nesnesi, bir 3D modelin bölünmesini tanımlar. Durumu, progress'i ve görev başarılı olduğunda parça dosyalarını tutar.

Diğer görev nesnelerinin prompt alanlarını, örneğin name, object_prompt ve texture_prompt alanlarını içermez. Ayrıca tek bir model_url değeri de yoktur. thumbnail_url, model_urls ve zaman damgaları, görev ilerledikçe doldurulur. Bunlar her zaman mevcuttur ve değer alana kadar boştur.

The Auto Split Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-split",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0.png?Expires=***",
      "metallic": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_metallic.png?Expires=***",
      "normal": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_normal.png?Expires=***",
      "roughness": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/texture_0_roughness.png?Expires=***"
    }
  ],
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "task_error": null,
  "consumed_credits": 10
}

Name
id
Type
string
Description
Görev kimliği. Bunu anlamsız bir dize olarak kabul edin ve biçimine güvenmeyin.
Name
type
Type
string
Description
Görev türü, her zaman print-split.
Name
model_urls
Type
object
Description
Bölünmüş model için indirme URL'leri, istediğiniz her format için bir tane. İstemediğiniz bir formatın anahtarı yoktur. Sahne nesnelerini destekleyen formatlar her parçayı ayrı bir nesne olarak tutar ve stl parçaları tek bir katı nesnede birleştirir.
- Name
  glb
  Type
  string
  Description
  GLB dosyası.
- Name
  obj
  Type
  string
  Description
  OBJ dosyası.
- Name
  mtl
  Type
  string
  Description
  MTL dosyası. keep_texture değeri true olduğunda ve giriş modeli dokulu olduğunda bir OBJ dosyasıyla birlikte bulunur.
- Name
  fbx
  Type
  string
  Description
  FBX dosyası.
- Name
  stl
  Type
  string
  Description
  Tüm parçaların tek bir katı nesnede birleştirildiği STL dosyası. Ayrı ayrı seçebileceğiniz parçalar elde etmek için 3mf isteyin.
- Name
  usdz
  Type
  string
  Description
  USDZ dosyası.
- Name
  blend
  Type
  string
  Description
  Blender dosyası.
- Name
  3mf
  Type
  string
  Description
  3MF dosyası.
Name
thumbnail_url
Type
string
Description
İstediğiniz layout düzeninde, bölünmüş modelin önizleme görseli için indirme URL'si. Parçalar bir dokuyu koruduğunda, önizleme bunu gösterir. Aksi takdirde, her parçanın kendi rengi vardır.
Name
texture_urls
Type
array
Description
Bölünmüş modelin doku haritaları, tek bir nesne içeren bir dizi olarak. Tüm parçalar bu haritaları paylaşır. Yalnızca keep_texture değeri true olduğunda ve giriş modeli dokulu olduğunda 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. Giriş modelinde metalik harita yoksa bulunmaz.
- Name
  normal
  Type
  string
  Description
  Normal harita için indirme URL'si. Giriş modelinde normal harita yoksa bulunmaz.
- Name
  roughness
  Type
  string
  Description
  Pürüzlülük haritası için indirme URL'si. Giriş modelinde pürüzlülük haritası yoksa bulunmaz.
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örev başarılı olduktan sonra, Meshy şeffaf önizlemeyi oluşturduğunda bulunur.
Name
prompt_ignored
Type
boolean
Description
Meshy'nin prompt'u yoksayıp yoksamadığı. Bir by_parts veya by_color isteğinin prompt alanı hiçbir parça adı belirtmediğinde true olur; bu durumda Meshy modeli otomatik olarak böler. Sonuçtaki parça adları bu durumda sizin değil, Meshy'nin verdiği adlardır. PENDING durumundan itibaren bulunur. Meshy, auto görevlerinde ve prompt'u takip ettiği her durumda bu alanı dışarıda bırakır.
Name
part_count
Type
integer
Description
Bölme işleminin ürettiği yazdırılabilir parça sayısı. Sahne nesnelerini destekleyen formatlar, parça başına bir nesne tutar. stl parçaları tek bir katı nesnede birleştirir, ancak part_count yine de bunları sayar. Dışa aktarmadan önce Meshy, yazdırılabilir bir parça haline gelemeyecek kadar çökmüş ince parçaları kaldırır ve bunları saymaz.
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ğerini alır.
Name
status
Type
string
Description
Görev durumu; PENDING, IN_PROGRESS, SUCCEEDED, FAILED veya CANCELED değerlerinden biri.
Name
preceding_tasks
Type
integer
Description
Kuyrukta bu görevden önce gelen görevlerin sayısı. Bu değer yalnızca görev PENDING durumundayken anlamlıdır.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zaman, Unix milisaniye cinsinden.
Name
started_at
Type
timestamp
Description
Görevin başladığı zaman, Unix milisaniye cinsinden. Görev başlayana kadar 0 değerindedir.
Name
finished_at
Type
timestamp
Description
Görevin tamamlandığı zaman, Unix milisaniye cinsinden. Görev tamamlanana kadar 0 değerindedir.
Name
expires_at
Type
timestamp
Description
Görevin sonucunun süresinin dolacağı zaman, Unix milisaniye cinsinden. Görev tamamlanana kadar 0 değerindedir.
Name
task_error
Type
object
Description
Görev başarısız olduğunda hata ayrıntıları. Bkz. Hatalar.
Bir güvenlik kontrolü giriş modelini reddederse, görev task_error.type değeri invalid_input ve task_error.code değeri provider_content_refused olarak ayarlanmış şekilde başarısız olur. Farklı bir model gönderin. Bkz. Hatalar.
keep_texture: true ile, Meshy dokuyu koruyamıyorsa, görev task_error.code değeri textured_split_refused olarak ayarlanmış şekilde başarısız olur. Bkz. Hatalar.
Name
consumed_credits
Type
integer
Description
Görevin kullandığı kredi sayısı. Her zaman bulunur. Meshy görevi kabul ettikten sonra 10 değerindedir ve FAILED bir görev için 0 değerindedir, çünkü Meshy bir görev başarısız olduğunda kredileri iade eder. PENDING durumundaki bir görevi silmek de krediyi iade eder.