docs: correct OCR pricing to $4/1k and document the 4.1 alias

[r-uben]

Summary

The README advertised ~$1/1k pages, an OCR 3-era rate. The default model
mistral-ocr-latest is an alias for OCR 4.1, which is $4/1k ($2/1k batch) —
so the documented cost was understated 4x for every run made with the default,
and has been since the OCR 4 release.

Two places fixed: the cross-tool comparison table and the Pricing section.

Evidence

Alias target, from the models endpoint on a live key:

mistral-ocr-latest | aliases: ['mistral-ocr-4', 'mistral-ocr-4-1']
mistral-ocr-4-1    | aliases: ['mistral-ocr-latest', 'mistral-ocr-4']
mistral-ocr-4-0    | aliases: []

Rate confirmed against https://mistral.ai/pricing/api (OCR 4.1: $4 per 1000
pages; Document AI $5). OCR 4.0 and OCR 3 rates are no longer published there.

The Pricing section also now records a behaviour worth knowing: the OCR response
echoes back whichever model string it was sent rather than resolving the alias.

sent= mistral-ocr-latest -> response.model= mistral-ocr-latest
sent= mistral-ocr-4-1    -> response.model= mistral-ocr-4-1

So a run made with the alias records mistral-ocr-latest in metadata.json and
cannot be attributed to a point release afterwards. Users who need the exact
version pinned should pass --model mistral-ocr-4-1, which _run_fingerprint
already captures correctly.

Scope / non-goals

Documentation only — no code, no behaviour, no dependency change. Does not touch
#23 (OCR 4 blocks/confidence) or #24 (mistralai 2.x migration); this ships
independently of both.

Test plan

No code changed, so no test outcomes to report. Verified by inspection:

• grep -rn '\$1/1k|~\$1 per|products/pricing' README.md mistral_ocr/ returns
  nothing — no stale rate or stale pricing URL left anywhere.
• git diff --stat: README.md | 17 +++++++++++++++--, single file.
• The replacement pricing URL (mistral.ai/pricing/api) was fetched and is the
  page carrying the $4/1k figure; the old mistral.ai/products/pricing/ no
  longer lists OCR rates.

---

Summary by cubic

Corrects README pricing for Mistral OCR to $4/1k pages ($2/1k via Batch) and documents that mistral-ocr-latest aliases OCR 4.1. This fixes a 4x understatement from the prior OCR 3-era ~$1/1k figure and clarifies version pinning behavior.

• Updates the comparison table and Pricing section; switches pricing link to https://mistral.ai/pricing/api.
• Notes that responses echo the sent model string; runs using mistral-ocr-latest record that alias and cannot be attributed to a specific 4.x point release later.
• Action: pass --model mistral-ocr-4-1 to pin the exact version in metadata.json and the run fingerprint.
• Docs-only change; single file: README.md.

^{Written for commit 056b770. Summary will update on new commits.}

Summary by CodeRabbit

• Documentation
  • Updated Mistral OCR API pricing to approximately $4 per 1,000 pages and Batch API pricing to $2 per 1,000 pages.
  • Documented the mistral-ocr-latest OCR 4.1 alias and pricing differences from OCR 3.
  • Added details on model-version options and how selected models are recorded for metadata and resumed operations.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0308b1ef-5ec6-46de-8ff4-09c942919aba

📥 Commits

Reviewing files that changed from the base of the PR and between 45bc3f6 and 056b770.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Walkthrough

README.md updates Mistral OCR pricing, Batch API rates, OCR model aliases, OCR 3 pricing context, and explicit model-selection guidance for metadata and resume fingerprints.

Changes

Mistral OCR documentation

Layer / File(s)	Summary
Pricing and model-selection guidance README.md	The comparison table uses the updated $4 per 1,000-page rate. The pricing note adds the $2 Batch API rate, OCR 4.1 alias details, OCR 3 pricing context, and explicit model-selection guidance.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Mergeability Score: ⚪ Minimal · up to 056b7

This documentation-only change corrects the advertised OCR cost and explains alias/version attribution, reducing the chance of understated user cost estimates; no actionable merge-blocking risk remains after normal review.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main documentation changes: correcting OCR pricing and documenting the OCR 4.1 alias.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[qodo-code-review]

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Tip of the day

💡 Did you know, you can type 'qodo, fix this' on a finding and the fix lands right on your PR

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

[qodo-code-review]

PR Summary by Qodo

Docs: fix OCR pricing to $4/1k and clarify mistral-ocr-latest alias behavior

📝 Documentation 🕐 Less than 5 minutes

AI Description

• Correct README pricing from ~$1/1k to $4/1k pages (OCR 4.1 default).
• Document that mistral-ocr-latest aliases to OCR 4.1 and how to pin versions.
• Update the pricing link to the current Mistral pricing page.

High-Level Assessment

The following are alternative approaches to this PR:

1. Link-only pricing (avoid hard-coded numbers)

• ➕ Eliminates risk of stale price figures in docs
• ➕ Shorter README section, less to maintain
• ➖ Less immediately useful for users estimating cost
• ➖ Still doesn’t explain aliasing/pinning implications

2. Add a docs check that flags stale pricing strings

• ➕ Prevents regressions (e.g., reintroducing OCR 3-era pricing)
• ➕ Keeps explicit numbers while improving maintenance
• ➖ Requires CI/test wiring (out of scope for a docs-only PR)
• ➖ May be brittle if pricing language changes

Recommendation: Keep the explicit $4/1k figure and the alias/pinning explanation as implemented, since it directly addresses user cost estimation and reproducibility concerns. If pricing churn becomes frequent, consider the “link-only” approach or a lightweight CI grep/check to prevent known-stale values from returning.

Files changed (1) +15 / -2

Documentation (1) +15 / -2

README.mdUpdate OCR pricing and document 'mistral-ocr-latest' alias/pinning +15/-2

Update OCR pricing and document 'mistral-ocr-latest' alias/pinning

• Fixes the cross-tool comparison table to show $4/1k pages for Mistral OCR. Expands the Pricing section to explain that 'mistral-ocr-latest' aliases to OCR 4.1, that responses echo the input model string, and that users should pass an explicit model to pin versions; also updates the pricing URL to the current endpoint.

README.md

[cubic-dev-ai]

No issues found across 1 file

_{Re-trigger cubic}