раздел 02

Как начать

Чтобы дойти до первого запроса, нужно пройти путь от аккаунта до ключа. Логика такая: аккаунт в облаке, внутри него каталог, под каталог - сервисный аккаунт, ему - ключ. Этим ключом потом авторизуются запросы.

1
Завести аккаунт Yandex Cloud
Зарегистрируйтесь в Yandex Cloud и создайте облако. Оплата рублями, доступ из России без VPN.
2
Создать каталог (folder)
Внутри облака создаётся каталог - рабочее пространство для ресурсов. Запомните его идентификатор: он понадобится для обращения к моделям.
3
Создать сервисный аккаунт
Это технический пользователь, от имени которого код ходит в API. Выдайте ему роль для работы с генеративными моделями в нужном каталоге.
4
Получить API-ключ или IAM-токен
Для сервисного аккаунта создайте API-ключ (живёт долго, удобно для серверов) или используйте IAM-токен (короткоживущий, обновляется). Этим и авторизуете запросы.
5
Проверить в плейграунде
Откройте плейграунд в Yandex AI Studio, выберите модель, напишите запрос и убедитесь, что ответ приходит. Это самый быстрый способ убедиться, что доступ настроен.

Где взять ID каталога

Идентификатор каталога (folder id) виден в консоли Yandex Cloud на странице самого каталога. Он нужен почти везде: и для прав сервисного аккаунта, и для обращения к модели по API. Модель в запросе указывается строкой-URI, в которую входит этот идентификатор - подробнее в следующем разделе.

Ключ или токен: что выбрать

  • API-ключ - долгоживущий секрет сервисного аккаунта. Удобен для серверов и постоянных интеграций: положили в переменные окружения и используете.
  • IAM-токен - короткоживущий токен, который нужно периодически обновлять. Подходит, когда хочется не держать долгоживущий секрет.