Creative Lab विनाइल फिगर API

एक फोटो को दो चरणों में एक बड़े सिर वाले विनाइल कलेक्टिबल 3D फिगर में बदलें। एक प्रोटोटाइप टास्क फोटो से एक कॉन्सेप्ट इमेज जनरेट करता है। एक बिल्ड टास्क उस इमेज को एक टेक्सचर्ड 3D मॉडल में बदलता है, और प्रोटोटाइप टास्क की ID को input_task_id के रूप में लेता है।

POST /openapi/creative-lab/vinyl-figure/v1/prototype
POST /openapi/creative-lab/vinyl-figure/v1/build

POST/openapi/creative-lab/vinyl-figure/v1/prototype

एक Vinyl Figure prototype टास्क बनाएं

एक फोटो से vinyl-figure-style कॉन्सेप्ट इमेज जनरेट करता है। 3D मॉडल बनाने के लिए, इस टास्क की ID को input_task_id के रूप में build endpoint में पास करें। टास्क के फ़ील्ड्स के लिए, The Vinyl Figure prototype task object देखें।

Request

POST

/openapi/creative-lab/vinyl-figure/v1/prototype

# Stage 1: generate a vinyl-figure-style concept image
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype \
  -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": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}

Prototype example

Start with a source photo, then generate the prototype image used by the build stage.

Source photo used as the Creative Lab Vinyl Figure input — Prototype input

Big-head vinyl figure prototype image generated from the source photo — Prototype output

पैरामीटर

Name
image_url
Type
string
आवश्यक
Description
उस फोटो को, जिसे big-head vinyl figure में बदलना है, एक पब्लिक 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 फ़ील्ड में वापस मिलता है। इससे लंबा नाम देने पर 400 रिटर्न होता है।
Name
remove_background
Type
boolean
डिफ़ॉल्ट false
Description
क्या prototype इमेज से बैकग्राउंड हटाया जाए। true देने पर एक ट्रांसपेरेंट RGBA PNG मिलती है, ताकि आप सब्जेक्ट को किसी भी बैकग्राउंड पर रख सकें। build भी बैकग्राउंड के बिना वाली इमेज से ही शुरू होता है। अगर Meshy बैकग्राउंड नहीं हटा पाता, तो यह बैकग्राउंड सहित इमेज लौटाता है, और टास्क फिर भी सफल होता है।

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

result फ़ील्ड में नए prototype टास्क की ID होती है। status के SUCCEEDED होने तक टास्क पाएं या इसे स्ट्रीम करें। फिर इस ID को input_task_id के रूप में build endpoint में पास करें।

फेल्योर मोड्स

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।
- आपके बहुत ज़्यादा टास्क क्यूड या रनिंग हैं। कुछ के पूरा होने का इंतज़ार करें, फिर दोबारा कोशिश करें।
- अनलिमिटेड प्लान पर, बिना बचे क्रेडिट के, आप बिना क्रेडिट के चलने वाले टास्क की संख्या तक पहुंच गए हैं। किसी टास्क के पूरा होने का इंतज़ार करें, या क्रेडिट जोड़ें।
Name
500 - Internal Server Error
Description
Meshy को एक सर्वर एरर मिली, उदाहरण के लिए क्योंकि यह इमेज पर इंटेलेक्चुअल प्रॉपर्टी चेक नहीं चला सका। Meshy टास्क नहीं बनाता, और इसके द्वारा चार्ज किए गए किसी भी क्रेडिट को रिफंड कर देता है। रिक्वेस्ट दोबारा भेजें।

POST/openapi/creative-lab/vinyl-figure/v1/build

एक Vinyl Figure बिल्ड टास्क बनाएं

एक सफल प्रोटोटाइप टास्क से टेक्सचर्ड 3D vinyl फिगर जनरेट करता है। इसके फ़ील्ड्स के लिए, देखें The Vinyl Figure build task object।

Request

POST

/openapi/creative-lab/vinyl-figure/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
  }'

Response

{
  "result": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef"
}

पैरामीटर

