VberAI API — डेवलपर्स के लिए RESTful रेफ़रेंस

VberAI API, VberAI की AI क्षमताओं (आज: AI सुपर मैटिंग) को आपके ऐप्स, गेम्स और ऑटोमेशन पाइपलाइनों में एम्बेड करने के लिए एक RESTful HTTP API है। ऑथेंटिकेशन हस्ताक्षर-आधारित अनुरोधों के साथ API कुंजियों का उपयोग करता है; सामान्य त्रुटि कोड मानकीकृत हैं; प्रति-कॉल बिलिंग VberAI क्रेडिट में भुगतान की जाती है।

API v1
स्थिर

API दस्तावेज़

HTTP पर सीधे images जनरेट करें, backgrounds हटाएँ, और VberAI की AI pipelines चलाएँ — personal या enterprise API keys के साथ।

AI लेयर विभाजन

एक सपाट UI छवि दीजिए और संपादन योग्य लेयरें पाइए: एक पृष्ठभूमि PNG, हर तत्व के लिए एक पारदर्शी PNG, और एक JSON सूची जिसमें हर लेयर का नाम, प्रकार, स्थिति, आकार और क्रम दिया होता है।

एक स्थिर छवि को संपादन योग्य मल्टी-लेयर सीन तत्वों में बाँटता है, और टेक्स्ट संपादन योग्य बना रहता है। UI सीन के स्वचालित विभाजन और डिज़ाइन पुनर्निर्माण के लिए बनाया गया।

यह कैसे काम करता है

  1. 1सपाट स्क्रीनशॉट भेजें और तुरंत taskId पाएँ — कार्य अतुल्यकालिक चलता है और आम तौर पर दो से तीन मिनट लेता है।
  2. 2कार्य की स्थिति पूछते रहें, या समाप्ति पर webhook से सूचना पाएँ।
  3. 3हस्ताक्षरित URL से PNG डाउनलोड करें और लेयर सूची के लिए result.text पढ़ें।

एंडपॉइंट

क्रियाव्यक्तिगत keyएंटरप्राइज़ key
सबमिटPOST /ai/tasksPOST /ai/org-services/ai-layer-split/execute-async
task status पोल करेंGET /ai/tasks/{taskId}GET /ai/org-services/tasks/{taskId}
नए download URLs को पुनः साइन करेंGET /ai/tasks/{taskId}/outputsGET /ai/org-services/tasks/{taskId}/outputs

एंटरप्राइज़ keys को /ai/org-services route पोल करना ही चाहिए

किसी personal /ai/tasks route पर भेजी गई एंटरप्राइज़ key (vber_org_sk_) 401 INVALID_API_KEY लौटाती है — personal routes केवल personal keys स्वीकार करते हैं। एंटरप्राइज़ jobs को हमेशा /ai/org-services/tasks/{taskId} पर पोल करें। Cancel और batch-status केवल personal-key के लिए हैं।

अनुरोध का ढाँचा

सेवा पैरामीटर दोनों प्रकार की कुंजियों के लिए एक जैसे हैं; केवल बाहरी आवरण अलग है।

फ़ील्डव्यक्तिगत keyएंटरप्राइज़ key
नीचे सूचीबद्ध सेवा पैरामीटर।serviceCode + inputsinput
webhookUrlवैकल्पिकवैकल्पिक
webhookSecretवैकल्पिकवैकल्पिक

व्यक्तिगत key

दोनों प्रकार की कुंजियाँ केवल पोलिंग से काम चला सकती हैं: webhookUrl न दें और स्वयं स्थिति देखें, या दें तो कार्य पूरा होने पर कॉल पाएँ। देने पर यह सार्वजनिक https URL होना चाहिए।

