इमेज टू 3D मॉडल API का उपयोग कैसे करें: एक संपूर्ण गाइड 2026

इमेज टू 3D मॉडल API एक एकल फोटो को सेकंडों में प्रोडक्शन-रेडी 3D मॉडल में बदल देता है—बिना किसी मैन्युअल मॉडलिंग की आवश्यकता के। हर एसेट को हाथ से मॉडल करना धीमा और महंगा है, और गेम स्टूडियो, AR ऐप्स और ई-कॉमर्स टीमों के लिए यह जल्दी ही बाधा बन जाता है जो लॉन्च में देरी करता है। Meshy का इमेज टू 3D मॉडल API उस बाधा को दूर करता है: एक इमेज भेजें, इसे सेकंडों में 3D मॉडल में बदलें, और GLB, FBX और OBJ जैसे फॉर्मेट में पूरी तरह से टेक्सचर्ड मेश डाउनलोड करें। यह गाइड आपको पूरे वर्कफ़्लो—अपनी API कुंजी बनाने से लेकर अपना पहला मॉडल डाउनलोड करने तक—कॉपी-पेस्ट कोड के साथ ले जाती है जिसे आप मिनटों में चला सकते हैं।

इमेज टू 3D मॉडल API क्या है?

इसके मूल में, इमेज टू 3D मॉडल API एक REST एंडपॉइंट है जो Meshy के इमेज टू 3D मॉडल AI द्वारा संचालित है। आप एक एकल इमेज (JPG, JPEG, या PNG) को सार्वजनिक URL या base64 स्ट्रिंग के रूप में भेजते हैं, और API एक टेक्सचर्ड 3D मॉडल—ज्योमेट्री और बेस कलर टेक्सचर सहित—मानक फॉर्मेट जैसे GLB, FBX, OBJ, USDZ, STL और 3MF में लौटाता है। वैकल्पिक ऐड-ऑन में PBR मैप, अप-टू-4K टेक्सचर और मल्टी-एंगल प्रीव्यू थंबनेल शामिल हैं।

हमारे नवीनतम Meshy 6 मॉडल द्वारा संचालित, API आपको टोपोलॉजी और पॉलीगॉन काउंट कॉन्फ़िगर करने, पोज़ मोड सेट करने और टेक्स्ट प्रॉम्प्ट या रेफरेंस इमेज के साथ टेक्सचरिंग का मार्गदर्शन करने देता है—जो गेम, AR/VR, 3D प्रिंटिंग और उत्पाद विज़ुअलाइज़ेशन के लिए एसेट जनरेट करने के लिए आदर्श है।

इमेज टू 3D API का उपयोग करने के लिए आपको क्या चाहिए?

इस गाइड का पालन करने के लिए आपको ज़्यादा कुछ नहीं चाहिए। सुनिश्चित करें कि आपके पास है:

• एक Meshy खाता — यदि नहीं है तो मुफ्त में साइन अप करें। आप चरण 1 में डैशबोर्ड से अपनी API कुंजी जनरेट करेंगे।

• एक API कुंजी — हर अनुरोध को प्रमाणित करने के लिए उपयोग की जाती है। हम एक बनाने की प्रक्रिया से गुज़रेंगे, और आप क्रेडिट खर्च किए बिना साथ चलने के लिए मुफ्त टेस्ट मोड कुंजी का उपयोग कर सकते हैं।

• एक इनपुट इमेज — एक स्पष्ट .jpg, .jpeg, या .png जो सार्वजनिक रूप से सुलभ URL पर होस्ट हो (या base64 के रूप में एन्कोडेड हो)। एक साफ पृष्ठभूमि और स्पष्ट रूप से दिखाई देने वाला विषय सबसे अच्छे परिणाम देता है।

• HTTP अनुरोध करने का एक तरीका — curl (नीचे दिए गए उदाहरणों में उपयोग किया गया), Postman, या आपकी पसंद की भाषा में कोई HTTP लाइब्रेरी। REST APIs और JSON की बुनियादी जानकारी सहायक है लेकिन आवश्यक नहीं है।

बस इतना ही—कोई 3D मॉडलिंग अनुभव की आवश्यकता नहीं है। चलिए शुरू करते हैं।

API के साथ इमेज को 3D मॉडल में कैसे बदलें (चरण-दर-चरण गाइड)

चरण 1: अपनी API सेटिंग्स सेट अप करें

बिल्डिंग शुरू करने के लिए आपको जो कुछ भी चाहिए वह API सेटिंग्स पेज पर है। यह Meshy API के लिए आपका कंट्रोल सेंटर है, और इसमें तीन मुख्य खंड हैं:

