Plain text extraction (reading-order text + optional block boxes)

post/ocr/text

Request

  • Base URL: https://api.space-ocr.com
  • URL: https://api.space-ocr.com/ocr/text
  • Auth: HTTP bearer

Request body

imagestring required

base64 or URL of the image. The JSON body caps at 28MB; base64 inflates a file by ≈1.33×, so that is roughly a 20MB original image. Over the cap returns 413 with details.limitBytes / details.receivedBytes.

imageType'base64' | 'url'

Type of image — "base64" or "url". Required (also accepted via the deprecated alias image_type).

image_type'base64' | 'url'

Deprecated alias of imageType.

languageHintsstring[]

BCP-47-ish OCR language hints, e.g. ["ja","en"]. Defaults to ja/ko/en.

language_hintsstring[]

Deprecated alias of languageHints.

useLlmboolean

Default true — the model reads the image and puts the blocks in true reading order, rejoining wrapped lines. Set false for a raw OCR-order transcription.

use_llmboolean

Deprecated alias of useLlm.

includeBlocksboolean

When true the response also carries blocks — per-block text with bbox/vertices and a text_verified flag.

include_blocksboolean

Deprecated alias of includeBlocks.

promptstring

Custom transcription prompt prefix (optional).

Example request

{
  "imageType": "url",
  "image_type": "url"
}

Response

OK

statusstring required
messagestring

Example response

{
  "status": "success"
}

Changes

No recorded changes to this operation across all 1 revision of this API.