OCR

Written by

Updated at August 4, 2026

View in Markdown

OCR.RecognizeText
OCR.ObjectStorage
OCR.Disk

Image-to-text recognition with Yandex Vision OCR.

The base64, url, objectStorage, and disk fields are mutually exclusive: you can use only one of them.

Field name	Type	Required	Default value	Templating supported	Description
`recognizeText`	OCR.RecognizeText	Yes	No	No	Text recognition settings.
`base64`	`string`	No	No	Yes	Base64-encoded image.
`url`	`string`	No	No	Yes	Image via a public URL.
`objectStorage`	OCR.ObjectStorage	No	No	No	Image from an Object Storage bucket.
`disk`	OCR.Disk	No	No	No	Image on Yandex Disk.

OCR.RecognizeText

Field name	Type	This is a required field	Default value	Templating supported	Description
`mimeType`	`string`	Yes	No	No	Image file format. Available formats: `pdf`, `jpeg`, `png`.
`languageCodes`	`string[]`	Yes	No	No	Text recognition languages. Available languages `ru`: Russian `en`: English `ar`: Arabic `az`: Azerbaijani `ba`: Bashkir `be`: Belarusian `bg`: Bulgarian `bs`: Bosnian `cs`: Czech `da`: Danish `de`: German `el`: Greek `es`: Spanish `et`: Estonian `fi`: Finnish `fr`: French `he`: Hebrew `hu`: Hungarian `hy`: Armenian `id`: Indonesian `it`: Italian `ja`: Japanese `ka`: Georgian `kk`: Kazakh `ko`: Korean `ky`: Kirghiz `lt`: Lithuanian `lv`: Latvian `mt`: Maltese `nl`: Dutch `no`: Norwegian `pl`: Polish `pt`: Portuguese `ro`: Romanian `sk`: Slovak `sl`: Slovenian `sv`: Swedish `tg`: Tajik `th`: Thai `tr`: Turkish `tt`: Tatar `uk`: Ukrainian `uz`: Uzbek `vi`: Vietnamese `zh`: Chinese
`model`	`string`	Yes	No	No	Text recognition model. Available models `page`: Text recognition on page. `page-column-sort`: Column-sorted text recognition. `passport`: Russian Federation passport. `driver-license-front`: Driver's license, front side. `driver-license-back`: Driver's license, back side. `license-plates`: Car license plates. `vehicle-registration-front`: Vehicle registration certificate (VRC), front side. `vehicle-registration-back`: Vehicle registration certificate (VRC), back side. `handwritten`: Handwritten text. `table`: Table. `markdown`: Markdown markup. `math-markdown`: Markdown markup with formulas.

OCR.ObjectStorage

Field name	Type	Required	Default value	Templating supported	Description
`bucket`	`string`	Yes	No	No	Name of the Object Storage bucket the image file is in.
`object`	`string`	Yes	No	Yes	Object name, e.g., `prefix/subprefix/data.png`.

OCR.Disk

Field name	Type	Required	Default value	Templating supported	Description
`oauthToken`	`string`	Yes	No	No	OAuth token for authentication when accessing Yandex Disk.
`path`	`string`	Yes	No	Yes	Image file path.
`sharedDiskId`	`string`	No	No	Yes	Shared disk label.

Was the article helpful?

Previous

Next