प्रिंट-योग्यता मरम्मत API

FDM प्रिंट-योग्यता के लिए एक 3D मॉडल को मरम्मत करें — नॉन-मैनिफोल्ड किनारे, डिजेनरेट फेस, छेद, और अन्य topology समस्याओं को ठीक करें ताकि मेश प्रिंट-रेडी हो।

POST/openapi/v1/print/repair

प्रिंट-योग्यता मरम्मत कार्य बनाएँ

यह एंडपॉइंट एक नया प्रिंट-योग्यता मरम्मत कार्य बनाता है। यह कार्य 3D मॉडल पर topology मरम्मत चलाता है और एक वाटरटाइट, प्रिंट-रेडी संस्करण लौटाता है।

आउटपुट प्रारूप इनपुट प्रारूप से मेल खाता है। यदि आप model_url के माध्यम से .stl सबमिट करते हैं, तो प्रतिक्रिया का model_urls.stl मरम्मत किए गए मेश को रखेगा और अन्य प्रारूप फ़ील्ड खाली होंगे। input_task_id पथ हमेशा स्रोत कार्य के GLB को पढ़ता है, इसलिए आउटपुट .glb होता है।

पैरामीटर

input_task_id या model_url में से केवल एक आवश्यक है। यदि दोनों प्रदान किए जाते हैं, तो input_task_id को प्राथमिकता दी जाती है।

ज्यामिति परिवर्तनों के कारण मरम्मत के दौरान मौजूदा टेक्सचर हटा दिए जाते हैं। टेक्सचर को वापस जोड़ने के लिए, मरम्मत किए गए मॉडल पर रीटेक्सचर API का उपयोग करें।

Name
input_task_id
Type
string
आवश्यक
Description
आपके स्वामित्व वाले सफल कार्य का ID। समर्थित कार्य प्रकार: इमेज से 3D, मल्टी-इमेज से 3D, टेक्स्ट से 3D, रीमेश, और रीटेक्सचर। कार्य की स्थिति SUCCEEDED होनी चाहिए और इसे GLB asset उत्पन्न करना चाहिए।

Name
model_url
Type
string
आवश्यक
Description
मरम्मत के लिए 3D मॉडल का URL। समर्थित प्रारूप: .glb, .gltf, .obj, .fbx, .stl। अधिकतम फ़ाइल आकार: 100 MB। http, https, या data: URL का उपयोग करना चाहिए (डेटा URL एक्सटेंशन जांचों को बायपास करते हैं)।

Name
alpha_thumbnail
Type
boolean
डिफ़ॉल्ट false
Description
जब true पर सेट किया जाता है, तो कार्य अतिरिक्त रूप से पूर्वावलोकन का एक पारदर्शी-पृष्ठभूमि (RGBA) संस्करण प्रस्तुत करता है और इसे GET प्रतिक्रिया पर alpha_thumbnail_url के रूप में लौटाता है। मौजूदा thumbnail_url फ़ील्ड अपरिवर्तित रहता है।

रिटर्न्स

प्रतिक्रिया की result प्रॉपर्टी में नव निर्मित प्रिंट-योग्यता मरम्मत कार्य का id होता है।

विफलता मोड

Name
400 - Bad Request
Description
अनुरोध अस्वीकार्य था। सामान्य कारण:
- लापता पैरामीटर: न तो input_task_id और न ही model_url प्रदान किया गया था।
- अमान्य UUID: input_task_id एक मान्य UUID नहीं है।
- अमान्य मॉडल URL: model_url विकृत है, एक असमर्थित योजना का उपयोग करता है, या एक असमर्थित फ़ाइल एक्सटेंशन है।
- मॉडल फ़ाइल बहुत बड़ी: model_url बॉडी 100 MB से अधिक हो गई।
- कार्य सफल नहीं हुआ: संदर्भित कार्य अभी भी लंबित है, प्रगति पर है, या विफल हो गया है।
- GLB गायब है: संदर्भित कार्य में मरम्मत के लिए कोई GLB asset नहीं है।
Name
401 - Unauthorized
Description
प्रमाणीकरण विफल हो गया। कृपया अपनी API की जांचें।
Name
402 - Payment Required
Description
सामान्य कारण:
- मुफ्त योजना: कार्य निर्माण के लिए एक भुगतान योजना की आवश्यकता होती है। सब्सक्रिप्शन पृष्ठ पर अपग्रेड करें।
- अपर्याप्त क्रेडिट: वर्कस्पेस क्रेडिट सीमा तक पहुंच गया था।
Name
404 - Not Found
Description
संदर्भित कार्य मौजूद नहीं है या किसी अन्य उपयोगकर्ता के स्वामित्व में है।
Name
429 - Too Many Requests
Description
आपने अपनी लंबित-कार्य कोटा या रेट लिमिट को पार कर लिया है।

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

