Enterprise API

Enterprise API एक फीचर है जो आपको Meshy की Enterprise क्षमताओं को अपने स्वयं के एप्लिकेशन में इंटीग्रेट करने की सुविधा देता है। ये API फीचर केवल हमारे enterprise tier plan पर मौजूद उपयोगकर्ताओं के लिए उपलब्ध हैं। इस सेक्शन में, आपको इस API के साथ शुरुआत करने के लिए आवश्यक सारी जानकारी मिलेगी।

GET/openapi/v1/showcases

List Showcases

यह एंडपॉइंट आपको डाउनलोड के लिए उपलब्ध समुदाय शोकेस मॉडल खोजने और वापस पाने की सुविधा देता है। आप एक ही रिक्वेस्ट में अधिकतम 10 मॉडल तक वापस पा सकते हैं, और हर रिक्वेस्ट का खर्च 1 credit होगा।

Parameters

Optional attributes

Name
page_size
Type
integer
Description
वापस लौटाए जाने वाले शोकेस मॉडलों की संख्या। यह 1 से 10 (दोनों सम्मिलित) के बीच एक धनात्मक संख्या होनी चाहिए। ध्यान दें कि यह संभव है कि यदि पर्याप्त मैचिंग मॉडल नहीं मिलते हैं तो रिक्वेस्ट अनुरोधित संख्या से कम मॉडल लौटाए। यदि कोई मैच नहीं मिलता है तो कोई मॉडल वापस नहीं किया जाएगा। यदि page_size प्रदान नहीं किया गया है तो डिफ़ॉल्ट रूप से 3 मॉडल होंगे।
Name
sort_by
Type
string
Description
प्राप्त खोज परिणामों को सॉर्ट करने की पद्धति। यदि प्रदान नहीं किया गया है, तो परिणामों को निर्माण समय के अनुसार सबसे हाल के से सबसे पहले तक सॉर्ट किया जाएगा (-created_at)।
- +created_at: निर्माण समय के आरोही क्रम में सॉर्ट करें।
- -created_at: निर्माण समय के अवरोही क्रम में सॉर्ट करें।
- +updated_at: अपडेट समय के आरोही क्रम में सॉर्ट करें।
- -updated_at: अपडेट समय के अवरोही क्रम में सॉर्ट करें।
- +downloads: डाउनलोड की संख्या के आरोही क्रम में सॉर्ट करें।
- -downloads: डाउनलोड की संख्या के अवरोही क्रम में सॉर्ट करें।
Name
search
Type
string
Description
समुदाय द्वारा प्रकाशित (CC0) मॉडल नामों के भीतर खोजने के लिए टेक्स्ट। यदि प्रदान नहीं किया गया है, तो शीर्ष समग्र समुदाय मॉडल (sort_by के आधार पर) वापस किए जाएंगे।
Name
format
Type
string
Description
वापस किए गए परिणामों के लिए इच्छित 3d मॉडल फ़ॉर्मेट। प्राप्त किए गए सभी मॉडल निर्दिष्ट फ़ॉर्मेट में होंगे। यह नीचे दिए गए वैकल्पिक मूल्यों में से एक होना चाहिए। यदि प्रदान नहीं किया गया है, तो डिफ़ॉल्ट रूप से glb होगा।
- glb: glb फ़ॉर्मेट।
- fbx: fbx फ़ॉर्मेट।
- obj: obj फ़ॉर्मेट।
- usdz: usdz फ़ॉर्मेट।
Name
showcase_type
Type
string
Description
वापस किए गए परिणामों के लिए इच्छित मॉडल प्रकार। प्राप्त किए गए सभी मॉडल निर्दिष्ट प्रकार में होंगे। यह नीचे दिए गए वैकल्पिक मूल्यों में से एक होना चाहिए। यदि प्रदान नहीं किया गया है, तो डिफ़ॉल्ट रूप से all होगा।
- all: सभी शोकेस मॉडल।
- animated: एनिमेटेड शोकेस मॉडल।
- static: स्टैटिक शोकेस मॉडल।

Returns

Name
id
Type
string
Description
शोकेस मॉडल के लिए यूनिक आइडेंटिफायर। हालांकि हम टास्क id के लिए इम्प्लीमेंटेशन विवरण के रूप में k-sortable UUID का उपयोग करते हैं, आपको id के लिए किसी भी फ़ॉर्मेट को नहीं मानना चाहिए।
Name
result_id
Type
string
Description
वापस किए गए मॉडल परिणाम के लिए यूनिक आइडेंटिफायर। यह ID मॉडल से जुड़ा है और इसे रीमेश जैसे अन्य API टास्क में सीधे इस्तेमाल किया जा सकता है।
Name
model_url
Type
object
Description
टेक्सचर के साथ डाउनलोड करने योग्य 3D मॉडल का URL। डिफ़ॉल्ट रूप से glb फ़ॉर्मेट वापस करता है।
Name
conversion_status
Type
string
Description
वापस किए गए मॉडलों की फ़ाइल टाइप कन्वर्शन स्थिति।
- <empty string>: कन्वर्ट नहीं किया गया (डिफ़ॉल्ट glb)।
- success: कन्वर्शन सफल।
- failed: कन्वर्शन असफल।
Name
community_url
Type
string
Description
शोकेस मॉडल का समुदाय ब्राउज़िंग लिंक।
Name
author
Type
string
Description
शोकेस मॉडल के लेखक।
Name
topology
Type
string
Description
शोकेस मॉडल की topology (quad या triangle)।
Name
name
Type
string
Description
शोकेस मॉडल का नाम।
Name
object_prompt
Type
string
Description
शोकेस मॉडल का विवरण।
Name
categories
Type
array
Description
शोकेस मॉडल की श्रेणियाँ।
Name
tags
Type
array
Description
शोकेस मॉडल के टैग।
Name
mode
Type
string
Description
शोकेस मॉडल का mode।
Name
created_at
Type
timestamp
Description
शोकेस मॉडल के निर्माण का टाइमस्टैंप (मिलीसेकंड में)।
Name
updated_at
Type
timestamp
Description
शोकेस मॉडल के अपडेट का टाइमस्टैंप (मिलीसेकंड में)।

Request

GET

/openapi/v1/showcases

curl "https://api.meshy.ai/openapi/v1/showcases?page_size=10&sort_by=-created_at&search=car&format=glb" \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "result": [
    {
      "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
      "result_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
      "model_url": "https://api.meshy.ai/v1/models/018a210d-8ba4-705c-b111-1f1776f7f578/model.glb",
      "conversion_status": "success",
      "community_url": "https://www.meshy.ai/showcase/018a210d-8ba4-705c-b111-1f1776f7f578",
      "author": "John Doe",
      "topology": "quad",
      "name": "Car",
      "object_prompt": "A car",
      "categories": ["vehicle"],
      "tags": ["car", "vehicle"],
      "mode": "3d",
      "created_at": 1717171717171,
      "updated_at": 1717171717171
    }
  ]
}