सेवा पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
messagesarrayदोनों में से एकस्रोत छवि ले जाने वाला संवाद ऐरे: content[] में एक { "type": "image_url", "image_url": { "url": "…" } } भाग होना चाहिए। URL सार्वजनिक https लिंक या इनलाइन data: URI हो सकता है।
referenceImagestringदोनों में से एकस्रोत छवि देने का संक्षिप्त तरीका: सार्वजनिक https URL या इनलाइन data: URI। messages[] के बजाय इसका उपयोग करें।
referenceWidthnumberनहींस्रोत की घोषित चौड़ाई (पिक्सेल)। यह केवल सबमिट के समय मूल्य श्रेणी तय करने के काम आती है; वास्तविक आकार छवि से ही मापा जाता है।
referenceHeightnumberनहींस्रोत की घोषित ऊँचाई (पिक्सेल)। उद्देश्य referenceWidth जैसा ही है।
imageConfigobjectनहींभविष्य के जनरेशन विकल्पों के लिए आरक्षित। फ़िलहाल अनदेखा किया जाता है।
स्रोत छवि या तो messages[] (OpenAI शैली के कंटेंट पार्ट) से दें या referenceImage से — दोनों में से एक अनिवार्य है।

इनलाइन base64 छवियाँ

स्क्रीनशॉट खुद होस्ट करने के बजाय उसे data: URI के रूप में सीधे अनुरोध में रखें। प्लेटफ़ॉर्म उसे सर्वर पर संग्रहित करता है और बनी हुई URL पाइपलाइन को देता है, बाकी सब वैसा ही रहता है।

json
{
  "referenceImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "referenceWidth": 1295,
  "referenceHeight": 726
}
इनलाइन मीडिया प्रति आइटम 20 MB तक सीमित है (डिकोड किया गया आकार, base64 टेक्स्ट की लंबाई नहीं)। इससे बड़ी छवियाँ https URL से भेजें।
POST/ai/tasks
bash
curl -X POST https://api.vberai.com/api/ai/tasks \
  -H "X-API-Key: vber_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "serviceCode": "ai-layer-split",
  "inputs": {
    "messages": [
      {
        "role": "user",
        "content": [
          { "type": "image_url", "image_url": { "url": "https://example.com/lobby.png" } }
        ]
      }
    ],
    "referenceWidth": 1295,
    "referenceHeight": 726
  },
  "webhookUrl": "https://your-server.com/hook",
  "webhookSecret": "whsec_your_secret"
}'

सबमिट प्रतिक्रिया — HTTP 201

json
{
  "success": true,
  "message": "Created",
  "data": {
    "taskId": "6a9db1471ef5f25400621411",
    "taskToken": "510932d23b39a0176837a3adfd6f64a773bc85f984417a7d6bcde08108494d30",
    "status": "queued",
    "estimatedCredits": 150,
    "message": "Task queued for processing"
  },
  "timestamp": "2026-09-06T18:30:31.837Z"
}

कार्य की स्थिति पूछना

तब तक पूछते रहें जब तक status completed या failed न हो जाए। कार्य रिकॉर्ड और फ़ाइलें सात दिन तक उपलब्ध रहती हैं।

एक task इन मानों से होकर गुजरता है। किसी टर्मिनल status तक पहुँचते ही पोलिंग बंद कर दें: completed, failed, cancelled या timeout।

queuedprocessingcompletedfailedcancelledtimeout

कार्य के फ़ील्ड

फ़ील्डविवरण
taskIdकार्य पहचानकर्ता — पोलिंग, आउटपुट और webhook मिलान के लिए उपयोग करें।
serviceCodeहमेशा ai-layer-split।
statusqueued · processing · completed · failed · cancelled · timeout।
progressबैकएंड द्वारा बताई गई मोटी प्रगति; अन्यथा null।
providerनिष्पादन चैनल। हमेशा external बताया जाता है।
hasResultresult तैयार होते ही true।
errorविफलता का कारण; कार्य ठीक चलने पर null।
createdAt · startedAt · completedAtनिर्माण, निष्पादन आरंभ और समाप्ति का समय (ISO 8601, UTC)।
expiresAtकार्य रिकॉर्ड और फ़ाइलें कब हटेंगी — पूर्ण होने के सात दिन बाद।
creditsEstimated · creditsActualसबमिट पर आरक्षित और पूर्ण होने पर वास्तव में कटे क्रेडिट। सफल होने पर दोनों बराबर; विफलता पर पूरी वापसी।
outputCountलौटाई गई फ़ाइलों की संख्या।
resultनीचे वर्णित परिणाम वस्तु; कार्य पूर्ण होने पर दिखती है।