Name
input_task_id
Type
string
आवश्यक
Description
बिल्ड करने के लिए प्रोटोटाइप टास्क की ID। यह आपके अकाउंट द्वारा POST /openapi/creative-lab/vinyl-figure/v1/prototype से बनाया गया एक टास्क होना चाहिए, जिसका स्टेटस SUCCEEDED हो।
ऐसी ID जो API से बने आपके Vinyl Figure प्रोटोटाइप टास्क में से एक नहीं है, 404 लौटाती है, जिसमें वेब ऐप में बनाया गया प्रोटोटाइप भी शामिल है।
Name
name
Type
string
Description
टास्क के लिए एक नाम, 100 वर्णों तक। यह टास्क के name फ़ील्ड में वापस आता है। एक लंबा नाम 400 लौटाता है।

रिटर्न्स

result फ़ील्ड में नए बिल्ड टास्क की ID होती है। टास्क प्राप्त करें या इसे स्ट्रीम करें जब तक status, SUCCEEDED न हो जाए। फिर model_urls.glb से टेक्सचर्ड GLB डाउनलोड करें। इसके बजाय OBJ के लिए, model_urls.obj को इसकी मटेरियल फ़ाइल के साथ model_urls.mtl से डाउनलोड करें।

फेल्यर मोड्स

Name
400 - Bad Request
Description
रिक्वेस्ट रन नहीं हो सकती। उदाहरण के लिए:
- input_task_id मौजूद नहीं है या एक मान्य टास्क ID नहीं है।
- प्रोटोटाइप टास्क का स्टेटस SUCCEEDED नहीं है। अगर यह अभी भी चल रहा है, तो प्रतीक्षा करें और फिर से प्रयास करें। अगर यह फेल हो गया या कैंसल कर दिया गया, तो एक नया प्रोटोटाइप टास्क बनाएं।
- प्रोटोटाइप टास्क सफल हुआ लेकिन इसमें कोई इमेज नहीं है। एक नया प्रोटोटाइप टास्क बनाएं।
एरर मैसेज बताता है कि कौन सी समस्या मिली।
Name
401 - Unauthorized
Description
API की मौजूद नहीं है या अमान्य है। Authorization हेडर जांचें।
Name
402 - Payment Required
Description
इनमें से कोई एक लागू होता है:
- अकाउंट में पर्याप्त क्रेडिट नहीं हैं।
- API की, वर्कस्पेस, या सदस्य अपनी क्रेडिट सीमा तक पहुंच गया।
- अकाउंट फ्री प्लान पर है।
अपने क्रेडिट और प्लान की जांच करें, फिर फिर से प्रयास करें।
Name
404 - Not Found
Description
input_task_id आपके अकाउंट द्वारा API से बनाए गए किसी भी Vinyl Figure प्रोटोटाइप टास्क से मेल नहीं खाता। वेब ऐप में बनाया गया प्रोटोटाइप भी 404 लौटाता है। प्रोटोटाइप क्रिएट रिस्पॉन्स से result ID भेजें।
Name
429 - Too Many Requests
Description
इनमें से एक लिमिट तक पहुंच गई थी:
- आपने अपनी रेट लिमिट से अधिक रिक्वेस्ट भेजीं। कुछ सेकंड प्रतीक्षा करें, फिर फिर से प्रयास करें। देखें Rate limits।
- आपके बहुत सारे टास्क कतार में हैं या चल रहे हैं। कुछ के पूरा होने की प्रतीक्षा करें, फिर फिर से प्रयास करें।
- बिना क्रेडिट वाले अनलिमिटेड प्लान पर, आप बिना क्रेडिट के चल सकने वाले टास्क की संख्या तक पहुंच गए। किसी टास्क के पूरा होने की प्रतीक्षा करें, या क्रेडिट जोड़ें।

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

Vinyl Figure टास्क प्राप्त करें

यह एक प्रोटोटाइप या बिल्ड टास्क लौटाता है। पाथ को टास्क के स्टेज से मेल खाना चाहिए। /prototype/:id के माध्यम से अनुरोधित बिल्ड टास्क 404 लौटाता है, और /build/:id के माध्यम से अनुरोधित प्रोटोटाइप टास्क के लिए भी यही होता है।

फ़ील्ड्स के लिए, देखें The Vinyl Figure prototype task object और The Vinyl Figure build task object.

Request

GET

/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de

# Prototype
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# Build
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

पैरामीटर

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

रिटर्न

