टेक्स्ट से इमेज API

Meshy के AI मॉडल्स की मदद से टेक्स्ट prompt से इमेज जनरेट करें।

टेक्स्ट से इमेज इमेज बनाता है। किसी इमेज में मौजूद चीज़ का 3D मॉडल बनाने के लिए इमेज से 3D का उपयोग करें। किसी फ़ोटो से ऐसी ऑब्जेक्ट बनाने के लिए जिसे आप पकड़ सकें या प्रिंट कर सकें, Creative Lab APIs का उपयोग करें। ये पहले एक प्रोटोटाइप इमेज बनाते हैं और फिर उससे एक 3D मॉडल तैयार करते हैं, उदाहरण के लिए चाबी का छल्ला, फ्रिज मैग्नेट, फिगर, लैंप, या कीकैप।

POST/openapi/v1/text-to-image

टेक्स्ट से इमेज टास्क बनाएं

एक टेक्स्ट से इमेज टास्क बनाता है। टास्क बैकग्राउंड में चलता है। किसी टास्क में आमतौर पर कितना समय लगता है, यह जानने के लिए Processing times देखें।

Request

POST

/openapi/v1/text-to-image

# Generate an image from a text prompt
curl https://api.meshy.ai/openapi/v1/text-to-image \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "ai_model": "nano-banana",
    "prompt": "A majestic dragon soaring through clouds at sunset",
    "aspect_ratio": "16:9"
  }'

Response

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

पैरामीटर

Name
ai_model
Type
string
आवश्यक
Description
वह AI मॉडल जो इमेज जनरेट करता है। मॉडल के अनुसार कीमतें अलग-अलग होती हैं। कीमतों के लिए, Pricing देखें।
उपलब्ध मान:
- nano-banana: स्टैंडर्ड मॉडल
- nano-banana-2: nano-banana से अधिक सक्षम
- nano-banana-2-lite: nano-banana-2 का एक लाइट वर्शन
- nano-banana-2-1: Nano Banana 2.1
- nano-banana-pro: Pro मॉडल, उच्च गुणवत्ता के साथ। इसके लिए Pro या उससे ऊपर का प्लान आवश्यक है। निचले प्लान पर, यह 402 लौटाता है।
- gpt-image-2: OpenAI GPT Image 2
- gpt-image-2-5-flare: OpenAI GPT Image 2.5 (Flare)
- gpt-image-2-5-sunburst: OpenAI GPT Image 2.5 (Sunburst)
Name
prompt
Type
string
आवश्यक
Description
वह टेक्स्ट जो जनरेट की जाने वाली इमेज का वर्णन करता है। विस्तृत विवरण से बेहतर परिणाम मिलते हैं।
Name
generate_multi_view
Type
boolean
डिफ़ॉल्ट false
Description
क्या मल्टी-व्यू इमेज जनरेट करनी है जो विषय को कई कोणों से दिखाती है। जब यह true हो, तो आप aspect_ratio नहीं भेज सकते। दोनों भेजने पर 400 लौटता है।
Name
pose_mode
Type
string
Description
किसी कैरेक्टर के लिए पोज़, a-pose या t-pose। कोई पोज़ नहीं चाहिए तो इसे छोड़ दें।
पोज़ कैसे काम करता है यह ai_model पर निर्भर करता है:
- nano-banana-2, nano-banana-2-lite, और nano-banana-2-1: Meshy आपके द्वारा चुने गए मॉडल को बनाए रखता है। इमेज हमेशा 3:4 होती है, और Meshy aspect_ratio को नज़रअंदाज़ करता है।
- nano-banana और nano-banana-pro: Meshy nano-banana-pro के साथ इमेज जनरेट करता है, इसलिए टास्क का ai_model वापस nano-banana-pro के रूप में पढ़ा जाता है। इसके लिए Pro या उससे ऊपर का प्लान आवश्यक है। इमेज हमेशा 3:4 होती है, और Meshy aspect_ratio को नज़रअंदाज़ करता है।
- GPT Image मॉडल (gpt-image-2, gpt-image-2-5-flare, और gpt-image-2-5-sunburst): Meshy आपके द्वारा चुने गए मॉडल और आपके aspect_ratio को बनाए रखता है।
Name
aspect_ratio
Type
string
डिफ़ॉल्ट 1:1
Description
इमेज का आकार। आप जो मान भेज सकते हैं वह ai_model पर निर्भर करता है।
उपलब्ध मान:
- 1:1: वर्ग
- 16:9: वाइडस्क्रीन लैंडस्केप
- 9:16: वाइडस्क्रीन पोर्ट्रेट
- 4:3: स्टैंडर्ड लैंडस्केप
- 3:4: स्टैंडर्ड पोर्ट्रेट
- 3:2: लैंडस्केप, केवल GPT Image मॉडल
- 2:3: पोर्ट्रेट, केवल GPT Image मॉडल
nano-banana मॉडल (nano-banana, nano-banana-2, nano-banana-2-lite, nano-banana-2-1, और nano-banana-pro) 3:2 और 2:3 के लिए 400 लौटाते हैं।
Name
remove_background
Type
boolean
डिफ़ॉल्ट false
Description
क्या इमेज का बैकग्राउंड हटाना है। true करने पर एक ट्रांसपेरेंट RGBA PNG मिलता है, ताकि आप विषय को किसी भी बैकग्राउंड पर रख सकें।