• API कुंजियाँ — उन कुंजियों को जनरेट और प्रबंधित करें जो आपके अनुरोधों को प्रमाणित करती हैं।

• वेबहुक — जब आपके कार्य पूरे हों तो स्वचालित रूप से सूचित हों।

• उपयोग — वास्तविक समय में अपनी शेष क्रेडिट शेष राशि और API खपत को ट्रैक करें।

आइए प्रत्येक के बारे में जानें।

अपनी API कुंजी प्राप्त करें

कोई भी अनुरोध करने से पहले, आपको सुरक्षित रूप से प्रमाणित करने के लिए एक API कुंजी की आवश्यकता है। API सेटिंग्स पेज पर, API कुंजी जनरेट करें पर क्लिक करें। हर कुंजी msy-<random-string> प्रारूप का अनुसरण करती है।

टिप: जनरेट होने के बाद, अपनी API कुंजी को कहीं सुरक्षित रखें (जैसे, पासवर्ड मैनेजर या एनवायरनमेंट वेरिएबल)। इसे पासवर्ड की तरह समझें—इसे कभी भी सोर्स कंट्रोल में कमिट न करें या क्लाइंट-साइड कोड में एक्सपोज़ न करें।

टेस्ट मोड API कुंजी

डेवलपमेंट और टेस्टिंग के दौरान, आप अपने क्रेडिट खर्च किए बिना API का पता लगाने के लिए टेस्ट मोड API कुंजी का उपयोग कर सकते हैं:

msy_dummy_api_key_for_test_mode_12345678

इस विशेष कुंजी में निम्नलिखित विशेषताएं हैं:

• इसका उपयोग सभी Meshy API एंडपॉइंट पर अनुरोध करने के लिए किया जा सकता है।

• इस कुंजी का उपयोग करने पर कोई क्रेडिट खर्च नहीं होता है।

• सभी मान्य अनुरोध, इनपुट पैरामीटर की परवाह किए बिना, एक ही नमूना कार्य परिणाम लौटाते हैं।

• प्रतिक्रिया डेटा संरचना प्रोडक्शन API से बिल्कुल मेल खाती है।

यह आपकी वास्तविक API कुंजी पर स्विच करने से पहले आपके एकीकरण का परीक्षण करने के लिए इसे एकदम सही बनाता है।

वेबहुक सेट अप करें (वैकल्पिक)

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

सेटिंग्स पेज के वेबहुक अनुभाग में, एक एंडपॉइंट URL जोड़ें जहाँ Meshy को इवेंट सूचनाएं भेजनी चाहिए। जब कोई कार्य स्थिति बदलता है (उदाहरण के लिए, जब वह पूरा होता है या विफल होता है), Meshy आपके URL पर पेलोड में कार्य विवरण के साथ एक HTTP POST अनुरोध भेजता है।

टिप: प्रोडक्शन के लिए वेबहुक अनुशंसित तरीका है। वे अनावश्यक API कॉल को कम करते हैं और आपके एप्लिकेशन को वास्तविक समय में परिणामों पर प्रतिक्रिया करने देते हैं। त्वरित परीक्षणों के लिए, पोलिंग अभी भी ठीक काम करती है। वेबहुक कोड का स्थानीय रूप से परीक्षण करने के लिए, इसे smee.io जैसी सेवा के प्रॉक्सी URL पर इंगित करें।

बिना कोड के प्रयास करें — API प्लेग्राउंड (वैकल्पिक)

क्या आपके पास पहले से API कुंजी है? कोई कोड लिखने से पहले, आप सीधे अपने ब्राउज़र में एक वास्तविक इमेज टू 3D कार्य चला सकते हैं।

meshy.ai/api-playground खोलें, बाएं पैनल से इमेज टू 3D चुनें, और तीन चीजें भरें:

1. प्राधिकरण — अपनी API कुंजी पेस्ट करें (msy-xxxxxxxxxx)

2. इमेज — अपने कंप्यूटर से एक .jpg, .jpeg, या .png अपलोड करें

3. भेजें दबाएं

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

प्रो टिप: दाईं ओर का रॉ अनुरोध/प्रतिक्रिया पैनल दिखाता है कि API वास्तव में क्या भेजता और लौटाता है। आप सामग्री को सीधे कॉपी कर सकते हैं — प्रतिक्रिया से task_id पकड़ें, और कार्य पूरा होने पर model_urls। आप अगले चरणों में दोनों का उपयोग करेंगे।

चरण 2: एक इमेज टू 3D कार्य सबमिट करें

अपनी API कुंजी तैयार होने पर, एक POST अनुरोध के साथ कार्य शुरू करें:

