Çok Renkli Baskı API'si

3D modelleri, 3D baskı için 16 renge kadar yapılandırılabilir bir renk paletiyle çok renkli 3MF formatına dönüştürün.

POST/openapi/v1/print/multi-color

Çok Renkli 3D Baskı Görevi Oluştur

Bu uç nokta yeni bir çok renkli 3D baskı görevi oluşturur. Görev, bir 3D modeli 3D baskıya uygun çok renkli bir 3MF dosyasına dönüştürür.

Parametreler

input_task_id veya model_url seçeneklerinden yalnızca biri gereklidir. İkisi de sağlanırsa input_task_id öncelik alır.

Name
input_task_id
Type
string
Zorunlu
Description
Girdi olarak kullanılacak başarılı bir görevin kimliği. Desteklenen görev türleri: Görselden 3D'ye, Çoklu görselden 3D'ye, Metinden 3D'ye, Yeniden ağ ve Yeniden dokulama. Görevin durumu SUCCEEDED olmalıdır.

Name
model_url
Type
string
Zorunlu
Description
Bir 3D modelin herkese açık URL'si veya Data URI'si. Şu anda .glb ve .fbx formatlarını destekliyoruz.

Name
max_colors
Type
integer
varsayılan 4
Description
Çıktı paletindeki maksimum renk sayısı.
Geçerli aralık: 1 ile 16 arası.
Name
max_depth
Type
integer
varsayılan 4
Description
Renk hassasiyeti için quadtree derinliği. Daha yüksek değerler daha ince renk sınırları üretir ancak dosya boyutunu artırır.
Geçerli aralık: 3 ile 6 arası.

Dönenler

Yanıtın result özelliği, yeni oluşturulan 3D baskı görevinin id değerini içerir.

Hata Modları

Name
400 - Bad Request
Description
İstek kabul edilemezdi. Yaygın nedenler:
- Eksik parametre: model_url veya input_task_id sağlanmalıdır.
- Geçersiz model formatı: model_url, desteklenmeyen uzantıya sahip bir dosyayı işaret ediyor (yalnızca .glb ve .fbx desteklenir).
- Ulaşılamayan URL: model_url indirilemedi.
- Geçersiz girdi görevi: input_task_id başarılı bir göreve başvurmalıdır.
- Geçersiz max_colors: Değer 1 ile 16 arasında olmalıdır.
- Geçersiz max_depth: Değer 3 ile 6 arasında olmalıdır.
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
Bu görevi gerçekleştirmek için yetersiz kredi.
Name
429 - Too Many Requests
Description
Hız sınırınızı aştınız.

Request

POST

/openapi/v1/print/multi-color

# Convert a 3D model to multi-color 3MF for printing
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,
    "max_depth": 5
  }'

Response

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

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

Çok Renkli 3D Yazdırma Görevini Alma

Bu uç nokta, çok renkli bir 3D yazdırma görevini ID'sine göre alır.

Parametreler

Name
id
Type
path
Description
Alınacak 3D yazdırma görevinin ID'si.

Döndürür

3D Yazdırma Görevi nesnesi.

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

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

Çok Renkli 3D Baskı Görevini Sil

Bu uç nokta, tüm ilişkili modeller ve veriler dahil olmak üzere çok renkli bir 3D baskı görevini kalıcı olarak siler. Bu işlem geri alınamaz.

Yol Parametreleri

Name
id
Type
path
Description
Silinecek çok renkli 3D baskı görevinin kimliği.

Döndürür

Başarılı olduğunda 200 OK döndürür.

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

// Returns 200 Ok on success.

GET/openapi/v1/print/multi-color

Çok Renkli 3D Baskı Görevlerini Listele

Bu uç nokta, çok renkli 3D baskı görevlerinin bir listesini almanızı sağlar.

Parametreler

İsteğe bağlı öznitelikler

Name
page_num
Type
integer
Description
Sayfalama için sayfa numarası. 1 ile başlar ve varsayılan değeri 1dir.
Name
page_size
Type
integer
Description
Sayfa boyutu sınırı. Varsayılan olarak 10 öğedir. İzin verilen maksimum değer 50 öğedir.
Name
sort_by
Type
string
Description
Sıralanacak alan. Kullanılabilir değerler:
- +created_at: Oluşturulma zamanına göre artan düzende sırala.
- -created_at: Oluşturulma zamanına göre azalan düzende sırala.

Dönen değerler

3D Baskı Görevi Nesneleri için sayfalanmış bir liste 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,
    "task_error": null,
  "consumed_credits": 10
  }
]

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

Çok Renkli 3D Baskı Görevini Akışla Aktar

Bu uç nokta, Server-Sent Events (SSE) kullanarak çok renkli bir 3D baskı görevi için gerçek zamanlı güncellemeleri akışla aktarır.

Parametreler

Name
id
Type
path
Description
Akışla aktarılacak çok renkli 3D baskı görevi için benzersiz tanımlayıcı.

Dönen Değerler

Server-Sent Events olarak 3D Baskı Görevi Nesneleri akışını döndürür.

PENDING veya IN_PROGRESS görevleri için yanıt akışı yalnızca gerekli progress ve status alanlarını içerir.

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.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
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,
  "task_error": null,
"consumed_credits": 10
}

3D Baskı Görev Nesnesi

Name
id
Type
string
Description
Görev için benzersiz tanımlayıcı. Görev id'leri için uygulama ayrıntısı olarak k-sıralanabilir bir UUID kullansak da, id'nin biçimi hakkında hiçbir varsayımda bulunmamalısınız.
Name
type
Type
string
Description
3D Baskı görevinin türü. Değer print-multi-color şeklindedir.
Name
model_urls
Type
object
Description
Meshy tarafından oluşturulan 3D model dosyası için indirilebilir URL. Bir format oluşturulmadıysa, boş bir dize döndürmek yerine o formata ait özellik atlanır.
- Name
  3mf
  Type
  string
  Description
  Çok renkli 3MF dosyası için indirilebilir URL.
Name
progress
Type
integer
Description
Görevin progress değeri. Görev henüz başlatılmadıysa bu özellik 0 olur. Görev başarıyla tamamlandığında bu değer 100 olur.
Name
status
Type
string
Description
Görevin durumu. Olası değerler PENDING, IN_PROGRESS, SUCCEEDED, FAILED değerlerinden biridir.
Name
preceding_tasks
Type
integer
Description
Önceki görevlerin sayısı.
Bu alanın değeri yalnızca görev durumu PENDING ise anlamlıdır.
Name
created_at
Type
timestamp
Description
Görevin oluşturulduğu zamanın zaman damgası, milisaniye cinsinden.
Name
started_at
Type
timestamp
Description
Görevin başlatıldığı zamanın zaman damgası, milisaniye cinsinden. Görev henüz başlatılmadıysa bu özellik 0 olur.
Name
finished_at
Type
timestamp
Description
Görevin tamamlandığı zamanın zaman damgası, milisaniye cinsinden. Görev henüz tamamlanmadıysa bu özellik 0 olur.
Name
task_error
Type
object
Description
Başarısız görevler için hata ayrıntıları. Tam task_error nesne referansı için Hatalar bölümüne bakın.
Name
consumed_credits
Type
integer
Description
Bu görev tarafından tüketilen kredi sayısı. Görev durumu PENDING, IN_PROGRESS veya SUCCEEDED olduğunda bulunur. FAILED görevleri için 0 döndürür (krediler başarısızlık durumunda iade edilir).

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