Creative Lab — लैंप API

टेक्स्ट prompt या स्रोत फ़ोटो को दो चरणों में 3D-प्रिंट योग्य लैंपशेड में बदलें: प्रोटोटाइप एक स्टाइलाइज़्ड मैट-व्हाइट कॉन्सेप्ट इमेज जनरेट करता है, फिर बिल्ड उस कॉन्सेप्ट इमेज को खोखले STL लैंपशेड में बदलता है (वैकल्पिक रूप से लाइट-सोर्स फ़िक्स्चर के लिए बेस डिस्क के साथ जोड़ा जा सकता है)। दोनों चरण input_task_id के ज़रिए लिंक किए जाते हैं।

POST /openapi/creative-lab/lamp/v1/prototype
POST /openapi/creative-lab/lamp/v1/build

POST/openapi/creative-lab/lamp/v1/prototype

लैंप प्रोटोटाइप कार्य बनाएँ

लैंपशेड के लिए एक एकल मैट-सफेद कॉन्सेप्ट इमेज जनरेट करें — या तो टेक्स्ट prompt (text-to-3D) से या किसी संदर्भ फ़ोटो (image-to-3D) से। लौटाई गई task ID वही है जिसे आप build एंडपॉइंट में input_task_id के रूप में पास करते हैं। प्रतिक्रिया के आकार के लिए The Lamp Prototype Task Object देखें।

पैरामीटर

text या image_url में से ठीक एक आवश्यक है। दोनों पास करने पर, या कोई भी नहीं पास करने पर, 400 लौटता है।

Name
text
Type
string
आवश्यक
Description
वांछित लैंपशेड विषय का वर्णन करने वाला टेक्स्ट prompt। जब image_url छोड़ा गया हो तब आवश्यक। अधिकतम 800 अक्षर।

Name
image_url
Type
string
आवश्यक
Description
स्रोत फ़ोटो जिसे Meshy लैंपशेड के लिए विज़ुअल संदर्भ के रूप में उपयोग करता है। जब text छोड़ा गया हो तब आवश्यक। हम वर्तमान में .jpg, .jpeg, .png, और .webp फ़ॉर्मैट का समर्थन करते हैं।
इमेज प्रदान करने के दो तरीके हैं:
- सार्वजनिक रूप से सुलभ URL: ऐसा URL जो सार्वजनिक इंटरनेट से सुलभ हो।
- Data URI: इमेज का base64-एन्कोडेड data URI। data URI का उदाहरण: data:image/jpeg;base64,<your base64-encoded image data>।

Name
image_subject
Type
string
डिफ़ॉल्ट character
Description
image-to-3D पथ के लिए विषय श्रेणी संकेत। उपलब्ध मान:
- character (डिफ़ॉल्ट) — एकल character / object विषय (फ़िगरिन, जानवर, मैस्कॉट, आदि)।
- landscape — आउटडोर सीन / पैनोरमा विषय (पहाड़, शहर का दृश्य, जंगल, आदि)।
text-to-3D पथ पर अनदेखा किया जाता है।
Name
name
Type
string
Description
प्रदर्शन उद्देश्यों के लिए वैकल्पिक task name। अधिकतम 100 अक्षर।

रिटर्न

प्रतिक्रिया की result property में नए बनाए गए lamp prototype task का task id होता है। Get a Task एंडपॉइंट को poll करें या stream की सदस्यता लें जब तक task SUCCEEDED तक न पहुँच जाए, फिर उस ID को build endpoint में input_task_id के रूप में पास करें।

विफलता मोड

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

Request

POST

/openapi/creative-lab/lamp/v1/prototype

# Stage 1 (image-to-3D): generate a matte-white lampshade concept image
curl https://api.meshy.ai/openapi/creative-lab/lamp/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>",
    "image_subject": "character"
  }'