curl -X POST https://api.meshy.ai/openapi/v1/image-to-3d \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/your-image.png"
  }'

आपको इस तरह प्रतिक्रिया मिलेगी:

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

वह result मान आपका task_id है — इसे सहेजें। अगले चरण में प्रगति की जांच करने और अपना मॉडल प्राप्त करने के लिए आपको इसकी आवश्यकता होगी।

वैकल्पिक: कार्य पूरा होने पर स्वचालित रूप से सूचित होने के लिए, JSON बॉडी में एक webhook_url फ़ील्ड जोड़ें — उदाहरण के लिए "webhook_url": "https://yourapp.com/webhooks/meshy"। यह कैसे काम करता है यह जानने के लिए चरण 3, विकल्प B देखें।

चरण 3: अपने परिणाम प्राप्त करें

आपका कार्य तुरंत पूरा नहीं होता है—Meshy इसे पृष्ठभूमि में प्रोसेस करता है। परिणाम प्राप्त करने के दो तरीके हैं:

विकल्प A: स्थिति के लिए पोल करें (सबसे सरल)

हर 5 सेकंड में एक GET अनुरोध भेजें जब तक कि status SUCCEEDED में न बदल जाए:

curl https://api.meshy.ai/openapi/v1/image-to-3d/{task_id} \
  -H "Authorization: Bearer $MESHY_API_KEY"

प्रतिक्रिया इस तरह दिखती है:

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "status": "SUCCEEDED",
  "progress": 100,
  "model_url": "https://assets.meshy.ai/.../model.glb",
  "model_urls": {
    "glb": "https://assets.meshy.ai/.../model.glb",
    "fbx": "https://assets.meshy.ai/.../model.fbx",
    "obj": "https://assets.meshy.ai/.../model.obj",
    "usdz": "https://assets.meshy.ai/.../model.usdz",
    "stl": "https://assets.meshy.ai/.../model.stl",
    "mtl": "https://assets.meshy.ai/.../model.mtl"
  },
  "thumbnail_url": "https://assets.meshy.ai/.../thumbnail.png",
  "consumed_credits": 30
}

कुछ फ़ील्ड जानने योग्य हैं:

• model_urls में प्रत्येक जनरेट किए गए फॉर्मेट के लिए एक डाउनलोड लिंक है। डिफ़ॉल्ट रूप से इसमें glb, fbx, obj, usdz, stl और mtl (मटेरियल फ़ाइल जो obj के साथ जोड़ी जाती है) शामिल हैं।

• model_url GLB लिंक का शॉर्टकट है—जब आपको केवल GLB की आवश्यकता हो तो सुविधाजनक।

• consumed_credits दिखाता है कि कार्य ने कितने क्रेडिट का उपयोग किया (यह विफल कार्यों के लिए 0 है, क्योंकि क्रेडिट वापस कर दिए जाते हैं)।

• thumbnail_url हमेशा मौजूद रहता है और सामने के दृश्य के थंबनेल को इंगित करता है।

• thumbnail_urls केवल तब दिखाई देता है जब multi_view_thumbnails: true हो, और इसमें सामने, दाएं, पीछे और बाएं दृश्य शामिल होते हैं।

• alpha_thumbnail_url केवल तब दिखाई देता है जब alpha_thumbnail: true हो, और इसमें पारदर्शी पृष्ठभूमि वाला थंबनेल होता है।

संभावित status मान: PENDING → IN_PROGRESS → SUCCEEDED / FAILED / CANCELED

विकल्प B: वेबहुक (प्रोडक्शन के लिए अनुशंसित)

यदि आपने चरण 2 में webhook_url सेट किया है, तो Meshy स्वचालित रूप से पूर्ण कार्य ऑब्जेक्ट को आपके URL पर POST करेगा—पोलिंग की कोई आवश्यकता नहीं।

{
  "image_url": "https://example.com/your-image.png",
  "webhook_url": "https://yourapp.com/webhooks/meshy"
}

💡 मुझे किसका उपयोग करना चाहिए? प्रोटोटाइप और एकमुश्त कार्यों के लिए पोलिंग ठीक है। प्रोडक्शन में वेबहुक का उपयोग करें — यह अधिक विश्वसनीय है और API कॉल बचाता है।

चरण 4: अपना 3D मॉडल डाउनलोड करें

एक बार status SUCCEEDED हो जाने पर, model_urls से डाउनलोड URL लें और अपने इच्छित फॉर्मेट को डाउनलोड करें:

curl -o model.glb "https://assets.meshy.ai/.../model.glb"

