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 ডিফল্ট ব্যবহার করতে বাদ দিন
`font`	না	string	ফন্ট স্টাইল; API ডিফল্ট ব্যবহার করতে বাদ দিন

প্যারামিটার	প্রয়োজনীয়	ধরন	বিবরণ
`Idempotency-Key`	হ্যাঁ	HTTP header	প্রস্তুতি অনুরোধের হেডার: ৮ ঘণ্টার মধ্যে একই ফাইল তালিকা নিরাপদে পুনরায় পাঠানোর স্থিতিশীল কী
`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 ডিফল্ট ব্যবহার করতে বাদ দিন
`font`	না	string	ফন্ট স্টাইল; API ডিফল্ট ব্যবহার করতে বাদ দিন

প্যারামিটার	প্রয়োজনীয়	ধরন	বিবরণ
`batch_id`	হ্যাঁ	string	টাস্কের অবস্থা জানতে ব্যবহৃত ব্যাচ আইডি

প্যারামিটার	প্রয়োজনীয়	ধরন	বিবরণ
কোনো প্যারামিটার নেই

রেসপন্স প্যারামিটার

Field	Type	Description
`task_id`	string	টাস্ক 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	টাস্ক 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	এই সমষ্টিগত API বিনামূল্যের ক্রেডিটের জন্য একক মেয়াদ দেয় না, তাই সর্বদা null

নমুনা প্রতিক্রিয়া (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)

কুকি পছন্দসমূহ