पाथ में मौजूद स्टेज के अनुसार, prototype task object या build 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 का कोई Vinyl Figure टास्क मौजूद नहीं है, या टास्क का स्टेज पाथ से मेल नहीं खाता है। ID जांचें, और टास्क से मेल खाने के लिए /prototype या /build का उपयोग करें।
Name
500 - Internal Server Error
Description
Meshy इंटेलेक्चुअल प्रॉपर्टी चेक नहीं चला सका। रिक्वेस्ट को फिर से प्रयास करें।

DELETE/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id

Vinyl फिगर टास्क को डिलीट करें

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

पाथ को टास्क के स्टेज से मेल खाना चाहिए। उदाहरण के लिए, किसी build टास्क की ID के साथ /prototype/:id पर DELETE करने से 404 मिलता है।

Request

DELETE

/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de

curl --request DELETE \
  --url https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype/019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de \
  -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 वाला कोई Vinyl फिगर टास्क आपके अकाउंट से संबंधित नहीं है, या टास्क का स्टेज पाथ से मेल नहीं खाता। ID की जांच करें, और टास्क से मेल खाने के लिए /prototype या /build का उपयोग करें।

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)/:id/stream

एक Vinyl Figure टास्क को स्ट्रीम करें

Vinyl Figure टास्क के अपडेट्स को Server-Sent Events (SSE) के रूप में स्ट्रीम करता है। पाथ को टास्क के स्टेज से मेल खाना चाहिए। अगर यह मेल नहीं खाता, उदाहरण के लिए किसी build टास्क की ID /prototype/:id/stream पर, तो स्ट्रीम एक error इवेंट भेजती है जिसमें status_code: 404 होता है और फिर बंद हो जाती है।

Request

GET

/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream

curl -N https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example (wrong stage or task not found)
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": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

पैरामीटर

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

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

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

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

GET/openapi/creative-lab/vinyl-figure/v1/(prototype|build)

Vinyl Figure टास्क सूचीबद्ध करें

यह एक समय में एक पेज पर, एक स्टेज के आपके Vinyl Figure टास्क लौटाता है। पाथ स्टेज का चयन करता है। /prototype केवल प्रोटोटाइप टास्क लौटाता है, और /build केवल बिल्ड टास्क लौटाता है।

Request

GET

/openapi/creative-lab/vinyl-figure/v1/prototype

# List prototype tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# List build tasks
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response (List Prototype Tasks)