Response

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

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

प्रिंट-योग्यता मरम्मत कार्य प्राप्त करें

यह एंडपॉइंट उसके आईडी द्वारा एक प्रिंट-योग्यता मरम्मत कार्य प्राप्त करता है।

पैरामीटर्स

Name
id
Type
path
Description
प्राप्त करने के लिए प्रिंट-योग्यता मरम्मत कार्य की आईडी।

रिटर्न्स

प्रिंट-योग्यता मरम्मत कार्य ऑब्जेक्ट। model_urls ब्लॉक तब तक खाली रहता है जब तक कार्य SUCCEEDED तक नहीं पहुँचता। केवल इनपुट प्रारूप से मेल खाने वाला model_urls फ़ील्ड भरा जाता है।

अनुरोध

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

प्रतिक्रिया

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

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

प्रिंट-योग्यता मरम्मत कार्य हटाएं

यह एंडपॉइंट स्थायी रूप से एक प्रिंट-योग्यता मरम्मत कार्य और इसके मरम्मत किए गए आउटपुट को हटा देता है। यह क्रिया अपरिवर्तनीय है।

पथ पैरामीटर

Name
id
Type
path
Description
हटाने के लिए प्रिंट-योग्यता मरम्मत कार्य का ID।

रिटर्न्स

सफलता पर 200 OK लौटाता है।

अनुरोध

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

प्रतिक्रिया

// Returns 200 Ok on success.

GET/openapi/v1/print/repair

प्रिंट-योग्यता मरम्मत कार्यों की सूची

यह एंडपॉइंट आपको प्रिंट-योग्यता मरम्मत कार्यों की सूची प्राप्त करने की अनुमति देता है।

पैरामीटर

वैकल्पिक विशेषताएँ

Name
page_num
Type
integer
Description
पेजिनेशन के लिए पृष्ठ संख्या। 1 से शुरू होती है और डिफ़ॉल्ट होती है।
Name
page_size
Type
integer
Description
पृष्ठ आकार सीमा। डिफ़ॉल्ट रूप से 10 आइटम। अधिकतम अनुमति 50 आइटम है।
Name
sort_by
Type
string
Description
छांटने के लिए फ़ील्ड। उपलब्ध मान:
- +created_at: निर्माण समय के अनुसार आरोही क्रम में छांटें।
- -created_at: निर्माण समय के अनुसार अवरोही क्रम में छांटें।

रिटर्न्स

प्रिंट-योग्यता मरम्मत कार्य ऑब्जेक्ट्स की पेजिनेटेड सूची लौटाता है।

अनुरोध

GET

/openapi/v1/print/repair

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

प्रतिक्रिया

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

प्रिंट-योग्यता मरम्मत कार्य को स्ट्रीम करें

यह एंडपॉइंट Server-Sent Events (SSE) का उपयोग करके प्रिंट-योग्यता मरम्मत कार्य के लिए वास्तविक समय अपडेट स्ट्रीम करता है।

पैरामीटर्स

Name
id
Type
path
Description
स्ट्रीम करने के लिए प्रिंट-योग्यता मरम्मत कार्य के लिए अद्वितीय पहचानकर्ता।

रिटर्न्स

प्रिंट-योग्यता मरम्मत कार्य ऑब्जेक्ट्स का एक स्ट्रीम Server-Sent Events के रूप में रिटर्न करता है।

PENDING या IN_PROGRESS कार्यों के लिए, प्रतिक्रिया स्ट्रीम केवल आवश्यक progress और status फ़ील्ड्स को शामिल करेगा। model_urls ब्लॉक केवल तब भेजा जाता है जब कार्य SUCCEEDED तक पहुँचता है।

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.
// 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-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
}

प्रिंट-योग्यता मरम्मत कार्य ऑब्जेक्ट