परिणाम प्राप्त करना

आउटपुट एंडपॉइंट वही result वस्तु नए हस्ताक्षरित डाउनलोड URL के साथ लौटाता है — URL समाप्त होने पर इसे दोबारा कॉल करें।

json
{
  "success": true,
  "data": {
    "taskId": "6a9db1431ef5f254006213e0",
    "status": "completed",
    "result": { "type": "images", "assets": [ … ], "text": "{ … }" },
    "completedAt": "2026-09-06T18:32:26.326Z"
  }
}

Webhooks

webhookUrl सेट करने पर प्लेटफ़ॉर्म वही सामग्री POST से भेजता है जो पोलिंग लौटाती। webhookSecret सेट करने पर सत्यापन के लिए हस्ताक्षर हेडर भी मिलता है।

यदि आप कोई webhookSecret सेट करते हैं, तो हर delivery में एक X-Webhook-Signature header होता है — कच्चे JSON payload का HMAC-SHA256, hex-encoded रूप में। payload पर भरोसा करने से पहले इसे अपने secret के साथ पुनः गणना करें और तुलना करें। Deliveries में एक X-Idempotency-Key (taskId + status) भी होता है ताकि आप डुप्लिकेट्स को अनदेखा कर सकें।

Webhook पेलोड

json
{
  "taskId": "6a9db1431ef5f254006213e0",
  "serviceCode": "ai-layer-split",
  "status": "completed",
  "timestamp": "2026-09-06T18:32:26.401Z",
  "result": {
    "type": "images",
    "assets": [ { "index": 0, "name": "Lbg", "url": "https://assets.vberai.org/…/0.png?<signed-query>", "mimeType": "image/png", "size": 5067542, "sha256": "7ceb4dad…" }, … ],
    "text": "{\"imageSize\":{\"width\":1295,\"height\":726},\"nodes\":[…]}"
  }
}

Webhook · विफल कार्य

json
{
  "taskId": "6a9db1431ef5f254006213e0",
  "serviceCode": "ai-layer-split",
  "status": "failed",
  "timestamp": "2026-09-06T18:32:26.401Z",
  "error": { "code": "EXECUTION_ERROR", "message": "Task processing failed" }
}

कार्य स्थिति देखें

GET/ai/tasks/{taskId}
bash
curl https://api.vberai.com/api/ai/tasks/{taskId} \
  -H "X-API-Key: vber_sk_YOUR_KEY"

आउटपुट लाएँ

GET/ai/tasks/{taskId}/outputs
bash
curl https://api.vberai.com/api/ai/tasks/{taskId}/outputs \
  -H "X-API-Key: vber_sk_YOUR_KEY"

result वस्तु

result के दो हिस्से हैं: assets[] में लेयर छवियाँ और text में JSON स्ट्रिंग के रूप में लेयर सूची। assets[].name अपनी लेयर के id से एक-से-एक मेल खाता है।

आउटपुट फ़ाइलें

फ़ील्डप्रकारविवरण
indexnumberassets ऐरे में स्थान।
namestringलेयर id। यह ट्री में संबंधित नोड के id के बराबर है — इसी से छवि और ज्यामिति जुड़ती हैं।
urlstringहस्ताक्षरित डाउनलोड लिंक। जैसा है वैसा ही उपयोग करें, क्वेरी स्ट्रिंग न हटाएँ।
mimeType"image/png"हमेशा अल्फा चैनल वाला image/png।
sizenumberफ़ाइल का आकार बाइट में।
sha256stringफ़ाइल का SHA-256, अखंडता जाँच और डुप्लिकेट हटाने के लिए।
s3Keystringआंतरिक ऑब्जेक्ट कुंजी। केवल जानकारी के लिए।
डाउनलोड URL अल्पकालिक हैं (लगभग एक घंटा)। नई URL पाने के लिए आउटपुट एंडपॉइंट दोबारा कॉल करें; फ़ाइलें स्वयं सात दिन रहती हैं।

