Creative Lab Collapsible Fidget API

एक फोटो को एक ही टास्क में प्रिंट-इन-प्लेस कोलैप्सिबल फिजेट टॉय में बदलें। विषय की सिल्हूट नेस्टेड कंसेंट्रिक रिंग्स में बदल जाती है जो सपाट रूप से कोलैप्स हो जाती हैं और फिर से फैल जाती हैं। यह टॉय बिना किसी असेंबली के एक ही टुकड़े में प्रिंट होता है।

POST /openapi/creative-lab/fidget-collapsible/v1

अन्य Creative Lab endpoints के विपरीत, इसमें अलग प्रोटोटाइप और बिल्ड स्टेज नहीं हैं। चुनने के लिए कोई कैंडिडेट इमेज नहीं होतीं, इसलिए एक ही टास्क फोटो को 3D मॉडल में बदल देता है।

रिक्वेस्ट में कोई ज्यामिति सेटिंग्स भी नहीं हैं। वेब ऐप आपको साइज़, लेयर काउंट, गैप विड्थ, दीवार की मोटाई, एक्सट्रूज़न डेप्थ और बल्ज सेट करने देता है। हर API टास्क इनके लिए समान डिफ़ॉल्ट मान का उपयोग करता है।

POST/openapi/creative-lab/fidget-collapsible/v1

Collapsible Fidget टास्क बनाना

एक फ़ोटो से collapsible fidget मॉडल जनरेट करता है। टास्क के फ़ील्ड्स के लिए, The Collapsible Fidget task object देखें।

प्रत्येक टास्क की लागत 6 क्रेडिट है और इसके लिए पेड प्लान आवश्यक है।

Request

POST

/openapi/creative-lab/fidget-collapsible/v1

curl https://api.meshy.ai/openapi/creative-lab/fidget-collapsible/v1 \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "image_url": "<your publicly accessible image url or base64-encoded data URI>"
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}

पैरामीटर

Name
image_url
Type
string
आवश्यक
Description
वह फ़ोटो जिसे collapsible fidget में बदलना है, एक सार्वजनिक URL या data URI (data:image/jpeg;base64,<your base64-encoded image data>) के रूप में।
इमेज अधिकतम 20 MB की JPG, JPEG, PNG, या WebP फ़ाइल होनी चाहिए।
सब्जेक्ट की सिल्हूट रिंग्स बन जाती है, इसलिए एक स्पष्ट, बंद आउटलाइन वाला सब्जेक्ट सबसे अच्छा काम करता है। भरा-पूरा बैकग्राउंड, कई अलग-अलग सब्जेक्ट्स, या बहुत पतली आकृतियाँ नेस्टेड दीवारों के लिए बहुत कम जगह छोड़ सकती हैं। ऐसे मामले में, टास्क विफल हो जाता है।
Name
name
Type
string
Description
टास्क के लिए एक नाम, अधिकतम 100 अक्षर। यह टास्क के name फ़ील्ड में वापस आता है, और Meshy इसे मॉडल पर अंकित नहीं करता। इससे लंबा नाम 400 लौटाता है।

रिटर्न

result फ़ील्ड में नए टास्क की ID होती है। टास्क प्राप्त करें या इसे स्ट्रीम करें जब तक कि status, SUCCEEDED न हो जाए। फिर model_urls.stl से प्रिंट करने योग्य STL फ़ाइल डाउनलोड करें। मॉडल को पहले प्रीव्यू करने के लिए, जब model_urls.glb मौजूद हो तो उससे GLB फ़ाइल डाउनलोड करें।

विफलता के मामले