-o model.glb फ़्लैग फ़ाइल को उस नाम से आपकी वर्तमान कार्यशील निर्देशिका में सहेजता है—इसे कहीं और सहेजने के लिए पूर्ण पथ का उपयोग करें (जैसे -o /path/to/model.glb)।

डिफ़ॉल्ट रूप से, प्रत्येक कार्य GLB, FBX, OBJ, USDZ, STL और MTL (OBJ के लिए मटेरियल फ़ाइल) लौटाता है। 3MF ऑप्ट-इन है—आप इसे केवल तभी प्राप्त करते हैं जब आप स्पष्ट रूप से target_formats के माध्यम से इसका अनुरोध करते हैं (नीचे पैरामीटर तालिका देखें)।

⚠️ लिंक 3 दिनों में समाप्त हो जाते हैं (एंटरप्राइज़ योजनाओं को स्थायी लिंक मिलते हैं)। अपने मॉडल तुरंत डाउनलोड और स्टोर करें — समाप्ति के बाद लिंक काम नहीं करेंगे, और आपको कार्य को फिर से चलाना होगा।

इस मॉडल को अपने DCC टूल में उपयोग करने के लिए तैयार हैं? Bridge to Blender गाइड देखें—Meshy के पास Unity, Unreal, Maya और अन्य के लिए भी ब्रिज हैं।

सर्वोत्तम इमेज-टू-3D परिणाम कैसे प्राप्त करें?

• एक एकल, स्पष्ट रूप से दिखाई देने वाले विषय का उपयोग करें। एक मुख्य वस्तु, केंद्रित और पूरी तरह से फ्रेम में, AI को सबसे साफ संदर्भ देती है—व्यस्त दृश्यों, भारी क्रॉपिंग और अत्यधिक कोणों से बचें।

• एक साफ, अव्यवस्थित पृष्ठभूमि पसंद करें। ठोस या सरल पृष्ठभूमि मॉडल को विषय को उसके परिवेश से अलग करने में मदद करती है।

• समान, विसरित प्रकाश का उपयोग करें। कठोर छायाएं और तेज़ हाइलाइट जनरेटेड टेक्सचर में भ्रामक विवरण पका सकते हैं।

• एक उच्च-रिज़ॉल्यूशन, तेज इमेज से शुरू करें। अंदर अधिक विवरण का मतलब बाहर अधिक विवरण है—धुंधले या कम-रिज़ॉल्यूशन वाले इनपुट नरम मॉडल उत्पन्न करते हैं।

मैं इमेज टू 3D API के साथ किन प्रोग्रामिंग भाषाओं का उपयोग कर सकता हूं?

कोई भी भाषा जो HTTP अनुरोध कर सकती है—आप JSON के साथ POST भेजते हैं और GET के साथ पोल करते हैं। सामान्य विकल्प:

• Python — requests या httpx लाइब्रेरी का उपयोग करें

• JavaScript / TypeScript — fetch (बिल्ट-इन) या axios का उपयोग करें

• Go — स्टैंडर्ड लाइब्रेरी से net/http का उपयोग करें

• cURL — टर्मिनल से त्वरित परीक्षण के लिए बढ़िया

आप API प्लेग्राउंड में सभी चारों के लिए कॉपी करने के लिए तैयार कोड नमूने भी पा सकते हैं।

एक इमेज टू 3D कार्य की लागत कितने क्रेडिट है?

लागत मॉडल संस्करण और इस बात पर निर्भर करती है कि आप टेक्सचर जनरेट करते हैं या नहीं। डिफ़ॉल्ट सेटअप (meshy-6 टेक्सचरिंग के साथ) प्रति कार्य 30 क्रेडिट खर्च करता है:

विफल कार्य स्वचालित रूप से वापस कर दिए जाते हैं—consumed_credits 0 लौटाता है। नवीनतम दरों के लिए हमेशा मूल्य निर्धारण देखें।

इमेज टू 3D API कौन से पैरामीटर स्वीकार करता है?

इन पैरामीटर के साथ /openapi/v1/image-to-3d पर POST भेजें: आवश्यक (एक):

वैकल्पिक:

इमेज टू 3D API के साथ अगले कदम

अब आपके पास पूर्ण वर्कफ़्लो है: API कुंजी बनाएं, एक इमेज सबमिट करें, परिणाम

अक्सर पूछे जाने वाले प्रश्न

मैं API के माध्यम से किसी इमेज को 3D मॉडल में कैसे बदलूं?