# Stage 1 (text-to-3D): generate from a text prompt
curl https://api.meshy.ai/openapi/creative-lab/lamp/v1/prototype \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "a stylized owl perched on a tree branch under moonlight"
  }'

Response

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

Prototype example

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

Creative Lab Lamp input के रूप में उपयोग की गई स्रोत बिल्ली फ़ोटो — Prototype input

स्रोत फ़ोटो से जनरेट किया गया Creative Lab Lamp prototype output — Prototype output

POST/openapi/creative-lab/lamp/v1/build

लैंप बिल्ड टास्क बनाएँ

सफल प्रोटोटाइप टास्क से अंतिम 3D-प्रिंट करने योग्य lampshade जनरेट करें। बिल्ड प्रोटोटाइप की कॉन्सेप्ट इमेज पर image-to-3D पाइपलाइन चलाता है, फिर मेश को खोखला करने, ऊपर का हिस्सा समतल करने, वैकल्पिक रूप से बेस काटने, और (जब कोई fixture preset चुना जाता है) प्रकाश स्रोत के लिए एक अलग बेस डिस्क निकालने हेतु लैंप प्रोसेसर के माध्यम से मेश को पोस्ट-प्रोसेस करता है। प्रतिक्रिया के आकार के लिए लैंप बिल्ड टास्क ऑब्जेक्ट देखें।

पैरामीटर

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

`options`

lampshade ज्यामिति के लिए वैकल्पिक ट्यूनिंग पैरामीटर। हर फ़ील्ड का एक उपयुक्त डिफ़ॉल्ट है — केवल वे भेजें जिन्हें आप ओवरराइड करना चाहते हैं।

Name
diameter_mm
Type
number
डिफ़ॉल्ट 80
Description
lampshade बाउंडिंग बॉक्स का लक्षित अधिकतम आयाम, मिलीमीटर में। फिट करने के लिए मेश को समान रूप से स्केल किया जाता है। रेंज: [50, 400].
Name
thickness_mm
Type
number
डिफ़ॉल्ट 1.5
Description
खोखले lampshade की दीवार की मोटाई, मिलीमीटर में। रेंज: (0, 10].
Name
cut_amount_percent
Type
number
डिफ़ॉल्ट 35
Description
ऊपर समतल करने के लिए lampshade की ऊँचाई का प्रतिशत, ताकि प्रिंट बेड पर बैठ सके। रेंज: [1, 100].
Name
light_source_preset
Type
string
डिफ़ॉल्ट bambu_mh001_60mm
Description
Light-source fixture preset जो यह निर्धारित करता है कि lampshade के साथ बेस डिस्क निकाली जाए या नहीं (और कौन-सी)। उपलब्ध मान:
- bambu_mh001_60mm (डिफ़ॉल्ट) — compatible light-source fixture के लिए आकारित 60 mm बेस डिस्क निकालें। परिणाम में model_urls.base_stl शामिल है।
- none — कोई fixture नहीं, कोई बेस डिस्क नहीं। model_urls.base_stl छोड़ा जाता है।
Name
fixture_offset_x_mm
Type
number
डिफ़ॉल्ट 0
Description
lampshade केंद्र के सापेक्ष fixture cutout का क्षैतिज X-axis offset, मिलीमीटर में। केवल तब अर्थपूर्ण जब light_source_preset ≠ none। रेंज: [-80, 80].
Name
fixture_offset_z_mm
Type
number
डिफ़ॉल्ट 0
Description
lampshade के निचले हिस्से के सापेक्ष fixture cutout का वर्टिकल Z-axis offset, मिलीमीटर में। रेंज: [-80, 80].
Name
rotate_x_deg
Type
number
डिफ़ॉल्ट 0
Description
प्रोसेसिंग से पहले इंपोर्ट किए गए मेश पर लागू X axis के चारों ओर रोटेशन, डिग्री में। रेंज: [-360, 360].
Name
rotate_y_deg
Type
number
डिफ़ॉल्ट 0
Description
प्रोसेसिंग से पहले इंपोर्ट किए गए मेश पर लागू Y axis के चारों ओर रोटेशन, डिग्री में। रेंज: [-360, 360].
Name
rotate_z_deg
Type
number
डिफ़ॉल्ट 0
Description
प्रोसेसिंग से पहले इंपोर्ट किए गए मेश पर लागू Z axis के चारों ओर रोटेशन, डिग्री में। रेंज: [-360, 360].
Name
include_result_json
Type
boolean
डिफ़ॉल्ट false
Description
जब true हो और output.format zip हो, तो bundle के अंदर लैंप प्रोसेसर का result.json (जिसमें मापे गए मेश metrics + resolved option set होता है) शामिल करता है। जब output.format stl हो तो अनदेखा किया जाता है।

