क्विकस्टार्ट
अपनी API की बनाकर शुरुआत करें
इस गाइड में हर रिक्वेस्ट के लिए इसकी आवश्यकता होती है। की बनाने में कुछ ही सेकंड लगते हैं।
अपनी API की बनाएंMeshy REST API का उपयोग करके अपने पहले 3D मॉडल तक पहुँचने के चार चरण।
AI कोडिंग असिस्टेंट का उपयोग कर रहे हैं? हमारा AI इंटीग्रेशन पेज देखें — Claude Code, Cursor, Windsurf और अन्य MCP-संगत टूल्स से टूल-कॉलिंग एक्सेस के लिए Meshy MCP server इंस्टॉल करें, या किसी साधारण चैट एजेंट को llms.txt पर पॉइंट करें।
1अपनी API की प्राप्त करें
Developer Platform के API Keys पेज से एक API की बनाएं — इस स्क्रीन के बाद आप इसे दोबारा नहीं देख पाएंगे, इसलिए इसे कहीं सुरक्षित रखें। हर रिक्वेस्ट Authorization हेडर में Bearer टोकन के साथ प्रमाणीकरण करती है — देखें Authentication।
API की बनाने और प्रबंधित करने के लिए पेड प्लान आवश्यक है। फ्री अकाउंट को Playground में टेस्टिंग के लिए एक समर्पित, बिल्ट-इन की मिलती है, लेकिन वे अपनी खुद की की नहीं बना या प्रबंधित नहीं कर सकते।

सुरक्षा सुझाव: अपनी की को सीधे स्क्रिप्ट में पेस्ट करने से बचें — इसके बजाय इसे एनवायरनमेंट वेरिएबल के रूप में स्टोर करें: export MESHY_API_KEY="msy_..."।
2अपना पहला इमेज-टू-3D रिक्वेस्ट बनाएं
अपनी की एक्सपोर्ट करें, फिर इमेज से 3D के साथ अपना पहला टास्क बनाएं। किसी टेक्स्ट prompt या कई फोटो से काम कर रहे हैं? देखें टेक्स्ट से 3D या मल्टी-इमेज से 3D।
Export your key
export MESHY_API_KEY="<your-api-key>"
इसे अपने टर्मिनल में चलाएं (macOS पर Terminal, Windows पर Command Prompt या PowerShell) — किसी ब्राउज़र में नहीं।
नीचे दिया गया हर उदाहरण इसी फोटो का उपयोग करता है — कुछ और आज़माने के लिए अपना खुद का image_url डालें।

Request
curl https://api.meshy.ai/openapi/v1/image-to-3d \
-X POST \
-H "Authorization: Bearer ${MESHY_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://docs.meshy.ai/images/api/quick-start/source-photo.webp"
}'
3टास्क स्टेटस जांचें
रिक्वेस्ट तुरंत एक टास्क ID लौटाती हैं। status के SUCCEEDED होने तक उसी एंडपॉइंट को पोल करें — नीचे <task_id> को चरण 2 में लौटाई गई ID से बदलें।
Request
curl https://api.meshy.ai/openapi/v1/image-to-3d/<task_id> \
-H "Authorization: Bearer ${MESHY_API_KEY}"
Response — SUCCEEDED
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"status": "SUCCEEDED",
"progress": 100,
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"task_error": {
"message": ""
}
}
पोलिंग आपकी पसंद के मुताबिक नहीं है? टास्क पूरा होते ही सूचना पाने के लिए SSE स्ट्रीमिंग या webhook का उपयोग करें।
4अपना मॉडल डाउनलोड करें
ऊपर दिए गए रिस्पॉन्स में model_urls से मॉडल प्राप्त करें। हर फॉर्मैट (GLB, FBX, OBJ, USDZ, STL) एक साइन्ड, समय-सीमित URL है — या कमांड लाइन को छोड़कर डाउनलोड करने के लिए URL को सीधे अपने ब्राउज़र के एड्रेस बार में पेस्ट करें।
Download
curl -L "<model_urls.glb from the response above>" -o model.glb

गैर-Enterprise प्लान पर फाइलें 3 दिनों के लिए रिटेन की जाती हैं — देखें एसेट रिटेंशन।
सब कुछ एक साथ रखें
एक ऐसी स्क्रिप्ट पसंद करते हैं जो पूरा काम कर दे — बनाना, पोल करना, डाउनलोड करना?
Full script
import axios from 'axios';
import fs from 'fs';
const headers = { Authorization: `Bearer ${process.env.MESHY_API_KEY}` };
const imageUrl = 'https://docs.meshy.ai/images/api/quick-start/source-photo.webp';
// 1. Create the task
const { data: created } = await axios.post(
'https://api.meshy.ai/openapi/v1/image-to-3d',
{ image_url: imageUrl },
{ headers },
);
const taskId = created.result;
// 2. Poll until it finishes
let task;
while (true) {
const { data } = await axios.get(`https://api.meshy.ai/openapi/v1/image-to-3d/${taskId}`, { headers });
task = data;
if (task.status === 'SUCCEEDED' || task.status === 'FAILED') break;
await new Promise((resolve) => setTimeout(resolve, 5000));
}
// 3. Download the result (only if the task succeeded)
if (task.status !== 'SUCCEEDED') {
throw new Error(`Task ${task.status}: ${task.task_error?.message || 'unknown error'}`);
}
const { data: model } = await axios.get(task.model_urls.glb, { responseType: 'arraybuffer' });
fs.writeFileSync('model.glb', model);
console.log('Saved model.glb');
सामान्य वर्कफ़्लो एक्सप्लोर करें
गेम-रेडी कैरेक्टर
एक ह्यूमनॉइड मेश को स्केलेटन के साथ रिग करें ताकि यह Unity या Unreal में एनिमेट करने के लिए तैयार हो।
Learn more →लोपॉली एसेट
एक साफ, गेम-रेडी मेश के लिए इमेज से 3D पर model_type को lowpoly सेट करें।
3D प्रिंट मॉडल
एक तैयार मॉडल को मल्टी-कलर 3MF फाइल में कन्वर्ट करें, जो स्लाइस और प्रिंट करने के लिए तैयार हो।
Learn more →अगले कदम
- UI पसंद करते हैं? Developer Platform खोलें — Playground में रिक्वेस्ट चलाएं, उपयोग और रिक्वेस्ट लॉग ट्रैक करें, और webhooks प्रबंधित करें।
- हर एंडपॉइंट के लिए पूरा API रेफरेंस ब्राउज़ करें।
- प्रोडक्शन में जाने से पहले मूल्य निर्धारण, Rate Limits, और एरर जांच लें।
- अपडेट और बग फिक्स के लिए चेंजलॉग देखते रहें।
- फीडबैक है या कोई समस्या हो रही है? हमारे Discord समुदाय से जुड़ें — हमें आपसे सुनना अच्छा लगेगा!