रीसाइज़ API

रीसाइज़ API आपको मौजूदा 3D मॉडलों को वास्तविक दुनिया के आयामों में रीसाइज़ करने की अनुमति देता है। आप एक सटीक ऊँचाई, एक सबसे लंबे पक्ष की बाधा निर्दिष्ट कर सकते हैं, या AI को स्वचालित रूप से उपयुक्त आकार का अनुमान लगाने दे सकते हैं।

POST/openapi/v1/resize

रीसाइज़ टास्क बनाएं

यह एंडपॉइंट एक नया रीसाइज़ टास्क बनाता है।

पैरामीटर

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

Name
input_task_id
Type
string
आवश्यक
Description
एक पूर्ण Meshy टास्क का ID जिसका मॉडल आप रीसाइज़ करना चाहते हैं। टास्क की स्थिति SUCCEEDED होनी चाहिए। आउटपुट फॉर्मेट GLB होगा।

Name
model_url
Type
string
आवश्यक
Description
एक सार्वजनिक रूप से सुलभ URL या डेटा URI जो एक 3D मॉडल फाइल की ओर इशारा करता है। समर्थित फॉर्मेट: .glb, .gltf, .obj, .fbx, .stl। डेटा URI के लिए, MIME type का उपयोग करें: application/octet-stream। आउटपुट फॉर्मेट इनपुट मॉडल के मूल फॉर्मेट को बनाए रखेगा।

एक रीसाइज़ मोड आवश्यक है: resize_height, resize_longest_side, या auto_size। ये तीन पैरामीटर परस्पर अनन्य हैं।

Name
resize_height
Type
number
Description
मॉडल को एक विशिष्ट ऊँचाई तक रीसाइज़ करें जो मीटर में मापी जाती है।

Name
resize_longest_side
Type
number
Description
मॉडल को इस प्रकार रीसाइज़ करें कि इसका सबसे लंबा पक्ष इस मान से मेल खाता हो, जो मीटर में मापा जाता है। अनुपात संरक्षित रहता है।

Name
auto_size
Type
boolean
Description
जब true पर सेट किया जाता है, तो सेवा AI विज़न का उपयोग करके वस्तु की वास्तविक दुनिया की ऊँचाई का स्वचालित रूप से अनुमान लगाती है और मॉडल को तदनुसार रीसाइज़ करती है। जब तक origin_at को स्पष्ट रूप से सेट नहीं किया जाता, ओरिजिन डिफ़ॉल्ट रूप से bottom पर होगा।

Name
origin_at
Type
string
डिफ़ॉल्ट bottom
Description
रीसाइज़िंग के बाद ओरिजिन की स्थिति।
उपलब्ध मान: bottom, center.

रिटर्न्स

प्रतिक्रिया की result प्रॉपर्टी में नए बनाए गए रीसाइज़ टास्क का id होता है।

विफलता मोड

400 - Bad Request

अनुरोध अस्वीकार्य था। सामान्य कारण:

लापता पैरामीटर: या तो model_url या input_task_id प्रदान किया जाना चाहिए।
लापता रीसाइज़ मोड: resize_height, resize_longest_side, या auto_size में से कम से कम एक निर्दिष्ट किया जाना चाहिए।
परस्पर अनन्य पैरामीटर: resize_height, resize_longest_side, और auto_size को संयोजित नहीं किया जा सकता।
अमान्य इनपुट टास्क: input_task_id को एक सफल टास्क का संदर्भ देना चाहिए।
अमान्य मॉडल फॉर्मेट: model_url एक असमर्थित एक्सटेंशन वाली फाइल की ओर इशारा करता है।
अप्राप्य URL: model_url डाउनलोड नहीं किया जा सका।

401 - Unauthorized

प्रमाणीकरण विफल रहा। कृपया अपनी API की जांचें।

402 - Payment Required

इस टास्क को करने के लिए अपर्याप्त क्रेडिट।

429 - Too Many Requests

आपने अपनी रेट लिमिट पार कर ली है।

Request

POST

/openapi/v1/resize

# Simple: resize to a specific height
curl https://api.meshy.ai/openapi/v1/resize \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "resize_height": 1.8
  }'

# Advanced: resize longest side with custom origin
curl https://api.meshy.ai/openapi/v1/resize \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.glb",
    "resize_longest_side": 2.0,
    "origin_at": "center"
  }'

Response

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

GET/openapi/v1/resize/:id

रीसाइज़ कार्य प्राप्त करें

यह एंडपॉइंट उसके आईडी द्वारा एक रीसाइज़ कार्य प्राप्त करता है।

पैरामीटर्स

Name
id
Type
path
Description
प्राप्त करने के लिए रीसाइज़ कार्य का आईडी।

