Creative Lab — विनाइल फिगर एपीआई

एक स्रोत फोटो को दो चरणों में बड़े सिर वाले विनाइल कलेक्टिबल 3डी फिगर में बदलें: प्रोटोटाइप आपके इनपुट फोटो से एक स्टाइल की गई कांसेप्ट इमेज उत्पन्न करता है, फिर बिल्ड उस कांसेप्ट इमेज को एक textured 3D मॉडल में बदल देता है। ये दोनों चरण 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

एक विनाइल फिगर प्रोटोटाइप टास्क बनाएं

स्रोत फोटो से एकल विनाइल-फिगर-शैली की अवधारणा छवि उत्पन्न करें। लौटाए गए टास्क आईडी का इस्तेमाल input_task_id के रूप में निर्माण एंडपॉइंट पर करें। विवरण के लिए द विनाइल फिगर प्रोटोटाइप टास्क ऑब्जेक्ट देखें।

पैरामीटर

Name
image_url
Type
string
आवश्यक
Description
מקור फोटो जिसे Meshy बड़े सिर वाले विनाइल फिगर की तरह शैलीबद्ध करेगा। हम फिलहाल .jpg, .jpeg, .png, और .webp प्रारूपों का समर्थन करते हैं।
फ़ोटो प्रदान करने के दो तरीके हैं:
- सार्वजनिक रूप से पहुँचा जा सकने वाला URL: एक URL जो सार्वजनिक इंटरनेट से पहुँचा जा सकता है।
- डाटा URI: डाटा URI का base64-encoded रूप। डाटा URI का उदाहरण: data:image/jpeg;base64,<आपका base64-encoded फोटो डाटा>.
Name
name
Type
string
Description
प्रदर्शन उद्देश्यों के लिए वैकल्पिक टास्क नाम। अधिकतम 100 वर्ण।

रिटर्न्स

प्रतिक्रिया की result प्रॉपर्टी में नव निर्मित विनाइल फिगर प्रोटोटाइप टास्क की टास्क id होती है। एक टास्क प्राप्त करें एंडपॉइंट को पूछे या तब तक स्ट्रीम की सदस्यता लें जब तक टास्क SUCCEEDED तक नहीं पहुंच जाता, फिर उस ID को input_task_id के रूप में बिल्ड एंडपॉइंट पर पास करें।

असफल परिस्थितियाँ

Name
400 - Bad Request
Description
अनुरोध अस्वीकार्य था। सामान्य कारण:
- पैरामीटर गायब है: image_url आवश्यक है।
- अमान्य छवि प्रारूप: प्रदान की गई image_url समर्थित प्रारूप नहीं है (.jpg, .jpeg, .png, .webp)।
- छवि आयाम सीमा से बाहर: छवि बहुत छोटी है, अधिकतम फाइल आकार को पार कर गई है, या अधिकतम पिक्सल गिनती को पार कर गई है।
- अप्राप्य URL: image_url डाउनलोड नहीं किया जा सका (404 या timeout)।
- अमान्य डाटा URI: base64 स्ट्रिंग अस फिरम।
- कंटेंट फ्लैग किया गया: इनपुट इमेज को NSFW या इंटेलेक्चुअल प्रॉपर्टी moderation द्वारा फ्लैग किया गया।
Name
401 - Unauthorized
Description
प्रमाणीकरण विफल रहा। कृपया अपनी API key की जाँच करें।
Name
402 - Payment Required
Description
इस कार्य को करने के लिए अपर्याप्त क्रेडिट।
Name
429 - Too Many Requests
Description
आप अपनी रेट लिमिट से अधिक हो गए हैं।

Request

POST

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

# चरण 1: एक विनाइल-फिगर-शैली अवधारणा छवि उत्पन्न करें
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": "<आपका सार्वजनिक रूप से पहुँचा जा सकने वाला छवि यूआरएल या base64-encoded डाटा URI>"
  }'

Response

{
  "result": "019c8a2e-4b7d-7c3a-8d21-3f2987a1c4de"
}

Prototype example

Start with a source portrait, 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

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

विनाइल फिगर बिल्ड टास्क बनाएं

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

पैरामीटर

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

रिटर्न्स

प्रतिक्रिया की result संपत्ति नव निर्मित विनाइल फिगर बिल्ड टास्क का टास्क id होता है। टास्क प्राप्त करें endpoint को पोल करें या स्ट्रीम को सब्सक्राइब करें जब तक कि टास्क SUCCEEDED तक न पहुँच जाएं, फिर model_urls.glb से टेक्सचरड GLB डाउनलोड करें (या यदि आपका डाउनस्ट्रीम पाईपलाइन OBJ पसंद करता है तो model_urls.obj और model_urls.mtl से OBJ + MTL जोड़ी)।