लेयर नामकरण

id सर्वर देता है और एक ही कार्य के भीतर स्थिर रहती है। उपसर्ग बताता है कि लेयर क्या है।

मानअर्थ
Lbgपृष्ठभूमि PNG: पूरी छवि जिसमें सभी पहचाने गए तत्व हटा दिए गए और खाली जगह दोबारा बना दी गई। हर कार्य में एक, और यह सबसे नीचे की लेयर है। यह imageSize से बड़ी आ सकती है — अपनी कार्य-माप के अनुसार स्केल करें।
A001, A002, …हर छवि तत्व के लिए एक PNG, सूची क्रम में क्रमांकित। पारदर्शी पृष्ठभूमि, और दूसरे तत्वों से ढके हिस्से भर दिए गए हैं। इसका पिक्सेल आकार box × imageSize है।
T001, T002, …टेक्स्ट तत्व। जानबूझकर कोई PNG नहीं — इसके बजाय आपको सटीक अक्षर और उनकी शैली मिलती है, ताकि उन्हें असली टेक्स्ट के रूप में बनाया जा सके।
groupसमूह प्रविष्टियाँ। कोई PNG नहीं; ये केवल बताती हैं कि कौन-सी लेयरें एक साथ हैं।

पूर्ण कार्य

json
{
  "success": true,
  "data": {
    "taskId": "6a9db1431ef5f254006213e0",
    "serviceCode": "ai-layer-split",
    "status": "completed",
    "progress": null,
    "provider": "external",
    "hasResult": true,
    "error": null,
    "createdAt": "2026-09-06T18:30:27.398Z",
    "startedAt": "2026-09-06T18:30:29.012Z",
    "completedAt": "2026-09-06T18:32:26.326Z",
    "expiresAt": "2026-09-13T18:32:26.326Z",
    "creditsEstimated": 150,
    "creditsActual": 150,
    "outputCount": 23,
    "result": {
      "type": "images",
      "assets": [
        {
          "index": 0,
          "url": "https://assets.vberai.org/tmp/user-assets/6a76f458…/task_6a9db143…_background/0.png?<signed-query>",
          "mimeType": "image/png",
          "s3Key": "tmp/user-assets/6a76f458…/task_6a9db143…_background/0.png",
          "size": 5067542,
          "sha256": "7ceb4dad585d2c60368e35c994ea53819b45f29f84fa5ec36704e9b3794a5f5e",
          "name": "Lbg"
        },
        {
          "index": 1,
          "url": "https://assets.vberai.org/ai-deliveries/6a76f458…/task_6a9db143…/A001-ab405a4a….png?<signed-query>",
          "mimeType": "image/png",
          "s3Key": "ai-deliveries/6a76f458…/task_6a9db143…/A001-ab405a4a….png",
          "size": 73117,
          "sha256": "ab405a4a607a7c9e95bd5dba0150f84743c73362f482bbeb990fc4687c90055e",
          "name": "A001"
        },
        … 21 more "A002" … "A022" assets …
      ],
      "text": "{\"imageSize\":{\"width\":1295,\"height\":726},\"nodes\":[{\"id\":\"Lbg\",…},{\"id\":\"A001\",…},…]}"
    }
  }
}

लेयर सूची (result.text)

result.text एक JSON स्ट्रिंग है — इसे पार्स करें। इसमें हर लेयर का नाम, प्रकार, स्थिति, आकार, समूह और क्रम सूचीबद्ध है।

शीर्ष स्तर

फ़ील्डप्रकारविवरण
imageSize{ width, height }विश्लेषित छवि का पिक्सेल आकार। हर box इसी का अनुपात है — पिक्सेल पाने के लिए इससे (या अपनी पसंद के किसी भी आकार से) गुणा करें।
nodesLayerNode[]सभी लेयरें एक सपाट ऐरे में। समूह parentId से और क्रम paintOrder से आता है; ऐरे का अपना क्रम कोई अर्थ नहीं रखता।

