API उदाहरण

संस्करण

API

API का उपयोग शुरू करें

API कुंजी बनाएँ

साइन इन करके डैशबोर्ड में कुंजी बनाएँ और खाते में उपलब्ध क्रेडिट जाँचें।
अपलोड करके सबमिट करें

V2: अपलोड URL प्राप्त करें, फ़ाइलें अपलोड करें और फिर अनुवाद कार्य सबमिट करें।
कार्य की स्थिति जाँचें

चित्रों की प्रोसेसिंग समाप्त होने तक मिले हुए batch_id से प्रगति जाँचें।
अनुवादित चित्र डाउनलोड करें

सफलतापूर्वक प्रोसेस हुए चित्रों के लिए मिले अनुवादित चित्र URL का उपयोग करें।

उदाहरण इनपुट

API कुंजी

स्रोत भाषा

लक्ष्य भाषा

मॉडल

अनुवादक

फ़ॉन्ट

Python 3 · pip install requests

कोड उदाहरण बनाने और बदलने के लिए JavaScript सक्षम करें। नीचे दिया API संदर्भ पढ़ने के लिए उपलब्ध है।

रूट

POST PUT POST

/api/v2/api/translate/uploads
R2 target
/api/v2/api/translate

पैरामीटर

पैरामीटर	आवश्यक	प्रकार	विवरण
`image`	हाँ	file[]	एक या अधिक छवि फ़ाइलें, या एक ZIP संग्रह
`source_language`	नहीं	string	वैकल्पिक; manga मॉडल चुनने पर आवश्यक (जैसे ja)
`target_language`	हाँ	string	लक्ष्य भाषा कोड (जैसे en)
`model`	नहीं	string	पहचान मॉडल; API डिफ़ॉल्ट उपयोग करने के लिए छोड़ दें
`translator`	नहीं	string	पाठ अनुवादक; इसे छोड़ने या auto रखने पर चुने गए मॉडल का डिफ़ॉल्ट अनुवादक उपयोग होता है। V2: केवल अंतिम अनुरोध में भेजें।
`font`	नहीं	string	फ़ॉन्ट शैली; API डिफ़ॉल्ट उपयोग करने के लिए छोड़ दें
`context`	नहीं	string	वैकल्पिक कहानी की पृष्ठभूमि और पसंदीदा नाम (अधिकतम 10,000 अक्षर)। सामान्य अनुवाद के लिए खाली छोड़ें। V2 में केवल अंतिम अनुवाद अनुरोध में भेजें।
`custom_prompt`	नहीं	string	डिफ़ॉल्ट अनुवाद निर्देशों के लिए खाली छोड़ें। चुनी गई भाषा और आउटपुट प्रारूप लागू रहेंगे। Ultra इसे मॉडल को अतिरिक्त निर्देशों के रूप में भेजता है। (1,000)