अपने image_url और API कुंजी के साथ /openapi/v1/image-to-3d पर POST अनुरोध भेजें, फिर कार्य को तब तक पोल करें (या वेबहुक का उपयोग करें) जब तक इसकी status SUCCEEDED न हो जाए। प्रतिक्रिया जनरेट किए गए मॉडल के डाउनलोड लिंक लौटाती है। पूर्ण चार-चरणीय प्रवाह—कुंजी, सबमिट, पुनर्प्राप्ति, डाउनलोड—ऊपर दिए गए चरण-दर-चरण मार्गदर्शिका में शामिल है।

API कौन से आउटपुट फॉर्मेट (STL, GLB, OBJ) का समर्थन करता है?

प्रत्येक कार्य डिफ़ॉल्ट रूप से GLB, FBX, OBJ, USDZ, STL और MTL लौटाता है, जिसमें target_formats के माध्यम से अनुरोध पर 3MF उपलब्ध है। GLB वेब और AR के लिए सबसे अच्छा है, FBX और OBJ DCC टूल और गेम इंजन के लिए, USDZ iOS AR के लिए, और STL 3D प्रिंटिंग के लिए।

मैं कौन से इमेज फॉर्मेट अपलोड कर सकता हूं?

इमेज टू 3D API 100 MB तक की JPG, JPEG और PNG इमेज का समर्थन करता है—जो Meshy Workspace UI की 20 MB सीमा से बड़ा है। सबसे सटीक परिणामों के लिए, पारदर्शी या साफ सफेद पृष्ठभूमि वाली PNG का उपयोग करें, जो API को विषय को अलग करने और उच्च गुणवत्ता वाला 3D मॉडल जनरेट करने में मदद करता है।

क्या मैं API से टेक्सचर्ड 3D मॉडल प्राप्त कर सकता हूं?

हां। टेक्सचरिंग डिफ़ॉल्ट रूप से सक्षम है ("should_texture": true)। PBR मैप (मेटैलिक, रफनेस, नॉर्मल) जोड़ने के लिए, "enable_pbr": true सेट करें—meshy-6/latest पर इसमें एक एमिशन मैप भी शामिल है। 4K बेस कलर टेक्सचर के लिए, "hd_texture": true सेट करें (केवल meshy-6/latest पर समर्थित; PBR मैप 2K पर रहते हैं)। आप texture_prompt या texture_image_url के साथ टेक्सचर शैली को भी निर्देशित कर सकते हैं।

क्या मैं 3D प्रिंटिंग (STL) के लिए तैयार 3D मॉडल जनरेट कर सकता हूं?

हां—STL डिफ़ॉल्ट रूप से जनरेट होता है, इसलिए इमेज से 3D STL रूपांतरण के लिए किसी अतिरिक्त पैरामीटर की आवश्यकता नहीं है: कार्य पूरा होने पर बस model_urls.stl लें। यह इमेज से 3D प्रिंट वर्कफ़्लो को सरल बनाता है, क्योंकि STL वह मानक फॉर्मेट है जिसकी स्लाइसर अपेक्षा करते हैं। यदि आपको केवल STL चाहिए, तो अन्य फॉर्मेट को छोड़ने और जनरेशन समय कम करने के लिए "target_formats": ["stl"] सेट करें।

किन योजनाओं में API एक्सेस शामिल है?

API एक्सेस Pro, Studio और Enterprise योजनाओं पर उपलब्ध है—यह Pro और उससे ऊपर की सुविधा है। मुफ्त स्टार्टर योजना में API एक्सेस शामिल नहीं है। विवरण के लिए मूल्य निर्धारण देखें।

डाउनलोड लिंक कितने समय तक मान्य रहते हैं?

Pro और Studio योजनाओं पर डाउनलोड लिंक 3 दिनों के लिए मान्य होते हैं। Enterprise ग्राहकों को स्थायी लिंक मिलते हैं। अपनी फ़ाइलें तुरंत सहेजें—समाप्त लिंक पुनर्प्राप्त नहीं किए जा सकते, और आपको कार्य फिर से चलाना होगा।

क्या मैं एक साथ कई कार्य चला सकता हूं?

हां, समवर्ती अनुरोध समर्थित हैं। यदि आपको 429 Too Many Requests त्रुटि मिलती है, तो आपके खाते ने अपनी दर सीमा तक पहुंच गई है—एक्सपोनेंशियल बैकऑफ़ लागू करें और पुनः प्रयास करें। अपनी योजना की सीमाओं के लिए दर सीमाएं पृष्ठ देखें।

कार्य FAILED दिखाता है — मैं क्या करूं?

कारण के लिए task_error.message जांचें। सामान्य कारण:

यदि समस्या बनी रहती है, तो Meshy सहायता से संपर्क करें।