Authentication with the Yandex Vision OCR API
Written by
Updated at November 26, 2025
Get your account data for authentication:
Yandex or federated account
Service account
- Get an IAM token for a Yandex account, federated account, or local account.
- Get the ID of the folder for which your account has the
ai.vision.userrole or higher. - When accessing Vision OCR via the API, provide the received parameters in each request:
- Specify the IAM token in the
Authorizationheader. - Specify the folder ID in the
x-folder-idheader.
Authorization: Bearer <IAM_token>
x-folder-id: <folder_ID>
Vision OCR supports two authentication methods based on service accounts:
-
With an IAM token:
-
Provide the IAM token in the
Authorizationheader in the following format:Authorization: Bearer <IAM_token>
-
With API keys.
Use API keys if requesting an IAM token automatically is not an option.
-
Provide the API key in the
Authorizationheader in the following format:Authorization: Api-Key <API_key>
Do not specify the folder ID in your requests, as the service uses the folder the service account was created in.