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

Добавить расширение x-yc-apigateway-integration:http для интеграции с API генерации текста Yandex AI Studio

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

  1. В консоли управления выберите каталог, в котором создали или хотите создать API-шлюз.

  2. Перейдите в сервис API Gateway.

  3. Выберите API-шлюз или нажмите кнопку Создать API-шлюз, чтобы создать новый.

  4. В поле Спецификация нажмите значок .

  5. Укажите в поле:

    • Путь — относительный путь к интеграции, который будет добавлен к URL-адресу API Gateway. Переменные указывайте в фигурных скобках, например /static/{function_id}. Подробнее см. спецификацию OpenAPI 3.0.
    • HTTP-метод — метод, который будет использоваться для взаимодействия с интеграцией.
    • Сервисный аккаунт — сервисный аккаунт для авторизации при обращении к API генерации текста. Если у вас нет сервисного аккаунта, создайте его.

  6. В блоке Используемая модель выберите модель и укажите:

    • Для модели YandexGPT — идентификатор каталога, который будет указан в URI модели генерации текста.
    • Для модели DataSphere — идентификатор модели, дообученной в Yandex DataSphere.

  7. В блоке Способ передачи промта выберите источник промпта и укажите:

    • Для источника Query-параметр — имя query-параметра, в котором будет передаваться промпт для запроса к API генерации текста.
    • Для источника Тело запроса — имя поля тела запроса, в котором будет передаваться промпт для запроса к API генерации текста.

  8. В блоке Сценарий использования выберите сценарий использования модели и задайте параметры, соответствующие выбранному сценарию:

    • Генерация текста:

      • (Опционально) Температура — определяет вариативность ответа модели: укажите значение от 0 до 1. Чем выше температура, тем более креативными и случайными будут ответы модели. Значение по умолчанию — 0.3.
      • (Опционально) Количество токенов — максимальное число токенов генерации. По умолчанию 5. Позволяет при необходимости ограничить объем ответа модели.

    • Классификация текста:

      • Описание задания — текстовое описание задания для классификатора.

      • Классы — список классов, к которым может относиться текст. Чтобы добавить класс, нажмите значок .

        Чтобы получить корректные результаты, используйте осмысленные названия классов.

      • (Опционально) Примеры запросов — примеры текстовых запросов для классов в формате текстовый запрос:класс. Чтобы добавить пример, нажмите значок . Подробнее см. в разделе Классификатор Few-shot.

  9. Нажмите кнопку Добавить.

В поле Спецификация отобразится OpenAPI-спецификация с указанными значениями параметров.

Требования к структуре входящего запроса

Чтобы API-шлюз корректно обрабатывал входящие запросы, для них должно быть задано значение заголовка Content-Type: application/json. Кроме этого:

  • Если в качестве способа передачи промпта выбрана опция Query-параметр, запрос должен содержать заданный в блоке Способ передачи промта query-параметр и его значение.

    Пример пути для вызова API-шлюза: <путь_к_интеграции>?<заданный_query-параметр>=<содержимое_промпта>.

  • Если в качестве способа передачи промпта выбрана опция Тело запроса, тело запроса должно содержать поле, заданное в блоке Способ передачи промта, и его значение.

    Пример тела запроса: {"<имя_поля_тела_запроса_>": "<содержимое_промпта>"}.

Предыдущая
DataSphere
Следующая
Yandex Workflows