`output`

वैकल्पिक wire-format selector। डिफ़ॉल्ट stl है।

Name
format
Type
string
डिफ़ॉल्ट stl
Description
बिल्ड द्वारा लौटाया गया artifact bundle। उपलब्ध मान:
- stl (डिफ़ॉल्ट) — lampshade को model_urls.lamp_stl के रूप में लौटाता है, साथ ही जब light_source_preset ≠ none हो तो model_urls.base_stl भी।
- zip — प्रोसेसर द्वारा निकाले गए हर artifact (lamp.stl, वैकल्पिक base.stl, वैकल्पिक result.json) को एक zip में पैकेज करता है और उसे model_urls.bundle_zip के अंतर्गत लौटाता है।

रिटर्न

प्रतिक्रिया की result प्रॉपर्टी में नए बनाए गए लैंप बिल्ड टास्क का टास्क id होता है। Get a Task एंडपॉइंट को पोल करें या stream की सदस्यता लें जब तक टास्क SUCCEEDED तक न पहुँच जाए, फिर model_urls से artifacts डाउनलोड करें।

विफलता मोड

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

Request

POST

/openapi/creative-lab/lamp/v1/build

# Stage 2: chain build off a succeeded prototype task
curl https://api.meshy.ai/openapi/creative-lab/lamp/v1/build \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "options": {
      "diameter_mm": 120,
      "thickness_mm": 2,
      "light_source_preset": "bambu_mh001_60mm",
      "cut_amount_percent": 30
    },
    "output": {
      "format": "stl"
    }
  }'

Response

{
  "result": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb"
}

Build example

The build task turns the selected prototype image into a printable lampshade model.

Creative Lab Lamp build model preview — Build model preview

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

लैंप टास्क प्राप्त करें

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

प्रतिक्रिया संरचनाओं के लिए लैंप प्रोटोटाइप टास्क ऑब्जेक्ट और लैंप बिल्ड टास्क ऑब्जेक्ट देखें।

पैरामीटर

Name
id
Type
path
Description
प्राप्त किए जाने वाले लैंप टास्क का अद्वितीय आइडेंटिफ़ायर।

रिटर्न

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

Request

GET

/openapi/creative-lab/lamp/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

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

# Build
curl https://api.meshy.ai/openapi/creative-lab/lamp/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Prototype Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-lamp-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

Build Response

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-lamp-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "model_urls": {
    "lamp_stl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/lamp.stl?Expires=***",
    "base_stl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/base.stl?Expires=***"
  }
}

DELETE/openapi/creative-lab/lamp/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/lamp/v1/prototype/018a210d-8ba4-705c-b111-1f1776f7f578

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

Response

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

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

लैंप टास्क स्ट्रीम करें

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

पैरामीटर

Name
id
Type
path
Description
स्ट्रीम करने के लिए लैंप टास्क का विशिष्ट आइडेंटिफायर।

रिटर्न