पैरामीटर	आवश्यक	प्रकार	विवरण
`Idempotency-Key`	हाँ	HTTP header	तैयारी अनुरोध हेडर: 8 घंटे तक उसी फ़ाइल सूची को सुरक्षित रूप से दोबारा भेजने के लिए स्थिर कुंजी
`files[]`	हाँ	array<object>	तैयारी अनुरोध: filename, content_type, size और content_sha256 वाली फ़ाइल मेटाडेटा
`upload_id`	हाँ	string	अंतिम अनुरोध: तैयारी चरण से मिला अपारदर्शी अपलोड बैच आईडी
`files[].index files[].upload_intent`	हाँ	integer string	अंतिम अनुरोध: तैयारी चरण से मिले प्रत्येक फ़ाइल के index और अपारदर्शी upload_intent; हर R2 अपलोड पूरा होने के बाद ही भेजें
`source_language`	नहीं	string	वैकल्पिक; manga मॉडल चुनने पर आवश्यक (जैसे ja)
`target_language`	हाँ	string	लक्ष्य भाषा कोड (जैसे en)
`model`	नहीं	string	पहचान मॉडल; API डिफ़ॉल्ट उपयोग करने के लिए छोड़ दें
`translator`	नहीं	string	पाठ अनुवादक; इसे छोड़ने या auto रखने पर चुने गए मॉडल का डिफ़ॉल्ट अनुवादक उपयोग होता है। V2: केवल अंतिम अनुरोध में भेजें।
`font`	नहीं	string	फ़ॉन्ट शैली; API डिफ़ॉल्ट उपयोग करने के लिए छोड़ दें
`context`	नहीं	string	वैकल्पिक कहानी की पृष्ठभूमि और पसंदीदा नाम (अधिकतम 10,000 अक्षर)। सामान्य अनुवाद के लिए खाली छोड़ें। V2 में केवल अंतिम अनुवाद अनुरोध में भेजें।
`custom_prompt`	नहीं	string	डिफ़ॉल्ट अनुवाद निर्देशों के लिए खाली छोड़ें। चुनी गई भाषा और आउटपुट प्रारूप लागू रहेंगे। Ultra इसे मॉडल को अतिरिक्त निर्देशों के रूप में भेजता है। (1,000)

पैरामीटर	आवश्यक	प्रकार	विवरण
`batch_id`	हाँ	string	कार्य की स्थिति पूछने के लिए बैच पहचानकर्ता

पैरामीटर	आवश्यक	प्रकार	विवरण
कोई पैरामीटर नहीं

प्रतिक्रिया पैरामीटर

Field	Type	Description
`task_id`	string	Task identifier
`batch_id`	string	कार्य की स्थिति पूछने के लिए बैच पहचानकर्ता

Field	Type	Description
`status`	integer	एप्लिकेशन स्थिति कोड; सफलता पर 200
`cost_ms`	integer	इस API अनुरोध को संसाधित करने में लगा समय, मिलीसेकंड में
`request_id`	string	इस API कॉल को ट्रैक करने का अनुरोध पहचानकर्ता
`data`	object	अनुरोध स्वीकार होने के बाद लौटाए गए अनुवाद कार्य पहचानकर्ता
`message`	string	सफल API प्रतिक्रिया में हमेशा success; इसका अर्थ अनुवाद कार्य पूर्ण होना नहीं है
`data.task_id`	string	Task identifier
`data.batch_id`	string	कार्य की स्थिति पूछने के लिए बैच पहचानकर्ता

Field	Type	Description
`status_code`	integer	सफल Task Status प्रतिक्रिया के लिए हमेशा 200
`request_id`	string	इस API कॉल को ट्रैक करने का अनुरोध पहचानकर्ता
`auth_type`	string	PAT से प्रमाणित Task Status अनुरोध के लिए हमेशा account
`task_reference`	string	अनुरोध पथ का batch_id, बिना बदलाव लौटाया जाता है
`data`	object	प्रति-चित्र परिणामों और कार्य की समग्र स्थिति का कंटेनर
`data.items`	array<object>	प्रति-चित्र कार्य परिणामों की सूची
`data.items[].image_id`	string	चित्र परिणाम का स्थिर पहचानकर्ता
`data.items[].index`	integer	बैच में चित्र की शून्य-आधारित स्थिति
`data.items[].filename`	string	मूल चित्र फ़ाइल का नाम
`data.items[].status`	string	चित्र परिणाम की स्थिति (pending \| processing \| completed \| failed \| canceled)
`data.items[].original_url`	string	स्रोत चित्र का URL; वर्तमान API से बनाए गए कार्यों में यह उपलब्ध रहता है।
`data.items[].translated_url`	string	अनुवादित चित्र का URL; परिणाम उपलब्ध होने तक यह खाली स्ट्रिंग रहता है, जिसमें लंबित, प्रसंस्करणाधीन या विफल चित्र शामिल हैं।
`data.items[].is_translated`	boolean	पूर्ण अनुवादित चित्र URL उपलब्ध होने पर ही true
`data.items[].output_file_path`	string	translated_url का संगत उपनाम; अनुवादित चित्र उपलब्ध न होने पर खाली स्ट्रिंग।
`data.items[].message`	string \| null	वैकल्पिक info message
`data.items[].error`	string \| null	चित्र कार्य विफल होने पर त्रुटि का विवरण; अन्यथा null
`data.items[].inpaint_image_url`	string \| null	मिटाए गए टेक्स्ट वाले चित्र का URL, या चयनित मॉडल अथवा निष्पादन पथ इसे न बनाए तो null।
`data.items[].block_json`	array<object>	V1 में रखे गए संरचित टेक्स्ट ब्लॉक; मॉडल या पथ ब्लॉक मेटाडेटा न लौटाए तो यह खाली ऐरे हो सकता है।
`data.task_status`	string	कार्य की समग्र स्थिति (pending \| processing \| completed \| failed \| canceled)

