Как создать API-ключ для работы в Yandex AI Studio

Yandex AI Studio является частью платформы Yandex Cloud и использует ее систему аутентификации и авторизации. Вы можете отправлять запросы к моделям AI Studio, Yandex Translate, Yandex Vision OCR или SpeechKit через API от имени своего пользовательского аккаунта, используя IAM-токен для аутентификации. Это наиболее безопасный способ для быстрых экспериментов, поскольку время жизни IAM-токена не превышает 12 часов.

Для работы с API мы рекомендуем использовать сервисный аккаунт с API-ключом.

Чтобы создать API-ключ:

  1. В интерфейсе AI Studio нажмите Создать API-ключ в правом верхнем углу.
  2. (Опционально) Измените описание API-ключа, чтобы вы легко могли найти его после.
  3. Выберите срок действия API-ключа.
  4. Нажмите кнопку Создать.
  5. Сохраните идентификатор и секретный ключ.

Внимание

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

Сервис автоматически создаст сервисный аккаунт с минимально необходимыми ролями и API-ключ для него с областью действия для работы со всеми компонентами и сервисами AI Studio.

Какие роли получит сервисный аккаунт

Созданный сервисный аккаунт имеет следующие роли:

Роль

Описание

ai.editor

Доступ к Yandex Translate, Yandex Vision OCR, Yandex SpeechKit и Yandex AI Studio

serverless.mcpGateways.invoker

Доступ к MCP-серверам, в том числе через MCP Hub

serverless.mcpGateways.anonymousInvoker

Доступ к внешним MCP-серверам

serverless.workflows.executor

Доступ к выполнению рабочих процессов Yandex Workflows

search-api.webSearch.user

Доступ к Yandex Search API с использованием API v2
Какую область действия получит API-ключ

Созданный API-ключ имеет следующие области действия:

Область действия

Описание

yc.ai.imageGeneration.execute

Доступ к генерации изображений

yc.ai.languageModels.execute

Доступ к генерации текста с помощью моделей Model Gallery

yc.ai.speechkitStt.execute

Доступ к распознаванию речи

yc.ai.speechkitTts.execute

Доступ к синтезу речи

yc.ai.translate.execute

Доступ к переводу текста

yc.ai.vision.execute

Доступ к анализу изображений

yc.search-api.execute

Доступ к Yandex Search API

yc.serverless.mcpGateways.invoke

Доступ к вызовам MCP-серверов

yc.serverless.containers.invoke

Доступ к вызову контейнеров

yc.serverless.functions.invoke

Доступ к вызову функций

Теперь вы можете отправлять запросы во все API сервисов AI Studio, используя созданный API-ключ.

Предыдущая
Вопросы и ответы
Следующая
Отключить логирование запросов