কুইকস্টার্ট
একটি API key তৈরি করুন, তারপর একটি ফাইল পাঠান। নতুন অ্যাকাউন্ট শুরুতেই 50টি ফ্রি ক্রেডিট পায়।
curl https://api.ocrrouter.ai/v1/ocr \
-H "Authorization: Bearer $OCRROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"file_url": "https://example.com/invoice.pdf",
"format": "markdown"
}'রিকোয়েস্ট
একটি JSON বডি এবং Authorization: Bearer হেডার সহ POST https://api.ocrrouter.ai/v1/ocr করুন।
| model | string | একটি মডেল আইডি যেমন mistral/mistral-ocr, অথবা auto। |
| file_url | string | PDF বা ছবির পাবলিক URL। file_url, file_base64 বা file_id-এর যেকোনো একটি ব্যবহার করুন। |
| file_base64 | string | base64 হিসেবে ফাইল, সর্বোচ্চ ২০ MB পর্যন্ত। |
| file_id | string | বড় ফাইলের ক্ষেত্রে POST /v1/files থেকে পাওয়া ID। |
| format | string | markdown (ডিফল্ট), json, text, html, csv, docx বা xlsx। |
| pages | string | পেজ রেঞ্জ, উদাহরণস্বরূপ 1-5,8। ডিফল্টভাবে সব পেজ। |
| fallbacks | string[] | প্রথম মডেলটি ফেইল করলে ক্রমানুসারে চেষ্টা করার জন্য মডেল আইডিগুলো। |
| route | string | auto মডেলের সাথে: quality (ডিফল্ট), cheapest বা fastest। |
| filename | string | ঐচ্ছিক নাম যা আপনার অ্যাক্টিভিটি লগে দেখানো হবে। |
অন্যান্য এন্ডপয়েন্ট:
GET /v1/modelsপ্রতিটি মডেলের তালিকা, এর মূল্য এবং এটি অ্যাভেইলএবল কি না তা দেখায়। কোনো কী প্রয়োজন নেই।POST /v1/filesএকটিfileফিল্ডসহ মাল্টিপার্ট আপলোড নেয় এবং একটিfile_idরিটার্ন করে যা ২৪ ঘণ্টার জন্য কার্যকর থাকে।GET /v1/requests/:idপূর্ববর্তী ফলাফল রিটার্ন করে। অন্য কোনো আউটপুট ফরম্যাটে পেতে?format=যোগ করুন।GET /v1/creditsআপনার ব্যালেন্স এবং এই কী-এর ব্যবহার রিটার্ন করে।POST /v1/keys/temporary50টি ক্রেডিটসহ একটি অস্থায়ী কী রিটার্ন করে। সাইন-আপের প্রয়োজন নেই, দিনে একটি।
আউটপুট ফরম্যাট
markdown
পুরো ডকুমেন্টটি Markdown হিসেবে। টেবিলগুলো GitHub-flavoured টেবিল, ফর্মুলাগুলো $...$ দিয়ে র্যাপ করা এবং পেজগুলো <!-- page:N --> দিয়ে আলাদা করা।
json
প্রতিটি মডেল থেকে একই স্ট্রাকচার: পেজগুলো, প্রতিটিতে টাইপড ব্লক। ব্লকের ধরনগুলো হলো heading, paragraph, list, table, formula, image, header এবং footer। মডেল যখন এগুলো প্রদান করে না, তখন bbox, confidence এবং পেজের সাইজ null থাকে, যা বর্তমানে সক্রিয় মডেলগুলোর ক্ষেত্রে প্রযোজ্য।
{"id": "req_8f2c1a41d0b3c7e9a2","model": "mistral/mistral-ocr","format": "json","attempts": [{ "model": "mistral/mistral-ocr", "ok": true, "ms": 1180 }],"pages": [{"index": 1,"width": null,"height": null,"blocks": [{"type": "heading","level": 1,"text": "Invoice INV-2041","bbox": null,"confidence": null},{"type": "paragraph","text": "Acme Supply Co.\n14 Harbour Street, Sydney NSW 2…","bbox": null,"confidence": null},{"type": "table","rows": [["Item", "Qty", "Unit price", "Amount"],["A4 paper, 5 reams", "4", "$24.00", "$96.00"]],"markdown": "| Item | Qty | Unit price | Amount |\n|---|---|-…","bbox": null,"confidence": null}]}],"usage": {"pages": 1,"credits": 25,"latency_ms": 1180,"cached": false}}text, html, csv, docx, xlsx
Markdown রেসপন্সের সাথে একটি output অবজেক্ট যা ফাইল ধারণ করে: format, filename, mime_type, encoding এবং data। text, html এবং csv হলো UTF-8 স্ট্রিং (encoding: "utf8"); docx এবং xlsx হলো base64 (encoding: "base64")। csv এবং xlsx টেবিলগুলো ধারণ করে (প্রতি টেবিলে একটি শিট), অথবা কোনো টেবিল না থাকলে টেক্সট লাইনগুলো। text-এর বিকল্প নাম হিসেবে txt-ও গ্রহণযোগ্য।
{"id": "req_8f2c1a41d0b3c7e9a2","model": "mistral/mistral-ocr","format": "docx","attempts": [{ "model": "mistral/mistral-ocr", "ok": true, "ms": 1180 }],"markdown": "<!-- page:1 -->\n# Invoice INV-2041\n…","pages": [{ "index": 1, "markdown": "# Invoice INV-2041\n…" }],"output": {"format": "docx","filename": "invoice.docx","mime_type": "application/vnd.openxmlformats-officedocument.w…","encoding": "base64","data": "UEsDBBQAAAAIA…"},"usage": {"pages": 1,"credits": 25,"latency_ms": 1180,"cached": false}}রাউটিং ও ফলব্যাক
model-কে auto সেট করুন এবং প্রতিটি ডকুমেন্টের জন্য আমরাই সেরা মডেল বেছে নেব। আপনার জন্য কী গুরুত্বপূর্ণ তা নির্ধারণ করতে route ব্যবহার করুন: cheapest, fastest বা quality।
সার্ভিস ডাউন থাকা অবস্থায় কাজ চালিয়ে যেতে fallbacks যোগ করুন। প্রথম মডেলটি এরর দিলে বা রেট-লিমিটেড হলে পরবর্তীটি রান করবে। রেসপন্সে কোন মডেলটি উত্তর দিয়েছে তা জানানো হয়, এবং আপনি কেবল সেটির জন্যই পে করবেন।
{"model": "mistral/mistral-ocr","fallbacks": ["google/gemini-flash", "tesseract/tesseract"],"file_url": "https://example.com/report.pdf"}ক্রেডিট
প্রতিটি পেজের জন্য মডেলগুলোর ক্রেডিট হিসেবে নির্দিষ্ট মূল্য রয়েছে। $১-এ 1,000 ক্রেডিট পাওয়া যায় এবং এগুলোর কোনো মেয়াদ শেষ হয় না। প্রতিটি রেসপন্সে usage.credits অন্তর্ভুক্ত থাকে।
- ব্যর্থ এবং খালি ফলাফলের জন্য কোনো চার্জ কাটা হয় না।
- একই ফাইল একই মডেলে পুনরায় পাঠালে ক্যাশ থেকে ফ্রিতে সার্ভিস দেওয়া হয়।
- প্রতিটি API key-এর নিজস্ব ক্রেডিট লিমিট থাকতে পারে।
এরর সমূহ
এজেন্ট, MCP এবং CLI
কোডিং এজেন্টরা সাইন-আপ ছাড়াই OCRRouter ব্যবহার করতে পারে। CLI এবং MCP সার্ভার প্রথম ব্যবহারের সময় 50 ক্রেডিটসহ একটি অস্থায়ী কী চেয়ে নেয় এবং তা ~/.ocrrouter/config.json-এ সেভ করে। আপনার নিজস্ব কী ব্যবহার করতে OCRROUTER_API_KEY সেট করুন।
# CLI
npx ocrrouter invoice.pdf --format markdown
# MCP server for Claude Code
claude mcp add ocrrouter -- npx ocrrouter mcpএই পেজের একটি মেশিন-রিডেবল সারাংশ /llms.txt-এ পাওয়া যাবে।