Çok Renkli Baskı API'si

3D modelleri, 16 renge kadar yapılandırılabilir bir renk paleti ile 3D baskı için ç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'den yalnızca biri gereklidir. Her ikisi de sağlanırsa, input_task_id önceliklidir.

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örev SUCCEEDED durumunda olmalıdır.

Name
model_url
Type
string
Zorunlu
Description
3D modelin herkese açık erişilebilir 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ında.
Name
style
Type
string
varsayılan realistic
Description
Oluşturulan 3MF dosyasının görsel renk stili.
Mevcut değerler:
- realistic: Modelin dokusundan doğrudan renk örnekleri alarak ince, foto-gerçekçi detaylar sağlar. Daha büyük bir dosya üretir.
- cartoon: Renkleri temiz, tekdüze bölgelere düzleştirerek stilize bir görünüm sağlar. Daha küçük bir dosya üretir.

Döndürülenler

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 bir uzantıya sahip bir dosyaya işaret ediyor (yalnızca .glb ve .fbx desteklenir).
- Erişilemez URL: model_url indirilemedi.
- Geçersiz giriş görevi: input_task_id başarılı bir göreve atıfta bulunmalıdır.
- Geçersiz max_colors: Değer 1 ile 16 arasında olmalıdır.
- Geçersiz stil: Değer realistic veya cartoon 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.

İstek

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

Yanıt

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

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

Çok Renkli 3D Baskı Görevini Getir

Bu uç nokta, ID'si ile çok renkli bir 3D baskı görevini alır.

Parametreler

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

Dönen Değerler

3D Baskı Görevi nesnesi.

İstek

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

Yanıt

{
  "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, ilgili tüm 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ülenler

Başarı durumunda 200 OK döner.

İstek

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

Yanıt

// 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ı ö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 50 öğedir.
Name
sort_by
Type
string
Description
Sıralama yapılacak alan. Mevcut 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önen Değerler

3D Baskı Görev Nesneleri listesini sayfalı olarak döndürür.

İstek

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

Yanıt

[
  {
    "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 Yayınla

Bu uç nokta, Server-Sent Events (SSE) kullanarak çok renkli bir 3D baskı görevi için gerçek zamanlı güncellemeler yayınlar.

Parametreler

Name
id
Type
path
Description
Yayınlanacak çok renkli 3D baskı görevinin benzersiz tanımlayıcısı.

Dönen Değerler

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

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

İstek

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

Yanıt Akışı

// 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 kimlikleri için k-sıralı UUID kullanıyoruz, ancak kimlik formatı hakkında herhangi bir varsayımda bulunmamalısınız.
Name
type
Type
string
Description
3D Baskı görevinin türü. Değer print-multi-color olarak belirlenmiştir.
Name
model_urls
Type
object
Description
Meshy tarafından üretilen 3D model dosyasının indirilebilir URL'si. Bir format için özellik, boş bir dize döndürmek yerine format üretilmediğinde atlanacaktır.
- Name
  3mf
  Type
  string
  Description
  Çok renkli 3MF dosyasının indirilebilir URL'si.
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 100 olacaktır.
Name
status
Type
string
Description
Görevin durumu. Olası değerler PENDING, IN_PROGRESS, SUCCEEDED, FAILED olabilir.
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 damgası, milisaniye cinsinden.
Name
started_at
Type
timestamp
Description
Görevin başlatıldığı 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
task_error
Type
object
Description
Başarısız görevler için hata detayları. 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 mevcuttur. FAILED görevler için 0 döner (başarısızlık durumunda krediler iade edilir).

3D Baskı Görev Nesnesi

{
  "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
}