Authentication in the API Translate
Written by
Updated at November 26, 2025
Translate's API interface requires you to submit your authentication credentials in each request. The authentication method depends on the type of account used to send your request:
Yandex or federated account
Service account
- Get an IAM token for a Yandex account, federated account, or local account. Make sure to include the folder ID in the
folderIdfield in the body of each request.
Provide the token in the Authorization header of each request in the following format:
```yaml
Authorization: Bearer <IAM_token>
```
- Get the ID of any folder for which your account has the
ai.translate.userrole or higher. Make sure to include the folder ID in thefolderIdfield in the body of each request.
-
Choose one of the authentication methods:
-
Get an IAM token. Provide the IAM token in the
Authorizationheader in the following format:Authorization: Bearer <IAM_token> -
Create an API key. Provide the API key in the
Authorizationheader in the following format:Authorization: Api-Key <API_key>
-
-
Assign the service account the
ai.translate.userrole or higher for the folder where it was created.Do not specify the folder ID in your requests, as the service uses the folder the service account was created in.