AI Agents

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

Для аутентификации в API:

Шаг 1. Создайте сервисный аккаунт

Вы можете создать сервисный аккаунт через личный кабинет.

На верхней панели слева нажмите и перейдите на вкладку Пользователи → Сервисные аккаунты.
В правом верхнем углу нажмите Создать сервисный аккаунт.
Задайте для сервисного аккаунта название и описание.
Назначьте доступы и роль. Роль определяет права доступа сервисного аккаунта. Чтобы аккаунт мог совершать какие-либо действия с ресурсами, рекомендуем выбирать роль «Администратор проекта».
Нажмите Создать.

Шаг 2. Сгенерируйте API-ключ

Для создания персонального API-ключа:

На верхней панели слева нажмите и перейдите на вкладку Пользователи → Сервисные аккаунты.
Нажмите на название сервисного аккаунта, который будете использовать для отправки запроса к модели.
Перейдите на вкладку API-ключи.
Нажмите Создать API-ключ.
Введите название и описание API-ключа, которое поможет в будущем идентифицировать его среди других ключей.
Заполните параметры API-ключа:
- Сервисы — ml_inference_ai_marketplace.
- Время действия — срок действия API-ключа и часовой пояс. Вы можете установить значение от одного дня до одного года с текущей даты. Если параметр не задан, срок действия ключа устанавливается на максимальное значение — один год. В целях безопасности рекомендуется выставлять средние значения, например 90 дней.
- Интервал работы ключа — один или несколько интервалов времени, в которые можно использовать API-ключ.
Нажмите Создать.
Сохраните Key Secret. После закрытия окна получить его будет нельзя.

Созданный API-ключ появится в списке ключей в статусе «Активен». Подробнее о работе с API-ключом.

Шаг 3. Получите токен

Получите токен с помощью curl-запроса:

curl --location 'https://iam.api.cloud.ru/api/v1/auth/token' \
   --header 'Content-Type: application/json' \
   --data '{
      "keyId": "<keyId>",
      "secret": "<secret>"
   }'
Где:

keyId — Key ID (логин) ключа доступа.

secret — Key Secret (пароль) ключа доступа.

Используйте токен при каждом API-запросе к сервису — передайте его в заголовке Authorization в формате:

Authorization: Bearer $TOKEN

Эта статья полезна?

Поддержка Юридические документы