Brzi početak
Izradite API ključ, a zatim pošaljite datoteku. Novi računi počinju s 50 besplatnih kredita.
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"
}'Zahtjev
POST https://api.ocrrouter.ai/v1/ocr uz JSON tijelo zahtjeva i zaglavlje Authorization: Bearer.
| model | string | ID modela kao što je mistral/mistral-ocr, ili auto. |
| file_url | string | Javni URL PDF-a ili slike. Upotrijebite jedno od: file_url, file_base64 ili file_id. |
| file_base64 | string | Datoteka u base64 formatu, do 20 MB. |
| file_id | string | ID koji vraća POST /v1/files, za veće datoteke. |
| format | string | markdown (zadano), json, text, html, csv, docx ili xlsx. |
| pages | string | Raspon stranica, npr. 1-5,8. Zadano su sve stranice. |
| fallbacks | string[] | ID-jevi modela koje treba isprobati redom ako prvi model zakaže. |
| route | string | Uz model auto: quality (zadano), cheapest ili fastest. |
| filename | string | Neobavezni naziv prikazan u vašem dnevniku aktivnosti. |
Ostale krajnje točke:
GET /v1/modelsprikazuje popis svih modela, njihove cijene i dostupnost. Ključ nije potreban.POST /v1/filesprima multipart prijenos s poljemfilei vraćafile_idkoji vrijedi 24 sata.GET /v1/requests/:idvraća raniji rezultat. Dodajte?format=s bilo kojim izlaznim formatom kako biste ga dobili u drugom obliku.GET /v1/creditsvraća stanje vašeg računa i potrošnju ovog ključa.POST /v1/keys/temporaryvraća privremeni ključ s 50 kredita. Bez registracije, jedan po danu.
Izlazni formati
markdown
Cijeli dokument u obliku Markdowna. Tablice su u GitHub formatu, formule su unutar $...$, a stranice su razdvojene s <!-- page:N -->.
json
Ista struktura za svaki model: stranice, svaka s tipiziranim blokovima. Tipovi blokova su heading, paragraph, list, table, formula, image, header i footer. Vrijednosti bbox, confidence i veličina stranice su null kada ih model ne pruža, što je slučaj s modelima koji su trenutno dostupni.
{"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 odgovor uz objekt output koji sadrži datoteku: format, filename, mime_type, encoding i data. text, html i csv su UTF-8 tekstualni nizovi (encoding: "utf8"); docx i xlsx su base64 (encoding: "base64"). csv i xlsx sadrže tablice (jedan list po tablici) ili retke teksta ako nema tablica. txt je prihvaćen kao alternativni naziv za text.
{"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}}Usmjeravanje i zamjenski modeli
Postavite model na auto i mi ćemo odabrati model za svaki dokument. Koristite route kako biste odredili kriterij: cheapest, fastest ili quality.
Dodajte fallbacks kako biste osigurali neprekidan rad tijekom ispada. Ako prvi model javi pogrešku ili dosegne ograničenje broja zahtjeva, pokreće se sljedeći. Odgovor navodi koji je model odgovorio i plaćate samo taj model.
{"model": "mistral/mistral-ocr","fallbacks": ["google/gemini-flash", "tesseract/tesseract"],"file_url": "https://example.com/report.pdf"}Krediti
Svaki model ima cijenu u kreditima po stranici. $1 donosi 1,000 kredita i oni nikada ne istječu. Svaki odgovor uključuje usage.credits.
- Neuspjeli i prazni rezultati se ne naplaćuju.
- Ponovno slanje iste datoteke istom modelu poslužuje se iz predmemorije besplatno.
- Svaki API ključ može imati vlastiti limit kredita.
Pogreške
Agenti, MCP i CLI
Agenti za programiranje mogu koristiti OCRRouter bez postupka registracije. CLI i MCP poslužitelj pri prvoj upotrebi traže privremeni ključ s 50 kredita i spremaju ga u ~/.ocrrouter/config.json. Postavite OCRROUTER_API_KEY za korištenje vlastitog ključa.
# CLI
npx ocrrouter invoice.pdf --format markdown
# MCP server for Claude Code
claude mcp add ocrrouter -- npx ocrrouter mcpStrojno čitljiv sažetak ove stranice dostupan je na /llms.txt.