Authentication with the Yandex Vision OCR API

Get your account authentication details:

  1. Get an IAM token for your Yandex account, federated account, or local account.
  2. Get the ID of the folder for which your account has the ai.vision.user role or higher.
  3. When accessing Vision OCR via the API, provide these values in every request:
  • Specify the IAM token in the Authorization header.
  • Specify the folder ID in the x-folder-id header.
Authorization: Bearer <IAM_token>
        x-folder-id: <folder_ID>

Vision OCR supports two authentication methods using service accounts:

  • With an IAM token:

    1. Get an IAM token.

    2. Include the IAM token in the Authorization header in the following format:

      Authorization: Bearer <IAM_token>

  • With API keys.

    Use API keys if requesting an IAM token automatically is not an option.

    1. Get an API key.

    2. Include the API key in the Authorization header in the following format:

      Authorization: Api-Key <API_key>

Do not specify the folder ID in your requests, as the service automatically uses the folder where your service account was created.

See also

Previous
Base64 encoding
Next
Overview