लेयर प्रविष्टि

फ़ील्डप्रकारविवरण
idstringलेयर id, संबंधित assets[].name के समान (Lbg, A001, T001…)। इसी से लेयर को उसके PNG से जोड़ें।
namestringAI द्वारा अनुमानित पठनीय नाम, जैसे join_room_card। वर्णनात्मक पर अद्वितीय होने की गारंटी नहीं — कुंजी के लिए id, दिखाने के लिए name का उपयोग करें।
kindstringलेयर का प्रकार; नीचे दी गई तालिका देखें।
box[x, y, w, h]स्थिति और आकार [x, y, चौड़ाई, ऊँचाई] के रूप में, imageSize के अनुपात में, मूल बिंदु ऊपर-बाएँ। पिक्सेल के लिए imageSize से गुणा करें।
parentIdstring | nullजिस समूह में है उसकी id, या रूट स्तर पर null।
paintOrdernumberएक ही पैरेंट वाली लेयरों के बीच क्रम, पीछे से आगे की ओर बढ़ता हुआ। पृष्ठभूमि -1 है।
occludedbooleantrue जब इस तत्व का कुछ भाग किसी दूसरे के पीछे छिपा था और दोबारा बनाना पड़ा।
instances[x, y, w, h][]उसी दोहराए गए तत्व के अतिरिक्त स्थान। और छवियाँ माँगने के बजाय इन्हीं बॉक्सों पर वही PNG रखें।
textobjectटेक्स्ट शैली; केवल तब मौजूद जब kind text हो।

लेयर के प्रकार

मानअर्थ
backgroundभरी हुई पृष्ठभूमि। केवल एक, सबसे पहले बनाई जाती है।
groupनेस्टिंग के लिए कंटेनर। इसकी अपनी कोई छवि नहीं।
uiपैनल, कार्ड, बटन या अन्य इंटरफ़ेस सतह। PNG के साथ आती है।
iconछोटा चिह्न। PNG के साथ आता है, ui की तरह ही संभाला जाता है।
textप्रोग्राम टेक्स्ट। कोई PNG नहीं — संपादन योग्य टेक्स्ट के रूप में बनाएँ।

टेक्स्ट गुण

फ़ील्डप्रकारविवरण
textstringस्क्रीनशॉट से पढ़े गए अक्षर, मूल भाषा में।
fontSizePctnumberअक्षर की ऊँचाई imageSize.height के अनुपात में। पिक्सेल फ़ॉन्ट आकार के लिए अपनी कार्य-ऊँचाई से गुणा करें।
color"#RRGGBB"अक्षर का भराव रंग।
fontWeight100–900संख्यात्मक फ़ॉन्ट भार।
italicbooleanटेक्स्ट तिरछा है या नहीं।
align"LEFT" | "CENTER" | "RIGHT"बॉक्स के भीतर क्षैतिज संरेखण।
fontFamilystringसुझाया गया फ़ॉन्ट परिवार; उपलब्ध न होने पर अपने डिफ़ॉल्ट फ़ॉन्ट का उपयोग करें।
strokeColor"#RRGGBB"अक्षर की रूपरेखा का रंग, जब टेक्स्ट में रूपरेखा हो।
strokeWidthPctnumberरूपरेखा की मोटाई imageSize.height के अनुपात में।
shadow{ color, dxPct, dyPct, blurPct }छाया: रंग, तथा imageSize की चौड़ाई और ऊँचाई के अनुपात में ऑफ़सेट और धुँधलापन।

लेयर सूची (अंश)

