Basılabilirliği Onar API

Bir 3D modeli basılabilirlik için onarın — manifold olmayan kenarları, bozuk yüzeyleri, delikleri ve diğer topology sorunlarını düzeltin, böylece ağ baskıya hazır hale gelir. İsteğe bağlı olarak, basmayı planladığınız boyutta çok ince olan duvarları da kalınlaştırın.

POST/openapi/v1/print/repair

Basılabilirliği Onarma Görevi Oluşturma

Bu uç nokta, yeni bir basılabilirliği onarma görevi oluşturur. Görev, bir 3D model üzerinde topology onarımı çalıştırır ve su geçirmez, baskıya hazır bir sürüm döndürür.

Görev arka planda çalışır. Genellikle ne kadar sürdüğü için bkz. İşlem Süreleri.

Çıktı formatı, giriş formatıyla eşleşir. Eğer model_url aracılığıyla bir .stl gönderirseniz, yanıtın model_urls.stl alanı onarılmış ağı tutar ve diğer format alanları boş kalır. input_task_id yolu her zaman kaynak görevin GLB'sini okur, dolayısıyla çıktı .glb olur.

Planladığınız baskı boyutunda çok ince olan duvarları da kalınlaştırmak için printer_type, bir baskı boyutu veya her ikisini birden gönderin. Duvarlar yalnızca yüzeyin %5'inden fazlası o yazıcı için çok inceyse kalınlaştırılır. Onarılan model orijinal ölçeğini korur; ölçeklendirmek için metre birimi alan (100 mm, 0.1'dir) Yeniden Boyutlandır API'sini kullanın.

Parametreler

input_task_id veya model_url alanlarından yalnızca biri zorunludur. Her ikisi de sağlanırsa, input_task_id önceliklidir.

Geometri değişiklikleri nedeniyle onarım sırasında mevcut texture'lar kaldırılır. Texture'ları geri eklemek için onarılan model üzerinde Yeniden Dokulama API'sini kullanın.

Name
input_task_id
Type
string
Zorunlu
Description
Sahip olduğunuz başarılı bir görevin ID'si. Desteklenen görev türleri: Görselden 3D'ye, Çoklu görselden 3D'ye, Metinden 3D'ye, Yeniden ağ, Yeniden dokulama ve Basılabilirliği analiz et. Görevin durumu SUCCEEDED olmalı ve bir GLB varlığı üretmiş olmalıdır.
Duvar kalınlığını kontrol eden bir analiz görevi, yazıcısını ve boyutunu da aktarır; bu nedenle ikisini de göndermeseniz bile onarım görevi duvar kalınlığını kontrol eder ve ince duvarları kalınlaştırır; sizin gönderdiğiniz bir printer_type veya baskı boyutu bu değeri geçersiz kılar. Bir .stl, .fbx veya .gltf model_url'den oluşturulan analiz görevleri kabul edilmez: bunun yerine dosyayı model_url olarak gönderin.

Name
model_url
Type
string
Zorunlu
Description
Onarılacak 3D modelin URL'si. Desteklenen formatlar: .glb, .gltf, .obj, .fbx, .stl. Bir http veya https URL'si ya da bir GLB (data:model/gltf-binary;base64,...) veya glTF (data:model/gltf+json;base64,...) için base64 data: URL'si kullanın. .obj, .fbx ve .stl dosyaları bir http veya https URL'si olarak gönderilmelidir.
Maksimum dosya boyutu: http veya https URL'si için 400 MB, data: URI'si için 100 MB.
100 MB'tan 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'ı aşan bir FBX dosyası, ikili (binary) FBX 7.1 veya daha yeni bir sürüm olmalıdır ve bir GLB veya glTF dosyası Draco sıkıştırması kullanmamalıdır.
Meshy indirme URL'leri (assets.meshy.ai/…?Expires=…&Signature=…) imzalıdır ve görevin expires_at değerinde çalışmayı durdurur; görevi tekrar getirmek bunları yenilemez. Meshy ile üretilen bir model için bunun yerine input_task_id iletin. Bu, kaynak görev saklandığı sürece çalışır (bkz. Varlık Saklama). Bu süreden sonra bir modeli yeniden kullanmak için expires_at'ten önce indirin ve kendi kopyanızı gönderin.

