क्विकस्टार्ट
अपनी API की बनाकर शुरू करें
इस गाइड में हर अनुरोध के लिए इसकी आवश्यकता होती है। एक की बनाना एक मिनट से कम समय में होता है।
अपनी API की बनाएंMeshy REST API का उपयोग करके अपने पहले 3D मॉडल के लिए चार चरण।
एक AI कोडिंग सहायक का उपयोग कर रहे हैं? हमारे AI इंटीग्रेशन पृष्ठ को देखें — Claude Code, Cursor, Windsurf, और अन्य MCP-संगत उपकरणों के टूल-कॉलिंग एक्सेस के लिए Meshy MCP सर्वर स्थापित करें, या सामान्यता एजेंट को llms.txt पर इंगित करें।
1अपनी API की प्राप्त करें
अपनी API की बनाएं अपने खाता सेटिंग्स से — आप इसे इस स्क्रीन के बाद फिर से नहीं देख पाएंगे, इसलिए इसे सुरक्षित स्थान पर स्टोर करें। हर अनुरोध Authorization हेडर में Bearer टोकन के साथ प्रमाणीकरण करता है — देखें प्रमाणीकरण।
सुरक्षा टिप: अपनी की को स्क्रिप्ट्स में सीधे चिपकाने से बचें — इसके बजाय इसे एक एनवायरनमेंट वेरिएबल के रूप में स्टोर करें: export MESHY_API_KEY="msy_..."।
2अपनी पहली इमेज से 3D रिक्वेस्ट बनाएं
अपनी की एक्सपोर्ट करें, फिर इमेज से 3D के साथ अपना पहला टास्क बनाएं। एक टेक्स्ट prompt या एकाधिक फ़ोटो से काम कर रहे हैं? देखें टेक्स्ट से 3D या मल्टी-इमेज से 3D।
अपनी की एक्सपोर्ट करें
export MESHY_API_KEY="<your-api-key>"
इसे अपने टर्मिनल (macOS पर टर्मिनल, Windows पर कमांड प्रॉम्प्ट या पावरशेल) में चलाएं — ब्राउज़र में नहीं।
नीचे दिए गए प्रत्येक उदाहरण के लिए इस फ़ोटो का उपयोग करें — कुछ और ट्राई करने के लिए अपना खुद का image_url डालें।
रिक्वेस्ट
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टास्क स्थिति की जाँच करें
रिक्वेस्ट तुरंत एक टास्क आईडी लौटाते हैं। उसी एंडपॉइंट को तब तक पोल करें जब तक status SUCCEEDED न हो — नीचे <task_id> को कदम 2 में लौटाए गए आईडी से बदलें।
रिक्वेस्ट
curl https://api.meshy.ai/openapi/v1/image-to-3d/<task_id> \
-H "Authorization: Bearer ${MESHY_API_KEY}"
उत्तर — 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 है — या कमांड लाइन को छोड़ दें और इसे अपने ब्राउज़र के एड्रेस बार में सीधे पेस्ट करें।
डाउनलोड
curl -L "<model_urls.glb from the response above>" -o model.glb
गैर-एंटरप्राइज योजनाओं पर फ़ाइलें 3 दिनों के लिए रखी जाती हैं — देखें एसेट रिटेंशन।
इसे सभी को एक साथ रखें
एक स्क्रिप्ट पसंद है जो पूरी चीज़ को करती है — बनाएं, पोल करें, डाउनलोड करें?
पूर्ण स्क्रिप्ट
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. टास्क बनाएं
const { data: created } = await axios.post(
'https://api.meshy.ai/openapi/v1/image-to-3d',
{ image_url: imageUrl },
{ headers },
);
const taskId = created.result;
// 2. समाप्त होने तक पोल करें
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. परिणाम डाउनलोड करें
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 पसंद है? API Playground आज़माएं — एक अनुरोध कॉन्फ़िगर करें, उसे चलाएं, और उत्पन्न कोड की प्रतिलिपि बनाएं।
- प्रत्येक endpoint के लिए पूरा API संदर्भ ब्राउज़ करें।
- उत्पादन में जाने से पहले मूल्य निर्धारण, रेट लिमिट्स, और एरर की जाँच करें।
- अपडेट और बग फिक्स के लिए चेंजलॉग देखें।
- आपकी प्रतिक्रिया या कोई समस्या है? हमारे Discord समुदाय से जुड़ें — हमें आपसे सुनकर अच्छा लगेगा!