इमेज से इमेज API

अपने स्वयं के एप्लिकेशन में इमेज को एडिट और ट्रांसफ़ॉर्म करें। संदर्भ इमेज और एक टेक्स्ट prompt भेजें, और Meshy के AI मॉडल उनसे एक नई इमेज जनरेट करते हैं।

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

POST/openapi/v1/image-to-image

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

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

Request

POST

/openapi/v1/image-to-image

# Transform a reference image with a text prompt
curl https://api.meshy.ai/openapi/v1/image-to-image \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "ai_model": "nano-banana",
    "prompt": "Transform this into a cyberpunk style artwork",
    "reference_image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>"
    ]
  }'


 ## Using data URI example
curl https://api.meshy.ai/openapi/v1/image-to-image \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "ai_model": "nano-banana",
    "prompt": "Transform this into a cyberpunk style artwork",
    "reference_image_urls": [
      "data:image/png;base64,${YOUR_BASE64_ENCODED_IMAGE_DATA}"
    ]
  }'


 ## Chaining from a previous task, instead of passing image URLs
curl https://api.meshy.ai/openapi/v1/image-to-image \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "ai_model": "nano-banana",
    "prompt": "Transform this into a cyberpunk style artwork",
    "input_task_id": "<your Text to Image or Image to Image task id>"
  }'

Response

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

पैरामीटर

Name
ai_model
Type
string
आवश्यक
Description
वह AI मॉडल जो इमेज जनरेट करता है। कीमतें मॉडल के अनुसार अलग होती हैं। देखें मूल्य निर्धारण।
उपलब्ध मान:
- 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
input_task_id
Type
string
आवश्यक
Description
आवश्यक है जब तक आप reference_image_urls न भेजें। टेक्स्ट से इमेज या इमेज से इमेज टास्क की ID, जिसकी इमेज को रेफरेंस के रूप में उपयोग करना है, मल्टी-व्यू टास्क सहित। टास्क वह होना चाहिए जिसे आपने API से बनाया हो और जिसका स्टेटस SUCCEEDED हो।
Meshy उस टास्क द्वारा बनाई गई हर इमेज का उपयोग करता है। एक सिंगल-इमेज टास्क एक रेफरेंस इमेज देता है, और एक मल्टी-व्यू टास्क हर व्यू के लिए एक देता है। इसलिए एक टास्क ID पाँच रेफरेंस स्लॉट में से कई को भर सकती है।
टास्क अभी भी एसेट रिटेंशन अवधि के भीतर होना चाहिए। इसके समाप्त होने के बाद, उसकी ID 404 रिटर्न करती है।

Name
reference_image_urls
Type
array
आवश्यक
Description
आवश्यक है जब तक आप input_task_id न भेजें। एडिट करने के लिए एक से पाँच रेफरेंस इमेज, प्रत्येक या तो एक पब्लिक URL या एक data URI, उदाहरण के लिए data:image/jpeg;base64,<your base64-encoded image data>। एक खाली array, या पाँच से अधिक इमेज, 400 रिटर्न करता है। यदि आप दोनों भेजते हैं, तो Meshy input_task_id का उपयोग करता है।
प्रत्येक इमेज अधिकतम 20 MB की .jpg, .jpeg, .png, या .webp फ़ाइल होनी चाहिए, और प्रत्येक साइड पर कम से कम 32 पिक्सेल की होनी चाहिए।

Name
generate_multi_view
Type
boolean
डिफ़ॉल्ट false
Description
क्या एक मल्टी-व्यू इमेज जनरेट करनी है जो विषय को कई कोणों से दिखाए। जब true हो, तो आप aspect_ratio नहीं भेज सकते। दोनों भेजने पर 400 रिटर्न होता है।
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 मॉडल
GPT Image मॉडल हैं gpt-image-2, gpt-image-2-5-flare, और gpt-image-2-5-sunburst। nano-banana मॉडल के साथ, 3:2 और 2:3 400 रिटर्न करते हैं।
Name
remove_background
Type
boolean
डिफ़ॉल्ट false
Description
क्या बैकग्राउंड हटाना है। जब true हो, तो Meshy आउटपुट इमेज को एक ट्रांसपेरेंट RGBA PNG के रूप में रिटर्न करता है, ताकि आप विषय को किसी भी बैकग्राउंड पर रख सकें।

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

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

फेलियर मोड