रिटर्न

रिस्पॉन्स का result फ़ील्ड नए टेक्स्ट से इमेज टास्क की ID रखता है।

फेल्योर मोड

Name
400 - Bad Request
Description
रिक्वेस्ट चल नहीं सकती। एरर मैसेज बताता है कि कौन-सी समस्या मिली। उदाहरण के लिए:
- गुम पैरामीटर: एक आवश्यक पैरामीटर, जैसे ai_model या prompt, गुम है।
- अमान्य पैरामीटर: ai_model या aspect_ratio अनुमत मानों में से एक नहीं है।
- कॉन्फ़्लिक्ट: aspect_ratio को generate_multi_view: true के साथ भेजा गया था।
रिक्वेस्ट को ठीक करें, फिर इसे फिर से भेजें। Errors देखें।
Name
401 - Unauthorized
Description
API की गुम है या अमान्य है। Authorization हेडर जाँचें।
Name
402 - Payment Required
Description
अकाउंट यह टास्क नहीं चला सकता। उदाहरण के लिए:
- फ्री प्लान: टास्क बनाने के लिए पेड प्लान आवश्यक है। अपने subscription settings में अपना प्लान अपग्रेड करें, फिर फिर से प्रयास करें।
- अपर्याप्त क्रेडिट: अकाउंट के पास इस टास्क के लिए पर्याप्त क्रेडिट नहीं हैं (Insufficient funds), या अकाउंट क्रेडिट लिमिट तक पहुँच गया है।
- प्लान आवश्यक: रिक्वेस्ट nano-banana-pro का उपयोग करती है, या Pro से नीचे के प्लान पर nano-banana के साथ pose_mode का उपयोग करती है (Only Pro and above users can use nano-banana-pro, या Only Pro and above users can use A/T pose feature (requires nano-banana-pro))।
अपना क्रेडिट बैलेंस और प्लान जाँचें, फिर फिर से प्रयास करें।
Name
429 - Too Many Requests
Description
आपने अपनी रेट लिमिट पार कर ली है। प्रतीक्षा करें, फिर फिर से प्रयास करें। Rate limits देखें।

GET/openapi/v1/text-to-image/:id

टेक्स्ट से इमेज टास्क प्राप्त करें

यह किसी टेक्स्ट से इमेज टास्क को उसकी ID से रिटर्न करता है।

Request

GET

/openapi/v1/text-to-image/018a210d-8ba4-705c-b111-1f1776f7f578

curl https://api.meshy.ai/openapi/v1/text-to-image/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "text-to-image",
  "ai_model": "nano-banana",
  "prompt": "A majestic dragon soaring through clouds at sunset",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "expires_at": 1692771679037,
  "image_urls": [
    "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/image.png?Expires=***"
  ]
}

पैरामीटर

Name
id
Type
path
Description
क्रिएट रिस्पॉन्स से प्राप्त टास्क ID।

रिटर्न वैल्यू