विफलता के रूप

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

अनुरोध

POST

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

# चरण 2: एक सफल प्रोटोटाइप टास्क से चेन बिल्ड करें
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"
  }'

प्रतिक्रिया

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

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

विनाइल फिगर कार्य प्राप्त करें

एक वैध कार्य id के दिए गए प्रोटोटाइप या निर्माण कार्य को प्राप्त करें। URL पथ को कार्य के चरण से मेल खाना चाहिए — /prototype/:id के माध्यम से प्राप्त निर्माण कार्य 404 लौटाता है, और इसके विपरीत भी।

प्रतिक्रिया संरचनाओं के लिए विनाइल फिगर प्रोटोटाइप कार्य ऑब्जेक्ट और विनाइल फिगर निर्माण कार्य ऑब्जेक्ट का संदर्भ लें।

पैरामीटर्स

Name
id
Type
path
Description
पुनः प्राप्त करने के लिए विनाइल फिगर कार्य का अद्वितीय पहचानकर्ता।

लौटाएँ

प्रतिक्रिया में विनाइल फिगर कार्य ऑब्जेक्ट होता है। आकार इस पर निर्भर करता है कि कौन सा चरण अनुरोधित था।

अनुरोध

GET

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

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

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

प्रोटोटाइप प्रतिक्रिया

{
  "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=***"
  ]
}

निर्माण प्रतिक्रिया

{
  "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=***"
    }
  ]
}

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

विनाइल फिगर कार्य हटाएं

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

URL पथ को कार्य की स्थिति से मेल खाना चाहिए — /prototype/:buildId पर DELETE 404 देता है।

पाथ पैरामीटर्स

Name
id
Type
path
Description
रद्द किए जाने वाले विनाइल फिगर कार्य के लिए अद्वितीय पहचानकर्ता।

रिटर्न्स

सफल होने पर 204 No Content को खाली शरीर के साथ लौटाता है।

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

Name
400 - Bad Request
Description
कार्य पहले से ही अंतिम स्थिति में है और इसे रद्द नहीं किया जा सकता।
Name
404 - Not Found
Description
कार्य मौजूद नहीं है, किसी अन्य उपयोगकर्ता का है, या उसकी स्थिति URL पथ से मेल नहीं खाती।

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

// सफल होने पर 204 No Content लौटाता है (खाली शरीर)।

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

विनाइल फिगर कार्य को स्ट्रीम करें

सर्वर-सेंट इवेंट्स (SSE) के माध्यम से विनाइल फिगर कार्य के लिए रीयल-टाइम अपडेट स्ट्रीम करें। URL पथ कार्य के चरण से मेल खाना चाहिए — /prototype/:buildId/stream पर एक स्ट्रीम खोलने से event: error पेलोड के साथ एकल status_code: 404 उत्पन्न होता है और स्ट्रीम बंद हो जाती है।

पैरामीटर्स

Name
id
Type
path
Description
स्ट्रीम करने के लिए विनाइल फिगर कार्य का यूनिक पहचानकर्ता।

लौटाता है

Vinyl Figure Prototype या Vinyl Figure Build कार्य वस्तुओं के रूप में Server-Sent Events की एक स्ट्रीम लौटाता है। PENDING या IN_PROGRESS कार्यों के लिए, प्रतिक्रिया स्ट्रीम केवल आवश्यक progress और status फील्ड्स शामिल करेगी।

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

// एरर इवेंट उदाहरण (गलत चरण या कार्य नहीं मिला)
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// संदेश इवेंट उदाहरण कार्य प्रगति को चित्रित करते हैं।
// PENDING या IN_PROGRESS कार्यों के लिए, प्रतिक्रिया स्ट्रीम सभी फील्ड्स को शामिल नहीं करेगी।
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=***"
    }
  ]
}

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

विनाइल फिगर कार्यों की सूची

अपने विनाइल फिगर कार्यों की एकल चरण के लिए एक पेजिनेशन की गई सूची प्राप्त करें। URL पथ चरण को चुनता है — /prototype प्रोटोटाइप कार्यों को लौटाता है; /build निर्माण कार्यों को लौटाता है। अन्य चरण के कार्यों को दोनों प्रतिक्रिया में शामिल नहीं किया जाता है।

पथ पैरामीटर

Name
stage
Type
path
आवश्यक
Description
prototype या build में से एक। संग्रह केवल उन्हीं कार्यों को लौटाता है जिनके चरण URL से मेल खाते हैं — /prototype को लाने पर कभी भी निर्माण कार्य नहीं लौटाए जाते और इसके विपरीत।

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

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

रिटर्न्स