Name
400 - Bad Request
Description
रिक्वेस्ट चल नहीं सकती। उदाहरण के लिए:
- image_url मौजूद नहीं है।
- इमेज JPG, JPEG, PNG, या WebP फ़ाइल नहीं है।
- इमेज बहुत छोटी है, 20 MB से अधिक है, या अधिकतम पिक्सेल संख्या से अधिक है।
- Meshy इमेज डाउनलोड नहीं कर पाता, उदाहरण के लिए क्योंकि URL 404 लौटाता है या टाइमआउट हो जाता है।
- data URI वैध base64 नहीं है।
- इमेज को NSFW के रूप में फ़्लैग किया गया था।
एरर मैसेज बताता है कि कौन सी समस्या मिली। रिक्वेस्ट ठीक करें, फिर इसे दोबारा भेजें।
Name
401 - Unauthorized
Description
API की गायब है या अमान्य है। Authorization हेडर जांचें।
Name
402 - Payment Required
Description
इनमें से कोई एक लागू होता है:
- अकाउंट के पास पर्याप्त क्रेडिट नहीं हैं।
- API की, वर्कस्पेस, या सदस्य अपनी क्रेडिट लिमिट तक पहुंच गया।
- अकाउंट फ्री प्लान पर है।
अपने क्रेडिट और प्लान जांचें, फिर दोबारा कोशिश करें।
Name
403 - Forbidden
Description
आपकी टीम में IP Filtering चालू है, और Meshy ने इमेज को थर्ड-पार्टी इंटेलेक्चुअल प्रॉपर्टी के लिए फ़्लैग किया है। ऐसी इमेज भेजें जिसका उपयोग करने का आपके पास अधिकार हो।
Name
429 - Too Many Requests
Description
इनमें से एक लिमिट तक पहुंच गई:
- आपने अपनी रेट लिमिट से अधिक रिक्वेस्ट भेजीं। कुछ सेकंड प्रतीक्षा करें, फिर दोबारा कोशिश करें। Rate limits देखें।
- आपके बहुत सारे टास्क कतार में हैं या चल रहे हैं। कुछ के पूरा होने की प्रतीक्षा करें, फिर दोबारा कोशिश करें।
- बिना क्रेडिट के unlimited प्लान पर, आप बिना क्रेडिट के चल सकने वाले टास्क की संख्या तक पहुंच गए। किसी टास्क के पूरा होने की प्रतीक्षा करें, या क्रेडिट जोड़ें।
Name
500 - Internal Server Error
Description
Meshy को एक सर्वर एरर मिला, उदाहरण के लिए क्योंकि वह इमेज पर इंटेलेक्चुअल प्रॉपर्टी जांच नहीं चला सका। Meshy टास्क नहीं बनाता, और उसने जो भी क्रेडिट चार्ज किए थे उन्हें रिफंड कर देता है। रिक्वेस्ट दोबारा कोशिश करें।

GET/openapi/creative-lab/fidget-collapsible/v1/:id

एक Collapsible Fidget टास्क प्राप्त करें

यह एक Collapsible Fidget टास्क लौटाता है। केवल इस एंडपॉइंट से बनाए गए टास्क ही लौटाए जाते हैं। किसी अन्य Creative Lab एंडपॉइंट से, या वेब ऐप में बनाए गए टास्क के लिए, 404 लौटाया जाता है।

फ़ील्ड्स के लिए, देखें The Collapsible Fidget task object।

Request

GET

/openapi/creative-lab/fidget-collapsible/v1/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/creative-lab/fidget-collapsible/v1/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-fidget-collapsible",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123512000,
  "expires_at": 1729382712000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  }
}

पैरामीटर

Name
id
Type
path
Description
क्रिएट रिस्पॉन्स से मिला टास्क ID।

रिटर्न

Collapsible Fidget task object।

विफलता के तरीके

Name
400 - Bad Request
Description
id मान्य टास्क ID नहीं है। क्रिएट रिस्पॉन्स से मिला result ID भेजें।
Name
403 - Forbidden
Description
आपकी टीम में IP Filtering चालू है, और Meshy ने थर्ड-पार्टी इंटेलेक्चुअल प्रॉपर्टी के लिए टास्क की इमेज को फ़्लैग कर दिया है। Enterprise प्लान वाली टीमों को यह एरर नहीं मिलता है। ऐसी इमेज से टास्क बनाएं जिसका उपयोग करने का आपके पास अधिकार है।
Name
404 - Not Found
Description
इस ID वाला कोई भी Collapsible Fidget टास्क आपके अकाउंट से संबंधित नहीं है, या टास्क इस एंडपॉइंट से नहीं बनाया गया था। ID जाँचें।
Name
500 - Internal Server Error
Description
Meshy इंटेलेक्चुअल प्रॉपर्टी जाँच नहीं चला सका। रिक्वेस्ट फिर से भेजें।

DELETE/openapi/creative-lab/fidget-collapsible/v1/:id

Collapsible Fidget टास्क हटाएँ

एक Collapsible Fidget टास्क को कैंसिल करता है। PENDING टास्क को कैंसिल करने पर उसके क्रेडिट रिफंड कर दिए जाते हैं। एक IN_PROGRESS टास्क बिना रिफंड के कैंसिल होता है, क्योंकि एक वर्कर पहले ही उसे शुरू कर चुका होता है। जिस टास्क की स्थिति अंतिम हो (SUCCEEDED, FAILED, या CANCELED) उसे कैंसिल नहीं किया जा सकता।

Request

DELETE

/openapi/creative-lab/fidget-collapsible/v1/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/fidget-collapsible/v1/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 204 No Content on success (empty body).

