Аутентификация в API Yandex Vision OCR

Статья создана

Обновлена 1 ноября 2024 г.

Получите данные вашего аккаунта для аутентификации:

Аккаунт на Яндексе или федеративный аккаунт

Сервисный аккаунт

Получите IAM-токен для аккаунта на Яндексе или федеративного аккаунта.
Получите идентификатор каталога, на который у вашего аккаунта есть роль ai.vision.user или выше.
При обращении к Vision OCR через API в каждом запросе передавайте полученные параметры:
- Для Vision API и Classifier API:
  
  Указывайте IAM-токен в заголовке Authorization в следующем формате:
```
Authorization: Bearer <IAM-токен>
```
  Идентификатор каталога указывайте в теле запроса в параметре folderId.
- Для OCR API:
  - в заголовке Authorization указывайте IAM-токен;
  - в заголовке x-folder-id указывайте идентификатор каталога.
```
Authorization: Bearer <IAM-токен>
x-folder-id <идентификатор_каталога>
```

Vision OCR поддерживает два способа аутентификации с сервисным аккаунтом:

Не указывайте в запросах идентификатор каталога — сервис использует каталог, в котором был создан сервисный аккаунт.