Field	Type	Description
`status`	integer	एप्लिकेशन स्थिति कोड; सफलता पर 200
`cost_ms`	integer	मिलीसेकंड में कार्य का बीता समय; मान्य समयचिह्न न होने पर 0
`request_id`	string	इस API कॉल को ट्रैक करने का अनुरोध पहचानकर्ता
`data`	array<object>	प्रति-चित्र संक्षिप्त परिणामों की सूची
`message`	string	सफल API प्रतिक्रिया में हमेशा success; इसका अर्थ अनुवाद कार्य पूर्ण होना नहीं है
`data[].image_id`	string	चित्र परिणाम का स्थिर पहचानकर्ता
`data[].filename`	string	मूल चित्र फ़ाइल का नाम
`data[].status`	string	चित्र परिणाम की स्थिति (pending \| processing \| completed \| failed \| canceled)
`data[].original_url`	string	स्रोत चित्र का URL; वर्तमान API से बनाए गए कार्यों में यह उपलब्ध रहता है।
`data[].translated_url`	string	अनुवादित चित्र का URL; परिणाम उपलब्ध होने तक यह खाली स्ट्रिंग रहता है, जिसमें लंबित, प्रसंस्करणाधीन या विफल चित्र शामिल हैं।
`data[].erased_url`	string	मिटाए गए टेक्स्ट वाले चित्र का URL; यह खाली स्ट्रिंग हो सकता है। Manga के Auto तैयार-चित्र पथ जैसे केवल तैयार चित्र लौटाने वाले मॉडल या पथ इसे नहीं बनाते।
`data[].blocks`	array<object>	संरचित अनुवादित टेक्स्ट ब्लॉक; Manga के Auto तैयार-चित्र पथ जैसे मॉडल या पथ ब्लॉक मेटाडेटा न लौटाएँ तो यह खाली ऐरे हो सकता है।
`data[].blocks[].angle`	number	टेक्स्ट ब्लॉक का घुमाव कोण
`data[].blocks[].color`	string	अनुवादित टेक्स्ट के लिए उपयोग किया गया हेक्स रंग
`data[].blocks[].handwritten`	boolean	क्या स्रोत टेक्स्ट हस्तलिखित के रूप में पहचाना गया
`data[].blocks[].location`	object	टेक्स्ट ब्लॉक की चार-कोणीय सीमाएँ
`data[].blocks[].location.left_bottom`	array<number>	बताए गए कोने का निर्देशांक युग्म
`data[].blocks[].location.right_bottom`	array<number>	बताए गए कोने का निर्देशांक युग्म
`data[].blocks[].location.left_top`	array<number>	बताए गए कोने का निर्देशांक युग्म
`data[].blocks[].location.right_top`	array<number>	बताए गए कोने का निर्देशांक युग्म
`data[].blocks[].text`	string	ब्लॉक में रेंडर किया गया अनुवादित टेक्स्ट
`data[].blocks[].direction`	string	अनुवादित टेक्स्ट की लेखन दिशा