लैंप प्रोटोटाइप या लैंप बिल्ड टास्क ऑब्जेक्ट्स की स्ट्रीम Server-Sent Events के रूप में लौटाता है। PENDING या IN_PROGRESS टास्क के लिए, रिस्पॉन्स स्ट्रीम में केवल आवश्यक progress और status फ़ील्ड शामिल होंगे।

Request

GET

/openapi/creative-lab/lamp/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/stream

curl -N https://api.meshy.ai/openapi/creative-lab/lamp/v1/build/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/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.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-lamp-build",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "task_error": null,
  "consumed_credits": 30,
  "model_urls": {
    "lamp_stl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/lamp.stl?Expires=***",
    "base_stl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/base.stl?Expires=***"
  }
}

GET/openapi/creative-lab/lamp/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 सूचीबद्ध किया जाता है।

Request

GET

/openapi/creative-lab/lamp/v1/prototype

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

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

Response (List Prototype Tasks)

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "creative-lab-lamp-prototype",
    "name": "",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1729123456000,
    "started_at": 1729123460000,
    "finished_at": 1729123486000,
    "expires_at": 1729382686000,
    "preceding_tasks": 0,
    "task_error": null,
    "consumed_credits": 6,
    "image_urls": [
      "https://assets.meshy.ai/***/concept.png?Expires=***"
    ]
  }
]

लैंप प्रोटोटाइप टास्क ऑब्जेक्ट

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

प्रॉपर्टीज़

Name
id
Type
string
Description
टास्क के लिए अद्वितीय पहचानकर्ता। हालांकि हम कार्यान्वयन विवरण के रूप में टास्क ids के लिए k-sortable UUID का उपयोग करते हैं, आपको id के फ़ॉर्मेट के बारे में कोई भी अनुमान नहीं लगाना चाहिए।
Name
type
Type
string
Description
टास्क का प्रकार। मान creative-lab-lamp-prototype है।
Name
name
Type
string
Description
टास्क बनाते समय दिया गया टास्क नाम। यदि कोई नाम प्रदान नहीं किया गया था, तो खाली स्ट्रिंग।
Name
status
Type
string
Description
टास्क की स्थिति। संभावित मानों में से एक PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED है।
Name
progress
Type
integer
Description
टास्क का progress। यदि टास्क अभी शुरू नहीं हुआ है, तो यह प्रॉपर्टी 0 होगी। टास्क सफल हो जाने के बाद, यह 100 हो जाएगी।
Name
created_at
Type
timestamp
Description
टास्क बनाए जाने का टाइमस्टैंप, मिलीसेकंड में।
टाइमस्टैंप 1 जनवरी, 1970 UTC से बीते मिलीसेकंड की संख्या को दर्शाता है, जो RFC 3339 मानक का पालन करता है। उदाहरण के लिए, शुक्रवार, 1 सितंबर, 2023 12:00:00 PM 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 ऑब्जेक्ट संदर्भ के लिए एरर देखें।
Name
consumed_credits
Type
integer
Description
इस टास्क द्वारा उपभोग किए गए क्रेडिट की संख्या। तब मौजूद होता है जब टास्क की स्थिति PENDING, IN_PROGRESS, या SUCCEEDED हो। FAILED टास्क के लिए 0 लौटाता है (विफलता पर क्रेडिट रिफंड कर दिए जाते हैं)।
Name
image_urls
Type
array of strings
Description
इस प्रोटोटाइप टास्क द्वारा जनरेट किए गए कॉन्सेप्ट इमेज उम्मीदवारों के लिए डाउनलोड करने योग्य URLs। वर्तमान में API हमेशा ठीक एक उम्मीदवार लौटाता है; यह फ़ील्ड एक array है ताकि भविष्य के संशोधन breaking change के बिना कई उम्मीदवार दिखा सकें।

Example Lamp Prototype Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "creative-lab-lamp-prototype",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123456000,
  "started_at": 1729123460000,
  "finished_at": 1729123486000,
  "expires_at": 1729382686000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 6,
  "image_urls": [
    "https://assets.meshy.ai/***/concept.png?Expires=***"
  ]
}