[
  {
    "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
    "type": "creative-lab-vinyl-figure-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1752969600000,
    "started_at": 1752969604000,
    "finished_at": 1752969630000,
    "expires_at": 1753228830000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

पाथ पैरामीटर

Name
stage
Type
path
आवश्यक
Description
सूचीबद्ध करने के लिए स्टेज, prototype या build।

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

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: सबसे पुराना पहले

रिटर्न

प्रोटोटाइप टास्क ऑब्जेक्ट्स या बिल्ड टास्क ऑब्जेक्ट्स का एक ऐरे, जो पाथ में दिए गए स्टेज से मेल खाता है।

वाइनिल फिगर प्रोटोटाइप टास्क ऑब्जेक्ट

एक प्रोटोटाइप टास्क किसी फोटो से वाइनिल-फिगर-स्टाइल कॉन्सेप्ट इमेज जनरेट करता है। इमेज को 3D मॉडल में बदलने के लिए, टास्क की ID को input_task_id के रूप में बिल्ड एंडपॉइंट को पास करें।

Properties

Example Vinyl Figure Prototype Task Object

{
  "id": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de",
  "type": "creative-lab-vinyl-figure-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969600000,
  "started_at": 1752969604000,
  "finished_at": 1752969630000,
  "expires_at": 1753228830000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Name
id
Type
string
Description
टास्क ID। इसके फॉर्मेट पर भरोसा न करें।
Name
type
Type
string
Description
टास्क का प्रकार, हमेशा creative-lab-vinyl-figure-prototype।
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
जिस समय टास्क का परिणाम समाप्त (expire) होता है, यूनिक्स मिलीसेकंड में। यह 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
image_urls
Type
array of strings
Description
कॉन्सेप्ट इमेज के लिए डाउनलोड URL। टास्क सफल होने के बाद ऐरे में एक URL होता है, और तब तक यह खाली रहता है।

Vinyl फिगर बिल्ड टास्क ऑब्जेक्ट

एक बिल्ड टास्क एक सफल prototype टास्क से एक टेक्सचर्ड 3D vinyl फिगर जनरेट करता है। इसके model_urls, thumbnail_url, और texture_urls फ़ील्ड्स का फ़ॉर्मेट इमेज से 3D टास्क ऑब्जेक्ट जैसा ही है।

प्रॉपर्टीज़

Example Vinyl Figure Build Task Object

{
  "id": "019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef",
  "type": "creative-lab-vinyl-figure-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1752969700000,
  "started_at": 1752969710000,
  "finished_at": 1752969735000,
  "expires_at": 1753228935000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "prompt": "",
  "negative_prompt": "",
  "texture_prompt": "",
  "texture_image_url": "",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.obj?Expires=***",
    "mtl": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/model.mtl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/preview.png?Expires=***",
  "texture_urls": [
    {
      "base_color": "https://assets.meshy.ai/***/tasks/019c8a31-6e2f-7b4d-9a55-4c3098b2d5ef/output/texture_0.png?Expires=***"
    }
  ]
}

Name
id
Type
string
Description
टास्क ID। इसके फ़ॉर्मेट पर भरोसा न करें।
Name
type
Type
string
Description
टास्क का प्रकार, हमेशा creative-lab-vinyl-figure-build।
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
टास्क बनाए जाने का समय, Unix मिलीसेकंड में।
Name
started_at
Type
timestamp
Description
जिस समय किसी वर्कर ने टास्क शुरू किया, Unix मिलीसेकंड में। तब तक null रहता है।
Name
finished_at
Type
timestamp
Description
जिस समय टास्क अंतिम स्थिति में पहुँचा, Unix मिलीसेकंड में। तब तक null रहता है।
Name
expires_at
Type
timestamp
Description
जिस समय टास्क का परिणाम समाप्त (expire) होता है, Unix मिलीसेकंड में। यह finished_at के 3 दिन बाद का समय है, या टास्क के समाप्त होने तक created_at के 3 दिन बाद का। Enterprise अकाउंट्स के लिए, जो API परिणामों को अनिश्चित काल तक रखते हैं, यह लगभग 100 साल बाद का समय होता है। एसेट रिटेंशन देखें।
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 रिस्पॉन्स में यह फ़ील्ड शामिल नहीं होता, और लिस्ट रिक्वेस्ट 500 लौटाती है। ऐसी स्थिति में, रिक्वेस्ट को फिर से करें।
Name
prompt
Type
string
Description
Vinyl फिगर बिल्ड टास्क के लिए हमेशा ""।
Name
negative_prompt
Type
string
Description
prompt की तरह, Vinyl फिगर बिल्ड टास्क के लिए हमेशा ""।
Name
texture_prompt
Type
string
Description
prompt की तरह, Vinyl फिगर बिल्ड टास्क के लिए हमेशा ""।
Name
texture_image_url
Type
string
Description
prompt की तरह, Vinyl फिगर बिल्ड टास्क के लिए हमेशा ""।
Name
model_urls
Type
object
Description
टेक्सचर्ड GLB के रूप में और उसकी MTL फ़ाइल के साथ OBJ फ़ाइल के रूप में, 3D मॉडल के लिए डाउनलोड URLs।
- Name
  glb
  Type
  string
  Description
  टेक्सचर्ड GLB फ़ाइल के लिए डाउनलोड URL।
- Name
  obj
  Type
  string
  Description
  ज्यामिति और UVs के साथ, OBJ फ़ाइल के लिए डाउनलोड URL।
- Name
  mtl
  Type
  string
  Description
  obj के साथ उपयोग होने वाली MTL मटेरियल फ़ाइल के लिए डाउनलोड URL। इसे obj के साथ और texture_urls[0].base_color में मौजूद टेक्सचर के साथ इस्तेमाल करें।
Name
thumbnail_url
Type
string
Description
मॉडल की एक प्रीव्यू इमेज के लिए डाउनलोड URL।
Name
texture_urls
Type
array
Description
टेक्सचर मैप्स, एक ऐसे ऐरे के रूप में जिसमें बेस कलर मैप रखने वाला एक ऑब्जेक्ट हो।
- Name
  base_color
  Type
  string
  Description
  बेस कलर मैप के लिए डाउनलोड URL।