json
{
  "imageSize": { "width": 1295, "height": 726 },
  "nodes": [
    { "id": "Lbg",  "name": "background",     "kind": "background", "box": [0, 0, 1, 1], "parentId": null, "paintOrder": -1, "occluded": false },
    { "id": "A001", "name": "player_info_bg", "kind": "ui", "box": [0.0026, 0, 0.2644, 0.1322], "parentId": null, "paintOrder": 1, "occluded": false },
    { "id": "A005", "name": "player_avatar",  "kind": "ui", "box": [0.0108, 0.0069, 0.068, 0.1157], "parentId": null, "paintOrder": 5, "occluded": false },
    { "id": "A013", "name": "join_room_card", "kind": "ui", "box": [0.3153, 0.2546, 0.1825, 0.6906], "parentId": null, "paintOrder": 13, "occluded": false },
    {
      "id": "T001", "name": "player_name", "kind": "text",
      "box": [0.0827, 0.0193, 0.1543, 0.0427], "parentId": null, "paintOrder": 18, "occluded": false,
      "text": { "text": "明月清风晓星尘", "fontSizePct": 0.022, "color": "#FFFFFF", "fontWeight": 400, "align": "LEFT" }
    },
    {
      "id": "T003", "name": "currency_1_amount", "kind": "text",
      "box": [0.3614, 0.0372, 0.0533, 0.0455], "parentId": null, "paintOrder": 20, "occluded": false,
      "text": {
        "text": "87万", "fontSizePct": 0.0248, "color": "#FFFFFF", "fontWeight": 700, "align": "CENTER",
        "strokeColor": "#5C3A21", "strokeWidthPct": 0.0028
      }
    },
    … 23 more nodes …
  ]
}

संरचना

javascript
// JSON.parse(result.text)
{
  imageSize: { width, height },      // px of the analysed image
  nodes: [
    {
      id: "Lbg" | "A001" | "T001" | "<group id>",   // == asset name
      name: "join_room_card",                        // AI-given, may repeat
      kind: "background" | "group" | "ui" | "icon" | "text",
      box: [x, y, w, h],               // fractions 0..1 of imageSize
      parentId: null | "<group id>",
      paintOrder: -1 | 0 | 1 | ...,    // ascending = bottom → top (siblings)
      occluded: false,
      instances: [[x, y, w, h]],       // optional: repeated placements
      text: {                          // only when kind === "text"
        text, fontSizePct, color, fontWeight, italic, align,
        fontFamily, strokeColor, strokeWidthPct,
        shadow: { color, dxPct, dyPct, blurPct }
      }
    }
  ]
}

लेयरों का उपयोग

स्थिति और आकार अनुपात में हैं, इसलिए वही सूची किसी भी पिक्सेल आकार पर काम करती है।

  1. 1वह पिक्सेल आकार चुनें जिस पर आप काम करेंगे — imageSize विश्लेषण का आकार है और हर box उसी का अनुपात है।
  2. 2Lbg को सबसे नीचे रखें, पूरे क्षेत्र को ढकते हुए।
  3. 3बाकी को क्रम दें: parentId से समूह बनाएँ, फिर paintOrder के बढ़ते क्रम (पीछे से आगे) में लगाएँ।
  4. 4हर ui और icon के PNG को उसके box पर रखें, और instances की हर प्रविष्टि पर दोहराएँ; टेक्स्ट लेयरों के लिए text के अक्षर और शैली उपयोग करें।
Lbg imageSize से बड़ा आ सकता है — बराबर मान लेने के बजाय उसे स्केल करें।
टेक्स्ट छवि के बजाय अक्षर और शैली के रूप में आता है, इसलिए वह संपादन योग्य, अनुवाद योग्य और हर आकार पर स्पष्ट रहता है।

प्लेसमेंट सूची बनाना

javascript
const { result } = task;            // from polling, outputs or the webhook
const tree = JSON.parse(result.text);
const { width: W, height: H } = tree.imageSize;    // reference pixel size
const png = Object.fromEntries(result.assets.map((a) => [a.name, a.url]));

// 1) box fractions -> pixels, at whatever size you work at
const px = ([x, y, w, h]) => ({ x: x * W, y: y * H, width: w * W, height: h * H });

// 2) back -> front within each parent
const childrenOf = (parentId) =>
  tree.nodes
    .filter((n) => n.parentId === parentId)
    .sort((a, b) => a.paintOrder - b.paintOrder);

