Authentication with the Yandex Foundation Models API

Written by

Yandex Cloud

Updated at November 20, 2024

To use the Yandex Foundation Models API, you need to authenticate:

Yandex or federated account

Service account

Get an IAM token for your Yandex account or federated account.
Get the ID of the folder for which your account has the minimal required role to work with the model:
- ai.languageModels.user or higher: To work with YandexGPT API
- ai.imageGeneration.user or higher: To work with YandexART
You will need the folder ID to get the model's URI.
When accessing Foundation Models via the API, specify the IAM token in the Authorization header of each request:
```
Authorization: Bearer <IAM_token>
```

To access Foundation Models, your service account needs at least the minimal required role:

ai.languageModels.user or higher: To work with YandexGPT API
ai.imageGeneration.user or higher: To work with YandexART

The Foundation Models API supports two methods of authentication with a service account:

Using an IAM token:
1. Get an IAM token.
2. Specify the obtained 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. Specify the obtained API key in the Authorization header in the following format:
```
Authorization: Api-Key <API_key>
```

Do not specify the folder ID in request headers, as the service uses the folder in which the service account was created. However, you will need the parent folder ID to get the model's URI.

Authentication with the Yandex Foundation Models API

Was the article helpful?