Field	Type	Description
`subscription_credits`	integer	बताई गई श्रेणी का क्रेडिट बैलेंस
`subscription_credits_expires_at`	string \| null	सदस्यता क्रेडिट की समाप्ति का समय ISO 8601 प्रारूप में, या null
`one_time_credits`	integer	बताई गई श्रेणी का क्रेडिट बैलेंस
`one_time_credits_expires_at`	string \| null	एकमुश्त क्रेडिट की समाप्ति का समय ISO 8601 प्रारूप में, या null
`free_credits`	integer	बताई गई श्रेणी का क्रेडिट बैलेंस
`total_credits`	integer	सभी उपलब्ध क्रेडिट बैलेंस का योग
`is_temporary`	boolean	क्या बैलेंस किसी अस्थायी खाते का है

Field	Type	Description
`status`	integer	एप्लिकेशन स्थिति कोड; सफलता पर 200
`cost_ms`	integer	इस API अनुरोध को संसाधित करने में लगा समय, मिलीसेकंड में
`request_id`	string	इस API कॉल को ट्रैक करने का अनुरोध पहचानकर्ता
`data`	object	वर्तमान क्रेडिट शेष का कंटेनर
`message`	string	सफल API प्रतिक्रिया में हमेशा success; इसका अर्थ अनुवाद कार्य पूर्ण होना नहीं है
`data.total_credits`	integer	सभी उपलब्ध क्रेडिट बैलेंस का योग
`data.is_temporary`	boolean	क्या बैलेंस किसी अस्थायी खाते का है
`data.detail`	object	श्रेणी के अनुसार उपलब्ध क्रेडिट का विवरण
`data.detail.subscription`	object	निर्दिष्ट श्रेणी का क्रेडिट शेष और समाप्ति समय
`data.detail.subscription.credits`	integer	बताई गई श्रेणी का क्रेडिट बैलेंस
`data.detail.subscription.expires_at`	string \| null	क्रेडिट समाप्ति समय ISO 8601 प्रारूप में, या null
`data.detail.one_time`	object	निर्दिष्ट श्रेणी का क्रेडिट शेष और समाप्ति समय
`data.detail.one_time.credits`	integer	बताई गई श्रेणी का क्रेडिट बैलेंस
`data.detail.one_time.expires_at`	string \| null	क्रेडिट समाप्ति समय ISO 8601 प्रारूप में, या null
`data.detail.free`	object	निर्दिष्ट श्रेणी का क्रेडिट शेष और समाप्ति समय
`data.detail.free.credits`	integer	बताई गई श्रेणी का क्रेडिट बैलेंस
`data.detail.free.expires_at`	null	हमेशा null, क्योंकि यह समेकित API मुफ़्त क्रेडिट के लिए एकल समाप्ति समय नहीं देता

नमूना प्रतिक्रिया (JSON)

{
  "task_id": "00000000-0000-4000-8000-000000000001",
  "batch_id": "00000000-0000-4000-8000-000000000001"
}

नमूना प्रतिक्रिया (JSON)

{
  "status": 200,
  "cost_ms": 125,
  "request_id": "4b7370383cacccc7",
  "data": {
    "task_id": "00000000-0000-4000-8000-000000000001",
    "batch_id": "00000000-0000-4000-8000-000000000001"
  },
  "message": "success"
}

नमूना प्रतिक्रिया (JSON)

{
  "status_code": 200,
  "request_id": "4b7370383cacccc7",
  "auth_type": "account",
  "task_reference": "00000000-0000-4000-8000-000000000001",
  "data": {
    "items": [
      {
        "image_id": "00000000-0000-4000-8000-000000000001_0",
        "index": 0,
        "filename": "007.jpg",
        "status": "completed",
        "original_url": "https://storage.example.com/manga-demo/input/00000000-0000-4000-8000-000000000001/007.jpg",
        "translated_url": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007.jpg",
        "is_translated": true,
        "output_file_path": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007.jpg",
        "message": "ok",
        "error": null,
        "inpaint_image_url": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007-erased.jpg",
        "block_json": []
      }
    ],
    "task_status": "completed"
  }
}