रिटर्न्स

रीसाइज़ कार्य ऑब्जेक्ट।

Request

GET

/openapi/v1/resize/:id

curl https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "resize",
  "model_urls": {
      "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null,
  "consumed_credits": 1
}

DELETE/openapi/v1/resize/:id

रीसाइज़ कार्य हटाएं

यह एंडपॉइंट स्थायी रूप से एक रीसाइज़ कार्य को हटाता है, जिसमें सभी संबंधित मॉडल और डेटा शामिल होते हैं। यह क्रिया अपरिवर्तनीय है।

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

Name
id
Type
path
Description
हटाने के लिए रीसाइज़ कार्य का ID।

रिटर्न्स

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

Request

DELETE

/openapi/v1/resize/:id

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 200 Ok on success.

GET/openapi/v1/resize

रीसाइज़ कार्यों की सूची

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

पैरामीटर्स

Name
page_num
Type
integer
डिफ़ॉल्ट 1
Description
पेजिनेशन के लिए पृष्ठ संख्या।

Name
page_size
Type
integer
डिफ़ॉल्ट 10
Description
पृष्ठ आकार सीमा। अधिकतम अनुमत 50 आइटम्स हैं।

Name
sort_by
Type
string
Description
किस फील्ड के आधार पर क्रमबद्ध करना है। उपलब्ध मान:
- +created_at: निर्माण समय के अनुसार आरोही क्रम में क्रमबद्ध करें।
- -created_at: निर्माण समय के अनुसार अवरोही क्रम में क्रमबद्ध करें।

रिटर्न्स

रीसाइज़ कार्य ऑब्जेक्ट्स की एक पेजिनेटेड सूची लौटाता है।

Request

GET

/openapi/v1/resize

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "resize",
    "model_urls": {
      "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
    },
    "progress": 100,
    "status": "SUCCEEDED",
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "task_error": null,
    "consumed_credits": 1
  }
]

GET/openapi/v1/resize/:id/stream

रीसाइज़ कार्य को स्ट्रीम करें

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

पैरामीटर्स

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

रिटर्न्स

सर्वर-सेंट इवेंट्स के रूप में रीसाइज़ कार्य ऑब्जेक्ट्स की एक स्ट्रीम लौटाता है।

PENDING या IN_PROGRESS कार्यों के लिए, प्रतिक्रिया स्ट्रीम केवल आवश्यक progress और status फ़ील्ड्स को शामिल करेगी।

अनुरोध

GET

/openapi/v1/resize/:id/stream

curl -N https://api.meshy.ai/openapi/v1/resize/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

प्रतिक्रिया स्ट्रीम

// Message event examples illustrate task progress.
event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "resize",
  "model_urls": {
    "glb": "https://assets.meshy.ai/.../model.glb?Expires=..."
  },
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "task_error": null,
  "consumed_credits": 1
}

रीसाइज़ टास्क ऑब्जेक्ट

रीसाइज़ टास्क ऑब्जेक्ट एक रीसाइज़ जॉब का प्रतिनिधित्व करता है।

गुण

id · string

टास्क के लिए अद्वितीय पहचानकर्ता।

type · string

टास्क का प्रकार। मान resize है।

model_urls · object

रीसाइज़ किए गए मॉडल फ़ाइल के लिए डाउनलोड करने योग्य URL। जब input_task_id का उपयोग किया जाता है, तो आउटपुट हमेशा GLB होता है। जब model_url का उपयोग किया जाता है, तो आउटपुट मूल प्रारूप को बनाए रखता है।

progress · integer

टास्क की प्रगति (0-100)।

status · string

टास्क की स्थिति। संभावित मान: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED।

preceding_tasks · integer

पूर्ववर्ती टास्क की गिनती। केवल तभी अर्थपूर्ण जब स्थिति PENDING हो।

created_at · timestamp

जब टास्क बनाया गया था, उसका टाइमस्टैंप, मिलीसेकंड में।

started_at · timestamp

जब टास्क शुरू किया गया था, उसका टाइमस्टैंप, मिलीसेकंड में। यदि शुरू नहीं किया गया तो 0।

finished_at · timestamp

जब टास्क समाप्त हुआ था, उसका टाइमस्टैंप, मिलीसेकंड में। यदि समाप्त नहीं हुआ तो 0।

task_error · object

एरर ऑब्जेक्ट यदि टास्क विफल हो गया। अधिक विवरण के लिए एरर देखें।

consumed_credits · integer

इस टास्क द्वारा उपभोग किए गए क्रेडिट की संख्या (प्रति रीसाइज़ टास्क 1 क्रेडिट)। FAILED टास्क के लिए 0 लौटाता है।