Name
alpha_thumbnail
Type
boolean
varsayılan false
Description
true olarak ayarlandığında, görev ayrıca önizlemenin saydam 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.

İki baskı boyutu alanından en fazla birini gönderin. Eğer printer_type'ı bir boyut olmadan gönderirseniz ve bir analiz görevinden yeniden kullanılan bir boyut yoksa, varsayılan boyut şöyledir:

.glb ve herhangi bir input_task_id: 150 mm yükseklik.
.stl: dosyanın kendi en uzun kenarı, milimetre olarak okunur. Başka birimlerdeki bir STL için intended_print_longest_side_mm gönderin.
.obj, .fbx, .gltf: en uzun kenarda 150 mm.

Name
printer_type
Type
string
Description
Kullanmayı planladığınız yazıcı. Onarımın hedeflediği minimum duvar kalınlığını belirler. Boyutu gönderip bunu göndermediğinizde, input_task_id olarak iletilen bir analiz görevi yazıcıyı sağlamadığı sürece varsayılan değer fdm'dir.
Kullanılabilir değerler:
- fdm: filament, 1,0 mm minimum duvar.
- sla: reçine, 0,8 mm minimum duvar.
- full_color: tam renkli, 2,0 mm minimum duvar.
Name
intended_print_height_mm
Type
number
Description
Baskının yüksekliği, milimetre cinsinden. Aralık: [1, 1000]. En yakın milimetreye yuvarlanır. Yalnızca GLB girişi için geçerlidir.
Name
intended_print_longest_side_mm
Type
number
Description
Baskının en uzun kenarının uzunluğu, milimetre cinsinden. Aralık: [1, 1000]. En yakın milimetreye yuvarlanır. Her giriş formatıyla çalışır.

Dönüş Değerleri

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

Hata Modları

Name
400 - Bad Request
Description
İstek kabul edilemedi. Yaygın nedenler:
- Eksik parametre: ne input_task_id ne de model_url sağlanmadı.
- Geçersiz UUID: input_task_id geçerli bir UUID değil.
- Geçersiz model URL'si: model_url hatalı biçimlendirilmiş, desteklenmeyen bir şema kullanıyor veya desteklenmeyen bir dosya uzantısına sahip.
- Model dosyası çok büyük: model_url içeriği 400 MB'ı (http veya https URL'si) veya 100 MB'ı (data: URI'si) aştı.
- Çok fazla yüzey: model_url, 10.000.000'dan fazla yüzeye sahip, 100 MB'ı aşan bir GLB, glTF, FBX veya OBJ dosyası. Yüzey sayısını azaltın, ardından dosyayı tekrar gönderin.
- 100 MB'ı aşan ASCII FBX: model_url, 100 MB'ı aşan bir ASCII FBX dosyası. Bunu ikili FBX veya GLB olarak gönderin.
- Okunamayan model dosyası: model_url 100 MB'ı aşıyor ve başlığı okunamı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 100 MB'ı aşıyor ve başlığı kontrol edilemeyecek kadar çok ağ, düğüm veya kayıt içeriyor. Dosyadaki nesne sayısını azaltın, ardından tekrar gönderin.
- Model dosyası indirilemedi: model_url bir hata döndürdü; bunun en sık nedeni imzalı bir Meshy indirme URL'sinin süresinin dolmuş olmasıdır. Görevi tekrar getirmek aynı süre sonuna sahip aynı URL'yi döndürür, bu yüzden dosyanın kendi kopyanızı gönderin veya kaynak görev hâlâ saklanıyorsa input_task_id kullanın.
- Görev başarılı değil: referans verilen görev hâlâ beklemede, işlemde veya başarısız oldu.
- GLB eksik: referans verilen görevin onarılacak bir GLB varlığı yok.
- Geçersiz baskı boyutu: intended_print_height_mm veya intended_print_longest_side_mm, [1, 1000] aralığının dışında veya ikisi de gönderildi.
- Bilinmeyen yazıcı türü: printer_type, fdm, sla veya full_color değil.
- GLB olmayan bir modelde yükseklik: intended_print_height_mm, .glb olmayan bir model_url ile gönderildi. Bunun yerine intended_print_longest_side_mm kullanın.
- Bu model yüksekliğe göre boyutlandırılamıyor: istenen yükseklikte (veya varsayılan 150 mm'de), modelin en uzun kenarı [1, 1000] mm aralığının dışında olur, model düzse veya boyutu belirlenemiyorsa. Bunun yerine intended_print_longest_side_mm kullanın. Bir .glb model_url'si ve bazı input_task_id görevleri için bu durum yalnızca görev başladıktan sonra tespit edilir ve görev bunun yerine FAILED ile sonuçlanır.
- Kullanılamaz STL boyutu: printer_type, bir boyut olmadan gönderildi ve .stl'nin kendi en uzun kenarı okunamıyor veya [1, 1000] mm aralığının dışında. intended_print_longest_side_mm gönderin.
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
Yaygın nedenler:
- Ücretsiz plan: görev oluşturma ücretli bir plan gerektirir. Abonelik sayfasından yükseltme yapın.
- Yetersiz kredi: çalışma alanı kredi limitine ulaşıldı.
Name
404 - Not Found
Description
Referans verilen görev mevcut değil veya başka bir kullanıcıya ait.
Name
429 - Too Many Requests
Description
Bekleyen görev kotanızı veya hız sınırınızı aştınız.

Request

POST

/openapi/v1/print/repair

# Repair an existing task
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Or repair a model URL directly
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.stl"
  }'