// 3) flatten into a placement list your app can consume
function collect(parentId = null, out = []) {
  for (const n of childrenOf(parentId)) {
    if (n.kind === "group") { collect(n.id, out); continue; }
    for (const box of [n.box, ...(n.instances ?? [])]) {
      out.push({
        id: n.id,
        name: n.name,                              // e.g. "join_room_card"
        kind: n.kind,                              // background | ui | icon | text
        ...px(box),                                // x, y, width, height in px
        order: n.paintOrder,
        image: n.kind === "text" ? null : png[n.id],
        text: n.text ?? null,                      // content + styling, text only
      });
    }
  }
  return out;
}

const layers = collect();                          // ready to place or import

बिलिंग

रिज़ॉल्यूशन श्रेणी

प्रति कॉल एक निश्चित मूल्य, जो स्रोत छवि की लंबी भुजा से तय होता है। राशि सबमिट पर estimatedCredits में लौटती है और पूर्ण होने पर काटी जाती है; विफल कार्य की पूरी वापसी होती है।

श्रेणीलंबी भुजाक्रेडिट
1K≤ 1024 px120
2K≤ 2048 px180
4K> 2048 px250
श्रेणी के मूल्य बदले जा सकते हैं, इसलिए उस कॉल की सटीक राशि के लिए सबमिट प्रतिक्रिया के estimatedCredits को ही मानें।

सीमाएँ

मानविवरण
2048 pxविश्लेषण से पहले स्रोत को 2048 px लंबी भुजा तक छोटा किया जाता है।
300प्रति छवि अधिकतम 300 तत्व पहचाने जाते हैं।
20 MBइनलाइन base64 मीडिया प्रति आइटम 20 MB तक सीमित है।
2–3 मिनटआरंभ से अंत तक सामान्य अवधि।
7 दिनकार्य रिकॉर्ड और फ़ाइलों की अवधारण अवधि।
~1 घंटाहस्ताक्षरित डाउनलोड URL की वैधता।

त्रुटियाँ

सबमिट की त्रुटियाँ तुरंत लौटती हैं; निष्पादन की त्रुटियाँ failed स्थिति वाले कार्य और error वस्तु के रूप में दिखती हैं।

StatusCodeअर्थ
400—अनुरोध का प्रारूप गलत है — अक्सर messages[] और referenceImage दोनों में कोई स्रोत छवि नहीं दी गई होती।
401INVALID_API_KEY · INVALID_ORG_API_KEYAPI कुंजी नहीं है या अमान्य है।
402INSUFFICIENT_CREDITS · INSUFFICIENT_ORG_CREDITSइस छवि की रिज़ॉल्यूशन श्रेणी के लिए पर्याप्त क्रेडिट नहीं हैं।
403API_SERVICE_NOT_ALLOWED · ORG_DISABLEDइस कुंजी या संगठन को यह सेवा कॉल करने की अनुमति नहीं है।
413—इनलाइन base64 छवि 20 MB की सीमा से बड़ी है — इसके बजाय https URL भेजें।
429RATE_LIMIT_MINUTE · RATE_LIMIT_DAY · CONCURRENCY_LIMIT_EXCEEDEDदर या समवर्तीता की सीमा पहुँच गई; थोड़ी प्रतीक्षा के बाद पुनः प्रयास करें।
failederror.codeकार्य शुरू होने के बाद निष्पादन विफल हुआ। error.code और error.message कारण बताते हैं, और आरक्षित क्रेडिट पूरी तरह लौटा दिए जाते हैं।

त्रुटि प्रतिक्रिया — HTTP 400

json
{
  "success": false,
  "message": "A reference image is required: provide it as an `image_url` part inside messages[].content[], or pass `referenceImage` directly.",
  "timestamp": "2026-09-06T18:30:27.398Z"
}

विफल कार्य (पोलिंग प्रतिक्रिया)

json
{
  "success": true,
  "data": {
    "taskId": "6a9db1431ef5f254006213e0",
    "serviceCode": "ai-layer-split",
    "status": "failed",
    "hasResult": false,
    "error": { "code": "EXECUTION_ERROR", "message": "Task processing failed" },
    "creditsEstimated": 150,
    "creditsActual": 0,
    "outputCount": 0
  }
}