Аутентификация в API Yandex Vision OCR
Статья создана
Обновлена 16 июля 2025 г.
Получите данные вашего аккаунта для аутентификации:
Аккаунт на Яндексе или федеративный аккаунт
Сервисный аккаунт
- Получите IAM-токен для аккаунта на Яндексе или федеративного аккаунта.
- Получите идентификатор каталога, на который у вашего аккаунта есть роль
ai.vision.userили выше. - При обращении к Vision OCR через API в каждом запросе передавайте полученные параметры:
- в заголовке
Authorizationуказывайте IAM-токен; - в заголовке
x-folder-idуказывайте идентификатор каталога.
Authorization: Bearer <IAM-токен>
x-folder-id: <идентификатор_каталога>
Vision OCR поддерживает два способа аутентификации с сервисным аккаунтом:
-
С помощью IAM-токена:
-
Полученный IAM-токен передавайте в заголовке
Authorizationв следующем формате:Authorization: Bearer <IAM-токен>
-
С помощью API-ключей.
Используйте API-ключи, если у вас нет возможности автоматически запрашивать IAM-токен.
-
Полученный API-ключ передавайте в заголовке
Authorizationв следующем формате:Authorization: Api-Key <API-ключ>
Не указывайте в запросах идентификатор каталога — сервис использует каталог, в котором был создан сервисный аккаунт.