टेक्स्ट से इमेज टास्क ऑब्जेक्ट।

DELETE/openapi/v1/text-to-image/:id

एक टेक्स्ट से इमेज टास्क डिलीट करें

किसी टेक्स्ट से इमेज टास्क को, उसकी इमेजेज़ और डेटा सहित, स्थायी रूप से डिलीट कर देता है। आप डिलीट को अनडू नहीं कर सकते।

Request

DELETE

/openapi/v1/text-to-image/018a210d-8ba4-705c-b111-1f1776f7f578

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/text-to-image/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

पाथ पैरामीटर

Name
id
Type
path
Description
डिलीट किए जाने वाले टास्क की ID।

टास्क स्टेटस

किसी PENDING टास्क को डिलीट करने पर उसे बनाते समय उपयोग किए गए क्रेडिट रिफंड हो जाते हैं।

किसी IN_PROGRESS टास्क को डिलीट नहीं किया जा सकता। रिक्वेस्ट 409 Conflict लौटाती है, और टास्क चलता रहता है। Meshy उस टास्क को रिफंड नहीं करता जो शुरू हो चुका है, इसलिए उसे डिलीट करने पर आपको क्रेडिट और रिज़ल्ट दोनों का नुकसान होगा। इसके SUCCEEDED, FAILED, या CANCELED तक पहुँचने का इंतज़ार करें, फिर उसे डिलीट करें।

अंतिम स्टेटस (SUCCEEDED, FAILED, या CANCELED) में किसी टास्क को डिलीट करने पर उसके क्रेडिट रिफंड नहीं होते।

रिटर्न्स

जब टास्क डिलीट हो जाता है तो 200 OK, या जब टास्क IN_PROGRESS होता है तो 409 Conflict।

GET/openapi/v1/text-to-image

टेक्स्ट से इमेज कार्यों की सूची प्राप्त करें

यह आपके टेक्स्ट से इमेज और इमेज से इमेज कार्यों की एक सूची लौटाता है। प्रत्येक कार्य का type फ़ील्ड बताता है कि यह दोनों में से कौन सा है।

Request

GET

/openapi/v1/text-to-image

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

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "text-to-image",
    "ai_model": "nano-banana",
    "prompt": "A majestic dragon soaring through clouds at sunset",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1692771650657,
    "started_at": 1692771667037,
    "finished_at": 1692771669037,
    "expires_at": 1692771679037,
    "image_urls": [
      "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/image.png?Expires=***"
    ]
  }
]

पैरामीटर

Name
page_num
Type
integer
Description
लौटाया जाने वाला पेज नंबर। यह 1 से शुरू होता है और डिफ़ॉल्ट रूप से 1 है।
Name
page_size
Type
integer
Description
प्रति पेज कार्यों की संख्या, अधिकतम 100। डिफ़ॉल्ट रूप से 10।
Name
sort_by
Type
string
Description
सॉर्ट क्रम।
उपलब्ध मान:
- +created_at: सबसे पुराना पहले
- -created_at: सबसे नया पहले

रिटर्न

कार्य ऑब्जेक्ट्स की एक पेज में विभाजित सूची, टेक्स्ट से इमेज कार्य ऑब्जेक्ट जैसे ही फ़ॉर्मेट में।

GET/openapi/v1/text-to-image/:id/stream

Text to Image टास्क को स्ट्रीम करें

किसी Text to Image टास्क के अपडेट्स को Server-Sent Events (SSE) के रूप में स्ट्रीम करता है।

Request

GET

/openapi/v1/text-to-image/018a210d-8ba4-705c-b111-1f1776f7f578/stream

curl -N https://api.meshy.ai/openapi/v1/text-to-image/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "text-to-image",
  "ai_model": "nano-banana",
  "prompt": "A majestic dragon soaring through clouds at sunset",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "expires_at": 1692771679037,
  "image_urls": [
    "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/image.png?Expires=***"
  ]
}

Parameters

Name
id
Type
path
Description
क्रिएट रिस्पॉन्स से मिला टास्क ID।

Returns

Text to Image टास्क ऑब्जेक्ट्स की एक स्ट्रीम, Server-Sent Events के रूप में।