प्रति-चरण कार्य वस्तुओं की पेजिनेशन की गई सूची लौटाता है — या तो विनाइल फिगर प्रोटोटाइप कार्य वस्तु /prototype को सूचीबद्ध करते समय या विनाइल फिगर निर्माण कार्य वस्तु /build को सूचीबद्ध करते समय।

अनुरोध

GET

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

# प्रोटोटाइप कार्य सूचीबद्ध करें
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/prototype?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

# निर्माण कार्य सूचीबद्ध करें
curl https://api.meshy.ai/openapi/creative-lab/vinyl-figure/v1/build?page_size=10 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

प्रतिक्रिया (प्रोटोटाइप कार्य सूचीबद्ध करें)

[
  {
    "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=***"
    ]
  }
]

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

विनाइल फिगर प्रोटोटाइप टास्क ऑब्जेक्ट वह कार्य इकाई है जिसका Meshy ट्रैक रखता है ताकि एक स्रोत फोटो से विनाइल-फिगर-स्टाइल कॉन्सेप्ट इमेज उत्पन्न किया जा सके। इस चरण का आउटपुट input_task_id के माध्यम से निर्माण चरण में जोड़ा जाता है।

Properties

Name
id
Type
string
Description
कार्य के लिए अद्वितीय पहचानकर्ता। जबकि हम कार्य आईडी के लिए k-सॉर्टेबल UUID का उपयोग करते हैं, आपको आईडी के प्रारूप के बारे में कोई धारणा नहीं बनानी चाहिए।
Name
type
Type
string
Description
कार्य का प्रकार। मान है creative-lab-vinyl-figure-prototype.
Name
name
Type
string
Description
कार्य का नाम जो कार्य बनाते समय प्रदान किया गया था। यदि कोई नाम प्रदान नहीं किया गया था तो खाली स्ट्रिंग।
Name
status
Type
string
Description
कार्य की स्थिति। संभावित मान हैं PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED में से एक।
Name
progress
Type
integer
Description
कार्य की प्रगति। यदि कार्य अभी तक शुरू नहीं हुआ है, तो यह प्रॉपर्टी 0 होगी। एक बार जब कार्य सफल हो जाता है, तो यह 100 हो जाएगा।
Name
created_at
Type
timestamp
Description
जब कार्य बनाया गया था तब का टाइमस्टैंप, मिलीसेकंड में।
एक टाइमस्टैंप जनवरी 1, 1970 UTC से अब तक के मिलीसेकंड संख्या का प्रतिनिधित्व करता है, RFC 3339 मानक का पालन करते हुए। उदाहरण के लिए, शुक्रवार, सितंबर 1, 2023 12:00:00 बजे GMT को 1693569600000 के रूप में प्रस्तुत किया जाता है। यह Meshy API में सभी टाइमस्टैंप पर लागू होता है।
Name
started_at
Type
timestamp
Description
जब कार्य शुरू हुआ तब का टाइमस्टैंप, मिलीसेकंड में। यदि कार्य अभी तक शुरू नहीं हुआ है, तो यह प्रॉपर्टी 0 होगी।
Name
finished_at
Type
timestamp
Description
जब कार्य समाप्त हुआ तब का टाइमस्टैंप, मिलीसेकंड में। यदि कार्य अभी तक समाप्त नहीं हुआ है, तो यह प्रॉपर्टी 0 होगी।
Name
expires_at
Type
timestamp
Description
जब कार्य परिणाम समाप्त होगा तब का टाइमस्टैंप, मिलीसेकंड में।
Name
preceding_tasks
Type
integer
Description
पूर्ववर्ती कार्यों की संख्या।
इस फील्ड का मान केवल तभी अर्थपूर्ण है यदि कार्य की स्थिति PENDING है।
Name
task_error
Type
object
Description
असफल कार्यों के लिए एरर विवरण। पूरी task_error ऑब्जेक्ट संदर्भ के लिए Errors देखें।
Name
consumed_credits
Type
integer
Description
इस कार्य द्वारा खपत की गई क्रेडिट की संख्या। जब कार्य की स्थिति PENDING, IN_PROGRESS, या SUCCEEDED हो तो उपस्थित है। FAILED कार्यों के लिए 0 लौटाता है (विफलता पर क्रेडिट की वापसी की जाती है)।
Name
image_urls
Type
array of strings
Description
इस प्रोटोटाइप कार्य द्वारा उत्पन्न अवधारणा छवि उम्मीदवारों के लिए डाउनलोड करने योग्य URL. वर्तमान में एपीआई हमेशा एक उम्मीदवार को वापसी करता है; फील्ड एक array है ताकि भविष्य के संशोधनों में ब्रेकिंग परिवर्तन के बिना एकाधिक उम्मीदवारों को प्रदर्शित किया जा सके।

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=***"
  ]
}

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