लैंप बिल्ड टास्क ऑब्जेक्ट

लैंप बिल्ड टास्क ऑब्जेक्ट एक वर्क यूनिट है जिसका ट्रैक Meshy रखता है ताकि SUCCEEDED प्रोटोटाइप टास्क से अंतिम 3D-प्रिंट करने योग्य लैंपशेड जनरेट किया जा सके। बिल्ड प्रोटोटाइप की कॉन्सेप्ट इमेज पर इमेज-टू-3D ड्राफ्ट + टेक्सचर पाइपलाइन चलाता है, फिर मेश को लैंप प्रोसेसर के माध्यम से पोस्ट-प्रोसेस करता है ताकि उसे खोखला, समतल, और (वैकल्पिक रूप से) फिक्सचर बेस काटा जा सके।

प्रॉपर्टीज़

Name
id
Type
string
Description
कार्य के लिए अद्वितीय पहचानकर्ता।
Name
type
Type
string
Description
कार्य का प्रकार। मान creative-lab-lamp-build है।
Name
name
Type
string
Description
कार्य बनाते समय दिया गया कार्य नाम। यदि कोई नाम नहीं दिया गया था, तो खाली स्ट्रिंग।
Name
status
Type
string
Description
कार्य की स्थिति। संभावित मान इनमें से एक हैं: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED।
Name
progress
Type
integer
Description
कार्य का progress। यदि कार्य अभी शुरू नहीं हुआ है, तो यह प्रॉपर्टी 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 ऑब्जेक्ट संदर्भ के लिए एरर देखें।
Name
consumed_credits
Type
integer
Description
इस कार्य द्वारा खपत किए गए क्रेडिट की संख्या। FAILED कार्यों के लिए 0 लौटाता है (विफलता पर क्रेडिट वापस कर दिए जाते हैं)।
Name
model_urls
Type
object
Description
जनरेट किए गए आर्टिफैक्ट्स के लिए डाउनलोड करने योग्य URL, जिन्हें आर्टिफैक्ट नाम से की किया गया है। की का सेट output.format और options.light_source_preset पर निर्भर करता है:
- Name
  lamp_stl
  Type
  string
  Description
  लैंपशेड lamp.stl के लिए डाउनलोड करने योग्य URL। तब मौजूद होता है जब output.format stl था (डिफ़ॉल्ट)।
- Name
  base_stl
  Type
  string
  Description
  फिक्स्चर-बेस base.stl के लिए डाउनलोड करने योग्य URL। तब मौजूद होता है जब output.format stl था और options.light_source_preset none नहीं था। जब फिक्स्चर प्रीसेट none था, तब छोड़ा जाता है।
- Name
  bundle_zip
  Type
  string
  Description
  प्रोसेसर द्वारा उत्सर्जित हर आर्टिफैक्ट के zip बंडल के लिए डाउनलोड करने योग्य URL (lamp.stl, वैकल्पिक base.stl, और — जब options.include_result_json true हो — result.json)। तब मौजूद होता है जब output.format zip था। जब bundle_zip मौजूद होता है, तो lamp_stl / base_stl छोड़े जाते हैं।

Example Lamp Build Task Object

{
  "id": "019c320e-9a8f-7a1c-9c11-2a1876f8a9bb",
  "type": "creative-lab-lamp-build",
  "name": "",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1729123500000,
  "started_at": 1729123510000,
  "finished_at": 1729123535000,
  "expires_at": 1729382735000,
  "preceding_tasks": 0,
  "task_error": null,
  "consumed_credits": 30,
  "model_urls": {
    "lamp_stl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/lamp.stl?Expires=***",
    "base_stl": "https://assets.meshy.ai/***/tasks/019c320e-9a8f-7a1c-9c11-2a1876f8a9bb/output/base.stl?Expires=***"
  }
}