Name
400 - Bad Request
Description
रिक्वेस्ट नहीं चल सकती। एरर मैसेज बताता है कि कौन सी समस्या मिली। उदाहरण के लिए:
- पैरामीटर गुम है: एक आवश्यक पैरामीटर, जैसे ai_model या prompt, गुम है, या न तो reference_image_urls और न ही input_task_id भेजा गया था।
- अमान्य इनपुट टास्क: input_task_id किसी उपयोग योग्य टास्क की ओर इंगित नहीं करता। यह एक SUCCEEDED टेक्स्ट से इमेज या इमेज से इमेज टास्क होना चाहिए, मल्टी-व्यू सहित, जिसका इमेज आउटपुट अभी भी मौजूद हो। Meshy किसी अन्य प्रकार के टास्क, ऐसे टास्क को जो सफल नहीं हुआ, और ऐसे टास्क को जिसकी सभी इमेज समाप्त हो चुकी हैं, अस्वीकार कर देता है।
- अमान्य इमेज फॉर्मेट: एक या अधिक रेफरेंस इमेज सपोर्टेड फॉर्मेट में नहीं हैं।
- अनरीचेबल URL: Meshy एक या अधिक reference_image_urls इमेज डाउनलोड नहीं कर सकता।
- इमेज बहुत बड़ी है: एक या अधिक reference_image_urls इमेज 20 MB से अधिक हैं।
- इमेज बहुत छोटी है: एक या अधिक reference_image_urls इमेज की साइड 32 पिक्सेल से कम है।
- अमान्य पैरामीटर: aspect_ratio चुने गए ai_model द्वारा समर्थित मानों में से एक नहीं है।
- कॉन्फ़्लिक्ट: रिक्वेस्ट aspect_ratio को generate_multi_view: true के साथ भेजती है।
रिक्वेस्ट को ठीक करें, फिर इसे दोबारा भेजें। देखें एरर।
Name
401 - Unauthorized
Description
API की गुम है या अमान्य है। Authorization हेडर जाँचें।
Name
402 - Payment Required
Description
खाता यह टास्क नहीं चला सकता। उदाहरण के लिए:
- फ्री प्लान: टास्क बनाने के लिए एक पेड प्लान आवश्यक है। अपने सब्सक्रिप्शन सेटिंग्स में अपना प्लान अपग्रेड करें, फिर दोबारा प्रयास करें।
- अपर्याप्त क्रेडिट: खाते में इस टास्क के लिए पर्याप्त क्रेडिट नहीं हैं, या खाता एक क्रेडिट लिमिट तक पहुँच गया है।
- प्लान आवश्यक है: रिक्वेस्ट Pro से नीचे के प्लान पर nano-banana-pro का उपयोग करती है।
अपना क्रेडिट बैलेंस और प्लान जाँचें, फिर दोबारा प्रयास करें।
Name
404 - Not Found
Description
input_task_id आपके खाते के किसी टास्क से मेल नहीं खाता। जो टास्क मौजूद नहीं है और जो टास्क किसी अन्य खाते का है, दोनों एक ही रिस्पॉन्स रिटर्न करते हैं। ID जाँचें।
Name
429 - Too Many Requests
Description
आपने अपनी रेट लिमिट पार कर ली है। प्रतीक्षा करें, फिर दोबारा प्रयास करें। देखें रेट लिमिट।

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

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

यह किसी इमेज से इमेज टास्क को उसकी ID के माध्यम से लौटाता है।

Request

GET

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

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

Response

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "image-to-image",
  "ai_model": "nano-banana",
  "prompt": "Transform this into a cyberpunk style artwork",
  "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
बनाने (create) के रिस्पॉन्स से प्राप्त टास्क ID।

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

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

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

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

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

Request

DELETE

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

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/image-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/image-to-image

इमेज से इमेज टास्क की सूची

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

Request

GET

/openapi/v1/image-to-image

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

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "image-to-image",
    "ai_model": "nano-banana",
    "prompt": "Transform this into a cyberpunk style artwork",
    "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/image-to-image/:id/stream

इमेज से इमेज टास्क को स्ट्रीम करें

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

Request

GET

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

curl -N https://api.meshy.ai/openapi/v1/image-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": "image-to-image",
  "ai_model": "nano-banana",
  "prompt": "Transform this into a cyberpunk style artwork",
  "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।

रिटर्न

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

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

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

एक इमेज से इमेज टास्क ऑब्जेक्ट संदर्भ छवियों (reference images) और एक टेक्स्ट prompt से जनरेट की गई एक छवि का वर्णन करता है। टास्क के सफल होने पर इसमें स्टेटस, progress, और छवियाँ होती हैं।

Properties

Example Image to Image Task Object

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "image-to-image",
  "ai_model": "nano-banana",
  "prompt": "Transform this into a cyberpunk style artwork",
  "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
टास्क का प्रकार, हमेशा image-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
टास्क का स्टेटस, 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
टास्क के परिणामों के एक्सपायर होने का समय, Unix मिलीसेकंड में। टास्क पूरा होने तक अनुपस्थित रहता है।
Name
preceding_tasks
Type
integer
Description
कतार (queue) में इस टास्क से आगे मौजूद टास्कों की संख्या। यह मान केवल तभी सार्थक है जब टास्क PENDING स्थिति में हो। जब मान 0 हो तो इस फील्ड को शामिल नहीं किया जाता।
Name
image_urls
Type
array
Description
जनरेट की गई छवियों के लिए डाउनलोड URL। generate_multi_view: true के साथ, इसमें प्रति व्यू एक URL होता है, आमतौर पर तीन। यदि Meshy हर व्यू को अलग नहीं कर पाता, तो यह कम URL लौटाता है, और टास्क फिर भी सफल होता है। अन्यथा, इसमें एक URL होता है।
Name
task_error
Type
object
Description
टास्क फेल होने पर एरर विवरण। जब तक स्टेटस FAILED न हो, यह null होता है। देखें एरर।
Name
consumed_credits
Type
integer
Description
टास्क द्वारा उपयोग किए गए क्रेडिट की संख्या। यह तब मौजूद होता है जब स्टेटस PENDING, IN_PROGRESS, या SUCCEEDED हो। FAILED टास्क के लिए यह 0 होता है, क्योंकि टास्क फेल होने पर Meshy क्रेडिट वापस कर देता है।