Name
id
Type
string
Description
कार्य के लिए अद्वितीय पहचानकर्ता। जबकि हम कार्य आईडी के लिए k-sortable UUID का उपयोग करते हैं, आपको आईडी के प्रारूप के बारे में कोई धारणा नहीं बनानी चाहिए।
Name
type
Type
string
Description
प्रिंट-योग्यता मरम्मत कार्य का प्रकार। मान print-repair है।
Name
status
Type
string
Description
कार्य की स्थिति। संभावित मान PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED में से एक हैं।
Name
progress
Type
integer
Description
कार्य की प्रगति। यदि कार्य अभी तक शुरू नहीं हुआ है, तो यह प्रॉपर्टी 0 होगी। एक बार कार्य सफल हो जाने पर, यह 100 हो जाएगा।
Name
preceding_tasks
Type
integer
Description
पूर्ववर्ती कार्यों की संख्या।
इस फ़ील्ड का मान केवल तभी सार्थक होता है जब कार्य की स्थिति PENDING हो।
Name
created_at
Type
timestamp
Description
कार्य कब बनाया गया था इसका टाइमस्टैंप, मिलीसेकंड में।
Name
started_at
Type
timestamp
Description
कार्य कब शुरू हुआ था इसका टाइमस्टैंप, मिलीसेकंड में। यदि कार्य अभी तक शुरू नहीं हुआ है, तो यह प्रॉपर्टी 0 होगी।
Name
finished_at
Type
timestamp
Description
कार्य कब समाप्त हुआ था इसका टाइमस्टैंप, मिलीसेकंड में। यदि कार्य अभी तक समाप्त नहीं हुआ है, तो यह प्रॉपर्टी 0 होगी।
Name
expires_at
Type
timestamp
Description
कार्य का परिणाम सिस्टम से कब समाप्त होगा इसका टाइमस्टैंप, मिलीसेकंड में। 0 यदि कार्य अभी तक समाप्त नहीं हुआ है।
Name
task_error
Type
object
Description
यदि कार्य विफल हो गया है तो त्रुटि जानकारी। यह प्रॉपर्टी null होती है यदि कार्य विफल नहीं हुआ है। अधिक विवरण के लिए एरर देखें।
- Name
  message
  Type
  string
  Description
  त्रुटि संदेश जो बताता है कि क्या गलत हुआ।
Name
model_urls
Type
object
Description
मरम्मत किए गए 3D मॉडल के डाउनलोड करने योग्य URLs। केवल इनपुट प्रारूप से मेल खाने वाला फ़ील्ड भरा होता है; अन्य प्रारूप फ़ील्ड खाली स्ट्रिंग होते हैं।
- Name
  glb
  Type
  string
  Description
  मरम्मत किए गए GLB का डाउनलोड करने योग्य URL। जब इनपुट GLB था या जब input_task_id का उपयोग किया गया था, तब भरा जाता है।
- Name
  gltf
  Type
  string
  Description
  मरम्मत किए गए GLTF का डाउनलोड करने योग्य URL। जब इनपुट GLTF अपलोड था, तब भरा जाता है।
- Name
  fbx
  Type
  string
  Description
  मरम्मत किए गए FBX का डाउनलोड करने योग्य URL। जब इनपुट FBX अपलोड था, तब भरा जाता है।
- Name
  obj
  Type
  string
  Description
  मरम्मत किए गए OBJ का डाउनलोड करने योग्य URL। जब इनपुट OBJ अपलोड था, तब भरा जाता है।
- Name
  stl
  Type
  string
  Description
  मरम्मत किए गए STL का डाउनलोड करने योग्य URL। जब इनपुट STL अपलोड था, तब भरा जाता है।
- Name
  usdz
  Type
  string
  Description
  USDZ आउटपुट के लिए आरक्षित। हमेशा प्रिंट-योग्यता मरम्मत कार्यों के लिए एक खाली स्ट्रिंग।
- Name
  3mf
  Type
  string
  Description
  3MF आउटपुट के लिए आरक्षित। हमेशा प्रिंट-योग्यता मरम्मत कार्यों के लिए एक खाली स्ट्रिंग।
- Name
  mtl
  Type
  string
  Description
  MTL आउटपुट के लिए आरक्षित। हमेशा प्रिंट-योग्यता मरम्मत कार्यों के लिए एक खाली स्ट्रिंग।
Name
thumbnail_url
Type
string
Description
मरम्मत किए गए मॉडल से रेंडर की गई पूर्वावलोकन छवि का URL।
Name
alpha_thumbnail_url
Type
string
Description
thumbnail_url के एक पारदर्शी-पृष्ठभूमि (RGBA) संस्करण का डाउनलोड करने योग्य URL। केवल तब मौजूद होता है जब कार्य alpha_thumbnail: true के साथ बनाया गया था और पारदर्शी पूर्वावलोकन सफलतापूर्वक रेंडर किया गया था; अन्यथा यह फ़ील्ड छोड़ा जाता है।
Name
texture_urls
Type
array
Description
हमेशा एक खाली एरे। मरम्मत केवल इनपुट ज्यामिति को संरक्षित करती है और टेक्सचर को पुनः बेक नहीं करती है।
Name
consumed_credits
Type
integer
Description
इस कार्य द्वारा उपभोग किए गए क्रेडिट की संख्या। SUCCEEDED तक पहुँचने पर 10। FAILED कार्यों के लिए 0 लौटाता है (विफलता पर क्रेडिट वापस कर दिए जाते हैं)।

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
}