Связаться с намиПодключиться

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

Статья создана
Обновлена 7 марта 2025 г.

Для работы с API Yandex Foundation Models необходимо выполнить аутентификацию:

  1. Получите IAM-токен для аккаунта на Яндексе или федеративного аккаунта.

  2. Получите идентификатор каталога, на который у вашего аккаунта есть хотя бы минимальная роль для работы с нужной моделью:

    • ai.languageModels.user или выше — для работы с моделями генерации текста..
    • ai.imageGeneration.user или выше — для работы с YandexART.
    • ai.assistants.editor и ai.languageModels.user или выше — для работы с AI Assistant API.

    Идентификатор каталога понадобится, чтобы получить URI модели.

  3. При обращении к Foundation Models через API в заголовке Authorization каждого запроса указывайте IAM-токен:

    Authorization: Bearer <IAM-токен>

Для работы с моделями Foundation Models сервисный аккаунт должен иметь хотя бы минимальную соответствующую роль:

  • ai.languageModels.user или выше — для работы с моделями генерации текста.
  • ai.imageGeneration.user или выше — для работы с YandexART.
  • ai.assistants.editor и ai.languageModels.user или выше — для работы с AI Assistant API.

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

  • С помощью IAM-токена:

    1. Получите IAM-токен.

    2. Полученный IAM-токен передавайте в заголовке Authorization в следующем формате:

      Authorization: Bearer <IAM-токен>

  • С помощью API-ключей.

    Используйте API-ключи, если у вас нет возможности автоматически запрашивать IAM-токен.

    1. Получите API-ключ.

    2. Полученный API-ключ передавайте в заголовке Authorization в следующем формате:

      Authorization: Api-Key <API-ключ>

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

Предыдущая
Обзор
Следующая
Overview