[Документация Yandex Cloud](../../../index.md) > [Yandex API Gateway](../../index.md) > [Пошаговые инструкции](../index.md) > [Конструктор спецификаций](index.md) > Yandex AI Studio

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

{% list tabs %}

- Консоль управления

    1. В [консоли управления](https://console.yandex.cloud) выберите [каталог](../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором создали или хотите создать [API-шлюз](../../concepts/index.md).
    1. Перейдите в сервис **API Gateway**.
    1. Выберите API-шлюз или нажмите кнопку **Создать API-шлюз**, чтобы создать новый.
    1. В поле **Спецификация** нажмите значок ![image](../../../_assets/api-gateway/spec-constructor/cloud-yagpt.svg).
    1. Укажите в поле:

        * **Путь** — относительный путь к интеграции, который будет добавлен к URL-адресу API Gateway. Переменные указывайте в фигурных скобках, например `/static/{function_id}`. Подробнее в спецификации [OpenAPI 3.0](https://github.com/OAI/OpenAPI-Specification).
        * **HTTP-метод** — метод, который будет использоваться для взаимодействия с интеграцией.

        * **Сервисный аккаунт** — сервисный аккаунт для авторизации при обращении к [API генерации текста](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/generation/index). Если у вас нет сервисного аккаунта, [создайте](../../../iam/operations/sa/create.md) его.

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

        * Для модели `YandexGPT` — идентификатор каталога, который будет указан в URI модели генерации текста.
        * Для модели `DataSphere` — идентификатор модели, дообученной в [Yandex DataSphere](../../../datasphere/index.md).

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

        * Для источника `Query-параметр` — имя query-параметра, в котором будет передаваться промпт для запроса к API генерации текста.
        * Для источника `Тело запроса` — имя поля тела запроса, в котором будет передаваться промпт для запроса к API генерации текста.
    1. В блоке **Сценарий использования** выберите сценарий использования модели и задайте параметры, соответствующие выбранному сценарию:

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

            * (Опционально) **Температура** — определяет вариативность ответа модели: укажите значение от `0` до `1`. Чем выше температура, тем более креативными и случайными будут ответы модели. Значение по умолчанию — `0.3`.
            * (Опционально) **Количество токенов** — максимальное число [токенов](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/generation/tokens) генерации. По умолчанию `5`. Позволяет при необходимости ограничить объем ответа модели.

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

            * **Описание задания** — текстовое описание задания для классификатора.
            * **Классы** — список классов, к которым может относиться текст. Чтобы добавить класс, нажмите значок ![image](../../../_assets/console-icons/plus.svg).

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

            * (Опционально) **Примеры запросов** — примеры текстовых запросов для классов в формате `текстовый запрос:класс`. Чтобы добавить пример, нажмите значок ![image](../../../_assets/console-icons/plus.svg). Подробнее в разделе [Классификатор Few-shot](https://aistudio.yandex.ru/docs/ru/ai-studio/concepts/classifier/index#few-shot).

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

{% endlist %}

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


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

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

    Пример пути для вызова API-шлюза: `<путь_к_интеграции>?<заданный_query-параметр>=<содержимое_промпта>`.
* Если в качестве способа передачи промпта выбрана опция `Тело запроса`, тело запроса должно содержать поле, заданное в блоке **Способ передачи промта**, и его значение.
            
    Пример тела запроса: `{"<имя_поля_тела_запроса_>": "<содержимое_промпта>"}`.