# Also thicken walls that are too thin for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "printer_type": "sla",
    "intended_print_height_mm": 100
  }'

Response

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

GET/openapi/v1/print/repair/:id

Repair Printability Görevi Al

Bu uç nokta, ID'sine göre bir repair-printability görevini getirir.

Parametreler

Name
id
Type
path
Description
Getirilecek repair-printability görevinin ID'si.

Dönüş Değerleri

Repair Printability Task Nesnesi. Görev SUCCEEDED durumuna ulaşana kadar model_urls bloğu boştur. Yalnızca giriş biçimiyle eşleşen model_urls alanı doldurulur. Bir duvar kalınlığı onarımı, başlangıçtan itibaren intended_print içerir ve görev başarılı olduğunda print_repair_report eklenir.

Request

GET

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

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

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}

DELETE/openapi/v1/print/repair/:id

Basılabilirliği Onarma Görevini Sil

Bu uç nokta, bir basılabilirliği onarma görevini ve onarılmış çıktısını kalıcı olarak siler. Bu işlem geri alınamaz.

Yol Parametreleri

Name
id
Type
path
Description
Silinecek basılabilirliği onarma 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. İşçinin (worker) zaten başlattığı bir görevin kredisi iade edilemez, bu nedenle görevi çalışırken silmek size hem kredinizi hem de sonucu kaybettirir. Görevin SUCCEEDED, FAILED veya CANCELED durumuna ulaşmasını bekleyin, ardından silin.

Sonlanmış bir durumdaki (SUCCEEDED, FAILED veya CANCELED) görev, iade yapılmadan silinir.

Dönüş Değerleri

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

Request

DELETE

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

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/repair/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/print/repair

Basılabilirlik Onarma Görevlerini Listele

Bu uç nokta, basılabilirlik onarma görevlerinin bir listesini almanızı sağlar.

Parametreler

İsteğe bağlı özellikler

Name
page_num
Type
integer
Description
Sayfalama için sayfa numarası. 1 ile başlar ve varsayılan olarak 1'dir.
Name
page_size
Type
integer
Description
Sayfa boyutu sınırı. Varsayılan olarak 10 öğedir. İzin verilen maksimum 100 öğedir.
Name
sort_by
Type
string
Description
Sıralama yapılacak alan. Kullanılabilir değerler:
- +created_at: Oluşturulma zamanına göre artan sırada sıralar.
- -created_at: Oluşturulma zamanına göre azalan sırada sıralar.

Dönüş Değerleri

Basılabilirlik Onarma Görevi Nesnelerinin sayfalanmış bir listesini döndürür.

Request

GET

