Çok Renkli Baskı API'si

3D baskı için bir 3D modeli çok renkli bir 3MF dosyasına dönüştürün. En fazla 16 renkten oluşan bir palet ve yazıcı markanıza uygun bir dilimleyici ön ayarı seçin.

POST/openapi/v1/print/multi-color

Çok Renkli Baskı görevi oluştur

Bir 3D modeli 3D baskı için çok renkli bir 3MF dosyasına dönüştüren bir Çok Renkli Baskı görevi oluşturur. Görev arka planda çalışır. Bir görevin genellikle ne kadar sürdüğü hakkında bilgi için İşlem süreleri sayfasına bakın.

Request

POST

/openapi/v1/print/multi-color

# Convert a 3D model to a multi-color 3MF with a Creality slicer preset
curl https://api.meshy.ai/openapi/v1/print/multi-color \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "max_colors": 8,
    "printer_brand": "creality"
  }'

Response

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

Parametreler

Name
input_task_id
Type
string
Zorunlu
Description
model_url göndermediğiniz sürece zorunludur. Modelini yazdırmak istediğiniz görevin ID'si; örneğin bir Görselden 3D'ye, Çoklu görselden 3D'ye, Metinden 3D'ye, Yeniden ağ veya Yeniden dokulama görevi. Görev, API ile oluşturduğunuz bir görev olmalı ve durumu SUCCEEDED olmalıdır.
Çok Renkli Baskı, görevin GLB dosyasını okur ve bu dosya 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 ID'sini gönderin.

Name
model_url
Type
string
Zorunlu
Description
input_task_id göndermediğiniz sürece zorunludur. Yazdırılacak model; herkese açık bir URL veya bir data URI olarak. İkisini birden gönderirseniz, Meshy input_task_id'yi kullanır.
Bir http veya https URL'si, en fazla 400 MB boyutunda bir .glb veya .fbx dosyasını işaret etmelidir. Bir data URI, en fazla 100 MB boyutunda base64 kodlu bir GLB dosyası taşımalıdır. data:model/gltf-binary;base64, kullanın. Bir .fbx dosyasını http veya https URL'si olarak gönderin.
100 MB'den büyük bir dosya ayrıca şu kurallara uymalıdır:
- En fazla 8.000.000 yüze sahip olabilir. Meshy yüzleri üçgen olarak sayar, bu yüzden 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 bir sürüm olmalıdır.
- Bir GLB dosyası Draco sıkıştırması kullanmamalıdır.

Name
max_colors
Type
integer
varsayılan 4
Description
Çıktı paletindeki azami renk sayısı, 1 ile 16 arasında. Varsayılanı kullanmak için 0 göndermek yerine bu parametreyi boş bırakın.
Name
style
Type
string
varsayılan realistic
Description
3MF dosyasının renk stili.
Kullanılabilir değerler:
- realistic: ince, fotogerçekçi ayrıntı için renkleri doğrudan modelin dokusundan örnekler ve daha büyük bir dosya oluşturur.
- cartoon: stilize bir görünüm için renkleri temiz, tekdüze bölgelere dönüştürür ve daha küçük bir dosya oluşturur.
Modelin renkli olması gerekir. realistic, her ağ parçasında UV'lere sahip tek bir temel renk dokusu gerektirir ve cartoon ayrıca köşe (vertex) renklerini de kabul eder. Meshy, dokusuz (beyaz) bir modeli reddeder. Bkz. model_missing_texture.
Name
max_depth
Type
integer
varsayılan 4
Description
Meshy'nin doku renklerini ağ üzerine örneklemek için kullandığı alt bölümlendirme derinliği, 3 ile 6 arasında. 0 değeri bu parametreyi boş bırakmakla aynıdır. Daha yüksek değerler daha ince renk ayrıntısı yakalar ve daha büyük bir dosya oluşturur. Yalnızca realistic stili bunu kullanır; cartoon bunu yok sayar.
Name
printer_brand
Type
string
varsayılan bambu
Description
Meshy'nin dilimleyici ön ayarını 3MF dosyasına yazacağı yazıcı markası. Dosya daha sonra o markanın dilimleyicisinde, eşleşen bir yazıcı, filament ve işlem profiliyle açılır. Ön ayar, markanın varsayılan yazıcısını, 0,4 mm'lik bir nozul ile kullanır.
Kullanılabilir değerler:
- bambu
- anycubic
- creality
- elegoo
- flashforge
- prusa
- qidi
- snapmaker
- ankermake
Başka herhangi bir değer 400 döndürür.

Dönüş Değerleri