विनाइल फिगर बिल्ड टास्क ऑब्जेक्ट एक कार्य इकाई है जिसका Meshy हिसाब रखता है ताकि एक सफल प्रोटोटाइप टास्क से एक टेक्सचर्ड 3D विनाइल फिगर उत्पन्न किया जा सके। यह वही इमेज से 3D पाइपलाइन चलाता है जिसका उपयोग इमेज से 3D द्वारा किया जाता है, इसलिए आउटपुट फ़ील्ड उसी एंडपॉइंट के टास्क ऑब्जेक्ट को प्रतिबिंबित करते हैं।

गुण

Name
id
Type
string
Description
कार्य के लिए एक अद्वितीय पहचानकर्ता।
Name
type
Type
string
Description
कार्य का प्रकार। मान creative-lab-vinyl-figure-build है।
Name
name
Type
string
Description
जब कार्य बनाया गया था तब दिया गया कार्य नाम। यदि कोई नाम नहीं दिया गया, तो यह रिक्त स्ट्रिंग होगा।
Name
status
Type
string
Description
कार्य की स्थिति। संभावित मान हैं PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED में से एक।
Name
progress
Type
integer
Description
कार्य की प्रगति। यदि कार्य अभी तक शुरू नहीं हुआ है तो यह गुण 0 होगा। एक बार जब कार्य सफल हो जाता है, तो यह 100 हो जाएगा।
Name
created_at
Type
timestamp
Description
कार्य कब बनाया गया था इसका टाइमस्टैंप, मिलीसेकंड में।
Name
started_at
Type
timestamp
Description
कार्य कब शुरू हुआ था इसका टाइमस्टैंप, मिलीसेकंड में।
Name
finished_at
Type
timestamp
Description
कार्य कब समाप्त हुआ था इसका टाइमस्टैंप, मिलीसेकंड में।
Name
expires_at
Type
timestamp
Description
कार्य परिणाम कब समाप्त होता है इसका टाइमस्टैंप, मिलीसेकंड में।
Name
preceding_tasks
Type
integer
Description
पूर्ववर्ती कार्यों की संख्या। केवल तब सार्थक जब स्थिति PENDING है।
Name
task_error
Type
object
Description
असफल कार्यों के लिए एरर विवरण। पूर्ण task_error वस्तु संदर्भ के लिए Errors देखें।
Name
consumed_credits
Type
integer
Description
इस कार्य द्वारा उपभोग किए गए क्रेडिट की संख्या। FAILED कार्यों के लिए 0 लौटाता है (असफलता पर क्रेडिट वापस कर दिए जाते हैं)।
Name
prompt
Type
string
Description
विनाइल फिगर निर्माण के लिए हमेशा खाली। साझा V2ImageTo3DTaskResponse आकार के साथ क्रॉस-एंडपॉइंट संगतता के लिए मौजूद जिसमें इमेज से 3D शामिल है।
Name
negative_prompt
Type
string
Description
विनाइल फिगर निर्माण के लिए हमेशा खाली। क्रॉस-एंडपॉइंट संगतता के लिए मौजूद।
Name
texture_prompt
Type
string
Description
विनाइल फिगर निर्माण के लिए हमेशा खाली। क्रॉस-एंडपॉइंट संगतता के लिए मौजूद।
Name
texture_image_url
Type
string
Description
विनाइल फिगर निर्माण के लिए हमेशा खाली। क्रॉस-एंडपॉइंट संगतता के लिए मौजूद।
Name
model_urls
Type
object
Description
जेनरेट किए गए 3D मॉडल के लिए डाउनलोड करने योग्य URL। विनाइल फिगर निर्माण एक टेक्सचर्ड GLB और उन पाइपलाइनों के लिए OBJ + MTL जोड़ी को छोड़ता है जो Wavefront OBJ को प्राथमिकता देती हैं। फ़ील्ड आकार साझा इमेज से 3D मॉडल URLs वस्तु से मेल खाता है ताकि भविष्य के स्वरूप परिवर्तन बिना किसी टूटी हुई बदलाव के हो सके।
- Name
  glb
  Type
  string
  Description
  टेक्सचर्ड GLB फ़ाइल के लिए डाउनलोड करने योग्य URL।
- Name
  obj
  Type
  string
  Description
  वेवफ्रंट OBJ फ़ाइल (ज्यामिति + UV) के लिए डाउनलोड करने योग्य 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
इस कार्य द्वारा उत्पन्न टेक्सचर URL वस्तुओं की एक एकरे। वर्तमान में बेस कलर मैप के साथ एकमात्र वस्तु शामिल होती है।
- Name
  base_color
  Type
  string
  Description
  बेस कलर मैप इमेज के लिए डाउनलोड करने योग्य URL।

उदाहरण विनाइल फिगर निर्माण कार्य वस्तु

{
  "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=***"
    }
  ]
}