/openapi/v1/print/repair

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-repair",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000030000,
    "expires_at": 1715725401000,
    "task_error": null,
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
      "gltf": "",
      "fbx": "",
      "obj": "",
      "stl": "",
      "usdz": "",
      "3mf": "",
      "mtl": ""
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "texture_urls": [],
    "consumed_credits": 10
  }
]

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

Basılabilirliği Onar Görevini Akışla İzle

Bu uç nokta, Server-Sent Events (SSE) kullanarak basılabilirliği onar görevi için gerçek zamanlı güncellemeleri akışla sunar.

Parametreler

Name
id
Type
path
Description
Akışla izlenecek basılabilirliği onar görevinin benzersiz tanımlayıcısı.

Dönüş Değerleri

Server-Sent Events olarak Basılabilirliği Onar Görevi Nesneleri akışı döndürür.

Her kare, aşamaya ait tam görev nesnesini taşır — Get uç noktasının döndürdüğü ile aynı şekli — bu nedenle görev PENDING veya IN_PROGRESS durumundayken çıktı alanları henüz doldurulmamıştır (null, [] veya {}) ve finished_at değeri null'dır. model_urls bloğu yalnızca görev SUCCEEDED durumuna ulaştığında gönderilir.

Request

GET

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

curl -N https://api.meshy.ai/openapi/v1/print/repair/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.
// Every frame is the full task object; fields not yet populated are null / empty.
// The PENDING frame below is abbreviated to the fields that change.
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

Basılabilirliği onar Görev Nesnesi

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 formatıyla ilgili herhangi bir varsayımda bulunmamalısınız.
Name
type
Type
string
Description
Repair-printability görevinin türü. Değer print-repair'dir.
Name
status
Type
string
Description
Görevin durumu. Olası değerler PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED değerlerinden biridir.
Name
progress
Type
integer
Description
Görevin ilerleme durumu. Görev henüz başlamadıysa bu özellik 0 olacaktır. Görev başarıyla tamamlandığında bu değer 100 olacaktır.
Name
preceding_tasks
Type
integer
Description
Önceki görevlerin sayısı.
Bu alanın değeri yalnızca görev durumu PENDING olduğunda anlamlıdır.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zaman damgası, milisaniye cinsinden.
Name
started_at
Type
timestamp
Description
Görevin başladığı zaman damgası, milisaniye cinsinden. Görev henüz başlamadıysa bu özellik 0 olacaktır.
Name
finished_at
Type
timestamp
Description
Görevin tamamlandığı zaman damgası, milisaniye cinsinden. Görev henüz tamamlanmadıysa bu özellik 0 olacaktır.
Name
expires_at
Type
timestamp
Description
Görev sonucunun sistemden sona ereceği zaman damgası, milisaniye cinsinden. Görev henüz tamamlanmadıysa 0.
Name
task_error
Type
object
Description
Görev başarısız olduysa hata bilgisi. Görev başarısız olmadıysa bu özellik null'dır. Daha fazla ayrıntı için bkz. Hatalar.
- Name
  message
  Type
  string
  Description
  Neyin yanlış gittiğini açıklayan hata mesajı.
Name
model_urls
Type
object
Description
Onarılmış 3D modele indirilebilir URL'ler. Yalnızca giriş formatına karşılık gelen alan doldurulur; diğer format alanları boş dizedir.
- Name
  glb
  Type
  string
  Description
  Onarılmış GLB'ye indirilebilir URL. Giriş bir GLB olduğunda veya input_task_id kullanıldığında doldurulur.
- Name
  gltf
  Type
  string
  Description
  Onarılmış GLTF'ye indirilebilir URL. Giriş bir GLTF yüklemesi olduğunda doldurulur.
- Name
  fbx
  Type
  string
  Description
  Onarılmış FBX'e indirilebilir URL. Giriş bir FBX yüklemesi olduğunda doldurulur.
- Name
  obj
  Type
  string
  Description
  Onarılmış OBJ'ye indirilebilir URL. Giriş bir OBJ yüklemesi olduğunda doldurulur.
- Name
  stl
  Type
  string
  Description
  Onarılmış STL'ye indirilebilir URL. Giriş bir STL yüklemesi olduğunda doldurulur.
