Аутентификация в API Translate
Статья создана
Обновлена 5 ноября 2025 г.
Для работы с API Translate необходимо отправлять данные для аутентификации в каждом запросе. Способ аутентификации зависит от типа аккаунта, от имени которого вы будете отправлять запросы:
Аккаунт на Яндексе или федеративный аккаунт
Сервисный аккаунт
- Получите IAM-токен для аккаунта на Яндексе, федеративного или локального аккаунта. Идентификатор каталога должен передаваться в теле каждого запроса в поле
folderId.
Передавайте полученный токен в заголовке Authorization каждого запроса в формате:
```yaml
Authorization: Bearer <IAM-токен>
```
- Получите идентификатор любого каталога, на который у вашего аккаунта есть роль
ai.translate.userили выше. Идентификатор каталога должен передаваться в теле каждого запроса в полеfolderId.
-
Выберите один из способов аутентификации:
-
Получите IAM-токен. Передавайте IAM-токен в заголовке
Authorizationв формате:Authorization: Bearer <IAM-токен> -
Создайте API-ключ. Передайте API-ключ в заголовке
Authorizationв следующем формате:Authorization: Api-Key <API-ключ>
-
-
Назначьте сервисному аккаунту роль
ai.translate.userили выше на каталог, в котором он был создан.Не указывайте в запросах идентификатор каталога — сервис использует каталог, в котором был создан сервисный аккаунт.