Связаться с намиПопробовать бесплатно

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

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

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

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

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

    • ai.languageModels.user или выше — для работы с моделями генерации текста..
    • ai.imageGeneration.user или выше — для работы с YandexART.
    • ai.assistants.editor и ai.languageModels.user или выше — для работы с Responses API.
    • ai.models.user или выше — для работы с Realtime API.
    • serverless.mcpGateways.editor или выше — чтобы управлять MCP-серверами.

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

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

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

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

  • ai.languageModels.user или выше — для работы с моделями генерации текста.
  • ai.imageGeneration.user или выше — для работы с YandexART.
  • ai.assistants.editor и ai.languageModels.user или выше — для работы с Responses API.
  • ai.models.user или выше — для работы с Realtime API.
  • serverless.mcpGateways.editor или выше — чтобы управлять MCP-серверами. API MCP Hub поддерживает только аутентификацию с IAM-токеном.

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

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

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

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

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

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

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

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

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

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

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

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