- Name
  usdz
  Type
  string
  Description
  USDZ çıktısı için ayrılmıştır. Repair-printability görevleri için her zaman boş dizedir.
- Name
  3mf
  Type
  string
  Description
  3MF çıktısı için ayrılmıştır. Repair-printability görevleri için her zaman boş dizedir.
- Name
  mtl
  Type
  string
  Description
  MTL çıktısı için ayrılmıştır. Repair-printability görevleri için her zaman boş dizedir.
Name
thumbnail_url
Type
string
Description
Onarılmış modelden oluşturulan önizleme görüntüsünün URL'si.
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url'nin şeffaf arka planlı (RGBA) 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 yer almaz.
Name
texture_urls
Type
array
Description
Her zaman boş bir dizi. Repair yalnızca giriş geometrisini korur ve texture'ları yeniden oluşturmaz.
Name
consumed_credits
Type
integer
Description
Bu görev tarafından tüketilen kredi sayısı. Görev SUCCEEDED durumuna ulaştığında 10. FAILED görevler için 0 döner (başarısızlık durumunda krediler iade edilir).
Name
intended_print
Type
object
Description
Repair işleminin kullandığı yazıcı ve boyut; ister gönderilmiş ister bir analyze görevinden yeniden kullanılmış olsun. Bir wall-thickness repair işleminde en baştan (PENDING) mevcuttur; henüz bilinmeyen değerler null'dır.
- Name
  printer_type
  Type
  string
  Description
  fdm, sla veya full_color.
- Name
  height_mm
  Type
  number
  Description
  Baskı yüksekliğe göre boyutlandırıldıysa, milimetre cinsinden baskı yüksekliği. Aksi takdirde null.
- Name
  longest_side_mm
  Type
  number
  Description
  Baskının milimetre cinsinden en uzun kenarı. Yüksekliğe göre boyutlandırıldığında, modelin oranlarından hesaplanır ve model ölçülene kadar null'dır.
- Name
  wall_thickness_mm
  Type
  number
  Description
  printer_type için milimetre cinsinden minimum duvar kalınlığı.
- Name
  dimensions_mm
  Type
  array
  Description
  Baskının milimetre cinsinden [genişlik, derinlik, yükseklik] değerleri. Yükseklik, height_mm'den bir milimetrenin kesri kadar farklı olabilir. Görev başarılı olana kadar null'dır ve GLB olmayan girişler için her zaman null'dır.
Name
print_repair_report
Type
object
Description
Wall-thickness repair işleminin ne yaptığı. Bir wall-thickness repair işlemi başarılı olduktan sonra mevcuttur.
- Name
  route
  Type
  string
  Description
  Hangi repair işleminin çalıştığı. Şunlardan biri:
  
  thin_wall: Yüzeyin %5'inden fazlası çok inceydi, bu yüzden duvar kalınlaştırma da çalıştı (bkz. applied).
  
  topology: Duvarlar yeterince kalındı; yalnızca topology onarımı çalıştı.
  
  topology_unmeasured: Duvarlar ölçülemedi; yalnızca topology onarımı çalıştı.
- Name
  applied
  Type
  boolean
  Description
  Duvar kalınlaştırmanın ağı değiştirip değiştirmediği. Yalnızca route değeri thin_wall olduğunda mevcuttur.
- Name
  faces_before
  Type
  integer
  Description
  Giriş ağının yüzey sayısı. Yalnızca route değeri thin_wall olduğunda mevcuttur.
- Name
  faces_after
  Type
  integer
  Description
  Onarılmış ağın yüzey sayısı. Yalnızca route değeri thin_wall olduğunda mevcuttur.
- Name
  thin_area_ratio_before
  Type
  number
  Description
  Girişin yüzeyinin, 0 ile 1 arasında, intended_print.wall_thickness_mm değerinden daha ince olan kısmının oranı. Giriş ölçülemediyse bu alan yer almaz.
- Name
  thin_area_ratio_after
  Type
  number
  Description
  Onarılmış model üzerinde ölçülen aynı oran. Ölçülemediyse bu alan yer almaz; görev yine de başarılı olur.

The Repair Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

The Repair Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}