AI & ML

Image OCR (AI vision) API

GET/v1/image-ocr Paid10 credits / call

Authentication

Send your API key as a bearer token. Create one free in the dashboard.

Authorization: Bearer $TOOLSXPO_KEY

Parameters

Passed as query-string parameters. Example values shown.

Name	Example
imageUrl	https://example.com
prompt	Transcribe all text visible in this image, verbatim, preserving line breaks. Output only the text.

Example request

curl "https://api.toolsxpo.com/v1/image-ocr?imageUrl=https%3A%2F%2Fexample.com&prompt=Transcribe%20all%20text%20visible%20in%20this%20image%2C%20verbatim%2C%20preserving%20line%20breaks.%20Output%20only%20the%20text." \
  -H "Authorization: Bearer $TOOLSXPO_KEY"

Response

A standard JSON envelope: { ok, data, meta }. The result is in data (json); meta.credits reports what the call cost.

How to use the Image OCR API

Read text out of an image (imageUrl) using a Workers AI vision model. The transcription comes back in data.text.


Bash
curl "https://api.toolsxpo.com/v1/image-ocr?imageUrl=https://example.com/receipt.png" \
  -H "Authorization: Bearer $TOOLSXPO_KEY"

Important: this is AI transcription, not deterministic OCR

A vision model reads the image, so it handles messy layouts and handwriting far better than classic OCR — but it can miss or alter characters. Verify anything critical (amounts, IDs, codes) before you trust it.

Options

prompt — steer the model. The default asks for a verbatim transcription; override it to, say, "Extract only the total amount" or "Return the text as JSON".

Tips & gotchas

Use a clear, reasonably high-resolution image; tiny or blurry text hurts accuracy.
Images are capped at ~6 MB.
Paid tool (vision inference). Cost is per successful call.

Try it in the playground Open example URL