हर इवेंट में पूरा टास्क ऑब्जेक्ट होता है, ठीक उसी रूप में जैसा Get एंडपॉइंट रिटर्न करता है। जब तक टास्क PENDING या IN_PROGRESS है, तब तक इसके रिजल्ट फ़ील्ड्स में कोई वैल्यू नहीं होती।

टेक्स्ट से इमेज टास्क ऑब्जेक्ट

एक टेक्स्ट से इमेज टास्क ऑब्जेक्ट एक टेक्स्ट prompt से होने वाले एक इमेज जनरेशन का वर्णन करता है। इसमें status, progress, और टास्क सफल होने पर इमेज URLs होते हैं।

Properties

Example Text to Image Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "text-to-image",
  "ai_model": "nano-banana",
  "prompt": "A majestic dragon soaring through clouds at sunset",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "expires_at": 1692771679037,
  "image_urls": [
    "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/image.png?Expires=***"
  ],
  "task_error": null,

  "consumed_credits": 3
}

Name
id
Type
string
Description
टास्क ID। इसे एक अपारदर्शी (opaque) स्ट्रिंग मानें, और इसके फॉर्मेट पर भरोसा न करें।
Name
type
Type
string
Description
टास्क टाइप, हमेशा text-to-image।
Name
ai_model
Type
string
Description
टास्क ने जिस AI मॉडल का उपयोग किया।
संभावित वैल्यू:
- nano-banana
- nano-banana-2
- nano-banana-2-lite
- nano-banana-2-1
- nano-banana-pro
- gpt-image-2
- gpt-image-2-5-flare
- gpt-image-2-5-sunburst
Name
prompt
Type
string
Description
वह टेक्स्ट prompt जिससे आपने टास्क बनाया था।
Name
status
Type
string
Description
टास्क status, PENDING, IN_PROGRESS, SUCCEEDED, FAILED, या CANCELED में से एक।
Name
progress
Type
integer
Description
टास्क कितना पूरा हुआ है, प्रतिशत के रूप में। यह तब तक 0 रहता है जब तक टास्क शुरू नहीं होता और सफल होने पर 100 हो जाता है।
Name
created_at
Type
timestamp
Description
टास्क बनाए जाने का समय, Unix मिलीसेकंड में।
Name
started_at
Type
timestamp
Description
टास्क शुरू होने का समय, Unix मिलीसेकंड में। जब तक टास्क शुरू नहीं होता, यह अनुपस्थित रहता है।
Name
finished_at
Type
timestamp
Description
टास्क समाप्त होने का समय, Unix मिलीसेकंड में। जब तक टास्क समाप्त नहीं होता, यह अनुपस्थित रहता है।
Name
expires_at
Type
timestamp
Description
जिस समय टास्क के परिणाम expire होते हैं, Unix मिलीसेकंड में। जब तक टास्क समाप्त नहीं होता, यह अनुपस्थित रहता है।
Name
preceding_tasks
Type
integer
Description
कतार में इस टास्क से आगे मौजूद टास्कों की संख्या। यह वैल्यू तभी सार्थक है जब टास्क PENDING हो। जब वैल्यू 0 होती है, तो इस फील्ड को छोड़ दिया जाता है।
Name
image_urls
Type
array
Description
जनरेट की गई इमेजेस के लिए डाउनलोड URLs। generate_multi_view: true के साथ, array में प्रति व्यू एक URL होता है, आमतौर पर तीन। अगर Meshy हर व्यू को अलग नहीं कर पाता, तो यह कम URLs लौटाता है, और टास्क फिर भी सफल होता है। अन्यथा, इसमें एक URL होता है।
Name
task_error
Type
object
Description
टास्क fail होने पर एरर का विवरण। यह null होता है जब तक status FAILED न हो। एरर देखें।
Name
consumed_credits
Type
integer
Description
टास्क द्वारा उपयोग किए गए क्रेडिट की संख्या। यह तब मौजूद होता है जब status PENDING, IN_PROGRESS, या SUCCEEDED हो। FAILED टास्क के लिए यह 0 होता है, क्योंकि टास्क fail होने पर Meshy क्रेडिट रिफंड कर देता है।