पथ पैरामीटर

Name
id
Type
path
Description
कैंसिल किए जाने वाले टास्क की ID।

रिटर्न वैल्यू

204 No Content खाली बॉडी के साथ।

विफलता के तरीके

Name
400 - Bad Request
Description
इनमें से कोई एक लागू होता है:
- id एक मान्य टास्क ID नहीं है। क्रिएट रिस्पॉन्स से result ID भेजें।
- टास्क की स्थिति पहले से ही अंतिम है (SUCCEEDED, FAILED, या CANCELED), इसलिए इसे कैंसिल नहीं किया जा सकता।
Name
404 - Not Found
Description
इस ID वाला कोई Collapsible Fidget टास्क आपके अकाउंट से संबंधित नहीं है, या यह टास्क इस एंडपॉइंट के साथ नहीं बनाया गया था। ID जाँचें।

GET/openapi/creative-lab/fidget-collapsible/v1/:id/stream

एक Collapsible Fidget टास्क को स्ट्रीम करें

किसी Collapsible Fidget टास्क के अपडेट्स को Server-Sent Events (SSE) के रूप में स्ट्रीम करता है। यदि टास्क मौजूद नहीं है या इसे इस एंडपॉइंट के साथ नहीं बनाया गया था, तो स्ट्रीम status_code: 404 के साथ एक error इवेंट भेजती है और बंद हो जाती है।

Request

GET

/openapi/creative-lab/fidget-collapsible/v1/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/creative-lab/fidget-collapsible/v1/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example (task not found, or not created through this endpoint)
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 following PENDING frame is shortened to the fields that change.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-fidget-collapsible",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123512000,
  "expires_at": 1729382712000,
  "task_error": null,
  "consumed_credits": 6,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  }
}

पैरामीटर

Name
id
Type
path
Description
create रिस्पॉन्स से टास्क ID।

रिटर्न वैल्यू

Collapsible Fidget टास्क ऑब्जेक्ट्स की एक स्ट्रीम। प्रत्येक इवेंट में पूरा टास्क ऑब्जेक्ट होता है, जैसा एक Collapsible Fidget टास्क प्राप्त करें इसे लौटाता है। जब तक टास्क PENDING या IN_PROGRESS है, इसके आउटपुट फ़ील्ड्स अभी भी खाली रहते हैं (null, [], या {}), और finished_at null होता है।

यदि IP Filtering टास्क के परिणाम को ब्लॉक करती है, तो स्ट्रीम उसकी जगह पर एक error इवेंट भेजती है, जिसमें वह status_code होगा जो get रिक्वेस्ट लौटाती।

GET/openapi/creative-lab/fidget-collapsible/v1

कोलैप्सिबल फ़िजेट टास्क की सूची

आपके कोलैप्सिबल फ़िजेट टास्क एक बार में एक पेज में लौटाता है। केवल इस एंडपॉइंट से बनाए गए टास्क ही शामिल किए जाते हैं।

Request

GET

/openapi/creative-lab/fidget-collapsible/v1

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

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "creative-lab-fidget-collapsible",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729123456000,
    "started_at": 1729123460000,
    "finished_at": 1729123512000,
    "expires_at": 1729382712000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
      "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
    }
  }
]

क्वेरी पैरामीटर

Name
page_num
Type
integer
डिफ़ॉल्ट 1
Description
लौटाया जाने वाला पेज, 1 से 255 तक। 0 पहला पेज लौटाता है। 0 से 255 के बाहर का मान 400 लौटाता है।
Name
page_size
Type
integer
डिफ़ॉल्ट 10
Description
प्रति पेज टास्क की संख्या, अधिकतम 100। 101 से 255 के बीच का मान 100 टास्क लौटाएगा, और 0 डिफ़ॉल्ट का उपयोग करता है। 0 से 255 के बाहर का मान 400 लौटाता है।
Name
sort_by
Type
string
डिफ़ॉल्ट -created_at
Description
सॉर्ट क्रम।
उपलब्ध मान:
- -created_at: सबसे नया पहले
- +created_at: सबसे पुराना पहले

रिटर्न

कोलैप्सिबल फ़िजेट टास्क ऑब्जेक्ट्स का एक ऐरे।

The Collapsible Fidget task ऑब्जेक्ट

एक Collapsible Fidget टास्क एक फोटो को प्रिंट-इन-प्लेस कोलैप्सिबल फिजेट मॉडल में बदल देता है। यह एक सिंगल-स्टेज टास्क है, इसलिए इसे चेन करने के लिए कोई prototype टास्क नहीं होता। रिस्पॉन्स में वह सिल्हूट शामिल नहीं होता जो Meshy रास्ते में बनाता है।