नमूना प्रतिक्रिया (JSON)

{
  "status": 200,
  "cost_ms": 5300,
  "request_id": "4b7370383cacccc7",
  "data": [
    {
      "image_id": "00000000-0000-4000-8000-000000000001_0",
      "filename": "007.jpg",
      "status": "completed",
      "original_url": "https://storage.example.com/manga-demo/input/00000000-0000-4000-8000-000000000001/007.jpg",
      "translated_url": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007.jpg",
      "erased_url": "https://storage.example.com/manga-demo/output/00000000-0000-4000-8000-000000000001/007-erased.jpg",
      "blocks": [
        {
          "angle": 0,
          "color": "#484848",
          "handwritten": false,
          "location": {
            "left_bottom": [1685, 293],
            "right_bottom": [1786, 293],
            "left_top": [1685, 264],
            "right_top": [1786, 264]
          },
          "text": "OOOUGH!",
          "direction": "horizontal"
        }
      ]
    }
  ],
  "message": "success"
}

नमूना प्रतिक्रिया (JSON)

{
  "subscription_credits": 0,
  "subscription_credits_expires_at": null,
  "one_time_credits": 0,
  "one_time_credits_expires_at": null,
  "free_credits": 10,
  "total_credits": 10,
  "is_temporary": true
}

नमूना प्रतिक्रिया (JSON)

{
  "status": 200,
  "cost_ms": 4,
  "request_id": "4b7370383cacccc7",
  "data": {
    "total_credits": 10,
    "is_temporary": true,
    "detail": {
      "subscription": {
        "credits": 0,
        "expires_at": null
      },
      "one_time": {
        "credits": 0,
        "expires_at": null
      },
      "free": {
        "credits": 10,
        "expires_at": null
      }
    }
  },
  "message": "success"
}

त्रुटि प्रतिक्रिया पैरामीटर

V2 में विफलता होने पर HTTP स्थिति बनाए रखी जाती है और वही पाँच-फ़ील्ड एनवेलप लौटाया जाता है।

Field	Type	Description
`status`	integer	वास्तविक HTTP त्रुटि स्थिति कोड
`cost_ms`	integer	इस API अनुरोध को संसाधित करने में लगा समय, मिलीसेकंड में
`request_id`	string	इस API कॉल को ट्रैक करने का अनुरोध पहचानकर्ता
`data`	object	केवल स्थिर मशीन-पठनीय कोड वाला त्रुटि-डेटा कंटेनर
`message`	string	सार्वजनिक त्रुटि संदेश; आंतरिक निदान विवरण प्रकट नहीं किए जाते
`data.code`	string	स्थिर मशीन-पठनीय त्रुटि कोड

त्रुटि प्रतिक्रिया उदाहरण (JSON)

{
  "status": 400,
  "cost_ms": 1,
  "request_id": "4b7370383cacccc7",
  "data": {
    "code": "PZ_API_ACCESS_BAD_REQUEST"
  },
  "message": "Invalid target language"
}

API का उपयोग शुरू करें

API कुंजी बनाएँ

अपलोड करके सबमिट करें

कार्य की स्थिति जाँचें

अनुवादित चित्र डाउनलोड करें

उदाहरण इनपुट

रूट

पैरामीटर

प्रतिक्रिया पैरामीटर

नमूना प्रतिक्रिया (JSON)

नमूना प्रतिक्रिया (JSON)

नमूना प्रतिक्रिया (JSON)

नमूना प्रतिक्रिया (JSON)

नमूना प्रतिक्रिया (JSON)

नमूना प्रतिक्रिया (JSON)

त्रुटि प्रतिक्रिया पैरामीटर

त्रुटि प्रतिक्रिया उदाहरण (JSON)

कुकी प्राथमिकताएं