Yanıtın result alanı, yeni Çok Renkli Baskı görevinin ID'sini 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.
- Geçersiz model biçimi: model_url dosyası bir .glb veya .fbx dosyası değil.
- Erişilemeyen URL: Meshy, model_url dosyasını indiremiyor.
- Model dosyası çok büyük: model_url dosyası, bir http veya https URL'sinden 400 MB'den büyük, veya bir data URI olarak 100 MB'den büyük.
- Çok fazla yüz: model_url dosyası 100 MB'den büyük ve 8.000.000'den 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. Bunu 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 ile sıkıştırılmış bir GLB veya 7.1'den eski ikili bir FBX olabilir.
- 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.
- Geçersiz girdi görevi: input_task_id başarılı bir görev değil.
- Girdi görevinde çok fazla yüz: input_task_id modeli 8.000.000'den fazla yüze sahip. Önce model üzerinde bir Yeniden ağ görevi çalıştırın, ardından bunun yerine Yeniden ağ görevinin ID'sini gönderin.
- Geçersiz max_colors: max_colors negatif veya 16'dan büyük.
- Geçersiz style: style, realistic veya cartoon değil.
- Geçersiz max_depth: max_depth, 3 ile 6 aralığının dışında ve 0 değil.
- Geçersiz printer_brand: printer_brand, kullanılabilir değerlerinden biri değil.
- Renk kaynağı yok: Model, style parametresinin gerektirdiği renge sahip değil. realistic, her ağ parçasında UV'lere sahip tek bir temel renk dokusu gerektirir. cartoon, bir temel renk dokusunu veya köşe (vertex) renklerini kabul eder. Önce modele doku ekleyin veya köşe renklerine sahip bir model için cartoon kullanın. Meshy, bir .fbx yüklemesini yalnızca görev onu normalleştirdikten sonra kontrol eder, bu yüzden görev bunun yerine model_missing_texture hatasıyla başarısız olur.
İ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: Hesabın bu görev için yeterli kredisi yok, veya 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. Planınızı abonelik ayarlarınızdan yükseltin, ardından tekrar deneyin.
Name
403 - Forbidden
Description
input_task_id, bu uç noktanın yazdıramayacağı bir kabartma (bas-relief) model. 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 ID'sini 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/print/multi-color/:id

Çok Renkli Baskı görevini alma

Kimliğine göre bir Çok Renkli Baskı görevini döndürür.

Request

GET

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

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

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-multi-color",
  "model_urls": {
      "3mf": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.3mf?Expires=***"
},
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1700259201000,
  "task_error": null,
"consumed_credits": 10
}

Parametreler

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

Döndürülenler

Çok Renkli Baskı görevi nesnesi.

DELETE/openapi/v1/print/multi-color/:id

Çok Renkli Baskı görevini sil

Bir Çok Renkli Baskı 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/multi-color/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/multi-color/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 nedenle görevi silmek hem kredileri hem de sonucu kaybetmenize neden olur. 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/print/multi-color

Çok Renkli Baskı görevlerini listele

Çok Renkli Baskı görevlerinizin bir listesini döndürür.

Request

GET

/openapi/v1/print/multi-color

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-multi-color",
    "model_urls": {
      "3mf": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.3mf?Expires=***"
    },
    "progress": 100,
    "status": "SUCCEEDED",
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "expires_at": 1700259201000,
    "task_error": null,
  "consumed_credits": 10
  }
]

Parametreler

Name
page_num
Type
integer
varsayılan 1
Description
Döndürülecek sayfa numarası. Sayfa numaraları 1'den başlar.
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: önce en eski
- -created_at: önce en yeni

Döndürülenler

Çok Renkli Baskı görev nesnelerinin sayfalanmış bir listesi.

GET/openapi/v1/print/multi-color/:id/stream

Çok Renkli Baskı görevini akışla aktar

Bir Çok Renkli Baskı görevinin güncellemelerini Server-Sent Events (SSE) olarak akışla aktarır.

Request

GET

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

curl -N https://api.meshy.ai/openapi/v1/print/multi-color/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.
// These examples are shortened. Each event holds 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-multi-color",
  "model_urls": {
    "3mf": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.3mf?Expires=***"
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1700259201000,
  "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 Çok Renkli Baskı görev nesnelerinden oluşan bir akış.

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

Çok Renkli Baskı görev nesnesi

Bir Çok Renkli Baskı görev nesnesi, bir 3D modelin çok renkli bir 3MF dosyasına dönüştürülme işlemini tanımlar. Görev başarılı olduğunda durumu, progress değerini ve 3MF dosyasını tutar.

The 3D Print Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-multi-color",
  "model_urls": {
      "3mf": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.3mf?Expires=***"
},
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1700259201000,
  "task_error": null,
"consumed_credits": 10
}

Name
id
Type
string
Description
Görev kimliği. Bunu opak bir dize olarak değerlendirin ve biçimine güvenmeyin.
Name
type
Type
string
Description
Görev türü, her zaman print-multi-color.
Name
model_urls
Type
object
Description
Basılan model için indirme URL'leri, her dosya biçimi için bir tane. Görevin oluşturmadığı bir biçimin anahtarı yoktur, boş bir dize olarak değil.
- Name
  3mf
  Type
  string
  Description
  Çok renkli 3MF dosyası.
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
status
Type
string
Description
Görev durumu; PENDING, IN_PROGRESS, SUCCEEDED, FAILED veya CANCELED değerlerinden biridir.
Name
preceding_tasks
Type
integer
Description
Kuyrukta bu görevden önce bulunan görev 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.
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 krediyi iade eder.