Properties

Example Collapsible Fidget Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-fidget-collapsible",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123512000,
  "expires_at": 1729382712000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
    "stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***"
  }
}

Name
id
Type
string
Description
टास्क ID। इसके फॉर्मैट पर भरोसा न करें।
Name
type
Type
string
Description
टास्क का टाइप, हमेशा creative-lab-fidget-collapsible।
Name
name
Type
string
Description
वह name जो आपने टास्क बनाते समय भेजा था, या यदि आपने कोई नहीं भेजा तो ""।
Name
status
Type
string
Description
टास्क की स्थिति।
उपलब्ध मान:
- PENDING: कतार में प्रतीक्षा कर रहा है
- IN_PROGRESS: परिणाम जनरेट कर रहा है
- SUCCEEDED: अंतिम, परिणाम के साथ
- FAILED: अंतिम, कारण task_error में है
- CANCELED: अंतिम, बिना किसी परिणाम के
Name
progress
Type
integer
Description
पूरे हो चुके काम का प्रतिशत, 0 से 100 तक। यह टास्क शुरू होने तक 0 रहता है और सफल होने पर 100 हो जाता है।
Name
created_at
Type
timestamp
Description
टास्क बनाए जाने का समय, यूनिक्स मिलीसेकंड में।
Name
started_at
Type
timestamp
Description
जिस समय किसी वर्कर ने टास्क शुरू किया, यूनिक्स मिलीसेकंड में। तब तक null रहता है।
Name
finished_at
Type
timestamp
Description
जिस समय टास्क अंतिम स्थिति में पहुँचा, यूनिक्स मिलीसेकंड में। तब तक null रहता है।
Name
expires_at
Type
timestamp
Description
जिस समय टास्क का परिणाम एक्सपायर होता है, यूनिक्स मिलीसेकंड में। यह finished_at के 3 दिन बाद होता है, या टास्क के पूरा होने तक created_at के 3 दिन बाद। Enterprise अकाउंट्स के लिए, जो API परिणाम अनिश्चित काल तक रखते हैं, यह लगभग 100 साल बाद होता है। देखें Asset retention।
Name
preceding_tasks
Type
integer
Description
जब टास्क PENDING स्थिति में होता है तब कतार में उसकी स्थिति। 1 का मतलब है कि यह अगला शुरू होगा। टास्क के कतार छोड़ने के बाद 0, और लिस्ट परिणामों में हमेशा 0।
Name
task_error
Type
object
Description
टास्क क्यों विफल हुआ। जब तक status, FAILED न हो तब तक null। देखें एरर।
Name
consumed_credits
Type
integer
Description
किसी भी रिफंड के बाद, टास्क के लिए चार्ज किए गए क्रेडिट की संख्या। जो रिक्वेस्ट एरर लौटाती है उसके लिए चार्ज नहीं लिया जाता। एक विफल टास्क 0 होता है, क्योंकि Meshy उसे रिफंड कर देता है। कैंसिल करने पर टास्क का रिफंड केवल तभी होता है जब वह PENDING स्थिति में हो। यदि Meshy चार्ज नहीं पढ़ पाता, तो get या stream रिस्पॉन्स में यह फील्ड शामिल नहीं होती, और list रिक्वेस्ट 500 लौटाती है। ऐसे में, रिक्वेस्ट को फिर से करें।
Name
model_urls
Type
object
Description
3D मॉडल के लिए डाउनलोड URL, जो टास्क के सफल होने तक खाली रहता है। एक सफल टास्क में हमेशा stl होता है, और glb केवल तभी होता है जब Meshy ने प्रीव्यू रेंडर किया हो।
- Name
  stl
  Type
  string
  Description
  STL फाइल के लिए डाउनलोड URL, जो प्रिंट करने वाली फाइल है। आप इसे सीधे स्लाइसर में खोल सकते हैं।
- Name
  glb
  Type
  string
  Description
  3D व्यूअर में मॉडल प्रीव्यू करने के लिए एक GLB फाइल का डाउनलोड URL। इसके रंग केवल प्रीव्यू के लिए हैं। STL फाइल में कोई रंग नहीं होता, इसलिए प्रिंट किया गया फिजेट अपना रंग फिलामेंट से लेता है।
  यदि Meshy प्रीव्यू रेंडर नहीं कर पाता, तो model_urls में glb key नहीं होती, इसलिए इसे पढ़ने से पहले key की जाँच करें। एक SUCCEEDED टास्क में हमेशा stl होता है।