Поделиться через


Справочное руководство по предварительной версии REST API Azure OpenAI в Azure AI Foundry Models REST API

В этой статье содержатся сведения о конечных точках REST API вывода для Azure OpenAI.

Спецификации API

Управление и взаимодействие с моделями и ресурсами Azure OpenAI разделено на три основных поверхности API:

  • Контрольная плоскость
  • Плоскость данных — разработка
  • Плоскость данных — вывод

Каждая область или спецификация API инкапсулирует другой набор возможностей Azure OpenAI. Каждый API имеет собственный уникальный набор выпусков API предварительной версии и стабильных и общедоступных (GA). Предварительные версии выпусков в настоящее время, как правило, следуют ежемесячному курсу.

Это важно

Теперь доступен новый API для предварительного просмотра. Дополнительные сведения см. в руководстве по жизненному циклу API.

API (Интерфейс программирования приложений) Последний предварительный выпуск Последний выпуск общедоступной версии Спецификации Описание
Плоскость управления 2024-06-01-preview 2024-10-01 Файлы спецификаций Azure OpenAI предоставляет общий уровень управления всем остальным службам. API уровня управления используется для таких задач, как создание ресурсов Azure OpenAI, развертывание модели и другие задачи управления ресурсами более высокого уровня. Плоскость управления также управляет возможностями, такими как Azure Resource Manager, Bicep, Terraform и Azure CLI.
Плоскость данных — разработка 2025-04-01-preview 2024-10-21 Файлы спецификаций API разработки плоскости данных управляет точной настройкой, отправкой файлов, заданиями приема, пакетными и определенными запросами уровня модели
Плоскость данных — вывод 2025-04-01-preview 2024-10-21 Файлы спецификаций API обработки данных предоставляет возможности вывода и API-эндоинтерфейсы для таких функций, как автозаполнение, завершение чата, встраивания, звуковые данные, анализ ваших данных, Dall-e, ассистенты и т. д.

Аутентификация

Azure OpenAI предоставляет два метода проверки подлинности. Вы можете использовать ключи API или идентификатор Microsoft Entra.

  • Проверка подлинности ключа API. Для этого типа проверки подлинности все запросы API должны содержать Ключ API в заголовке HTTP api-key. В кратком руководстве показано, как выполнять вызовы с помощью этого типа проверки подлинности.

  • Проверка подлинности идентификатора Microsoft Entra: можно пройти проверку подлинности вызова API с помощью маркера Microsoft Entra. Маркеры проверки подлинности включаются в запрос в заголовке Authorization. К маркеру следует добавить префикс Bearer, например Bearer YOUR_AUTH_TOKEN. Вы можете ознакомиться с нашим руководством по проверке подлинности с помощью идентификатора Microsoft Entra.

Управление версиями REST API

Управление версиями API служб осуществляется с использованием параметра запроса api-version. Все версии имеют структуру даты ГГГГ-ММ-ДД. Рассмотрим пример.

POST https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/chat/completions?api-version=2024-06-01

Вывод плоскости данных

В остальной части статьи рассматривается 2025-04-01-preview предварительная версия спецификации инференции плоскости данных Azure OpenAI.

Если вы ищете документацию по последнему выпуску API общедоступной версии, обратитесь к последнему API вывода плоскости данных общедоступной версии

Завершение — создание

POST https://{endpoint}/openai/deployments/{deployment-id}/completions?api-version=2025-04-01-preview

Создает завершение для предоставленного запроса, параметров и выбранной модели.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор развертывания путь Да струна
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
Лучшее из целое число best_of Создает завершения на стороне сервера и возвращает "лучший" (один с наибольшей вероятностью журнала на токен). Потоковую передачу результатов выполнить нельзя.

При использовании с n, best_of управляет числом возможных завершений и n указывает, сколько вернуть – best_of должен быть больше n.

Примечание. Так как этот параметр создает множество завершений, он может быстро использовать квоту маркера. Используйте тщательно и убедитесь, что у вас есть разумные параметры для max_tokens и stop.
нет 1
эхо булевый Возвращает запрос в дополнение к завершению нет Неправда
штраф за частоту число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры на основе их существующей частоты в тексте до сих пор, уменьшая вероятность повторения модели той же строки дословно. нет 0
логит_биас объект Изменяет вероятность появления указанных маркеров в завершении.

Принимает объект JSON, который сопоставляет маркеры (указанные идентификатором маркера в маркеризаторе GPT) с соответствующим значением предвзятости от -100 до 100. С математической точки зрения смещение добавляется к логитам, созданным моделью до выборки. Точный эффект зависит от модели, но значения от –1 до 1 должны уменьшать или увеличивать вероятность выбора; такие значения, как –100 или 100, должны приводить к запрету или эксклюзивному выбору соответствующего маркера.

Например, можно передать {"50256": -100} маркер |endoftext|< для предотвращения >создания маркера |endoftext.
нет Отсутствует
logprobs целое число Включите вероятности журнала в logprobs наиболее вероятные выходные маркеры, а также выбранные маркеры. Например, если logprobs значение равно 5, API вернет список из 5 наиболее вероятных маркеров. API всегда возвращает logprob пример маркера, поэтому в ответе может быть до logprobs+1 элементов.

Максимальное значение logprobs для 5.
нет Отсутствует
макс_токены целое число Максимальное количество токенов, которые могут быть сгенерированы в ходе завершения.

Количество маркеров запроса плюс max_tokens не может превышать длину контекста модели.
нет 16
н целое число Количество завершений, создаваемых для каждого запроса.

Примечание. Так как этот параметр создает множество завершений, он может быстро использовать квоту маркера. Используйте тщательно и убедитесь, что у вас есть разумные параметры для max_tokens и stop.
нет 1
штраф за присутствие число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры в зависимости от того, появляются ли они в тексте до сих пор, что повышает вероятность того, что модель будет говорить о новых темах. нет 0
подсказка строка или массив Запросы для создания завершений, закодированных в виде строки, массива строк, массива маркеров или массива массивов маркеров.

Обратите внимание, что <|endoftext|> — это разделитель документов, который модель видит во время обучения, поэтому если запрос не указан, модель будет создаваться как будто с начала нового документа.
Да
семя целое число Если задано, наша система будет предпринять лучшие усилия для выборки детерминированного, таким образом, что повторяющиеся запросы с одинаковыми и теми же параметрами должны возвращать тот же seed результат.

Детерминированность не гарантируется, и вы должны обратиться к параметру ответа system_fingerprint для мониторинга изменений на сервере.
нет
остановка строка или массив До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры. Возвращенный текст не будет содержать последовательность остановки. нет
поток булевый Потоковая передача частичного хода выполнения. Если задано, маркеры будут отправляться как события, отправленные сервером только для данных, как они становятся доступными, с потокомdata: [DONE], завершаемым сообщением. Пример кода Python.
нет Неправда
суффикс струна Суффикс, который приходит после завершения вставленного текста.

Этот параметр поддерживается только для gpt-3.5-turbo-instruct.
нет Отсутствует
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.

Как правило, мы рекомендуем изменить это или top_p не оба.
нет 1
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить это или temperature не оба.
нет 1
Пользователь струна Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений.
нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json createCompletionResponse

Код состояния: по умолчанию

Описание: служба недоступна

Тип содержимого Тип Описание
application/json errorResponse

Примеры

Пример

Создает завершение для предоставленного запроса, параметров и выбранной модели.

POST https://{endpoint}/openai/deployments/{deployment-id}/completions?api-version=2025-04-01-preview

{
 "prompt": [
  "tell me a joke about mango"
 ],
 "max_tokens": 32,
 "temperature": 1.0,
 "n": 1
}

Ответы: код состояния: 200

{
  "body": {
    "id": "cmpl-7QmVI15qgYVllxK0FtxVGG6ywfzaq",
    "created": 1686617332,
    "choices": [
      {
        "text": "es\n\nWhat do you call a mango who's in charge?\n\nThe head mango.",
        "index": 0,
        "finish_reason": "stop",
        "logprobs": null
      }
    ],
    "usage": {
      "completion_tokens": 20,
      "prompt_tokens": 6,
      "total_tokens": 26
    }
  }
}

Внедрение — создание

POST https://{endpoint}/openai/deployments/{deployment-id}/embeddings?api-version=2025-04-01-preview

Получение векторного представления заданных входных данных, которые можно легко использовать моделями и алгоритмами машинного обучения.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор развертывания путь Да струна Идентификатор развертывания модели, которая была развернута.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
размеры целое число Число измерений, в которых должны быть внедренные выходные данные. Поддерживается только в text-embedding-3 и более поздних моделях. нет
формат_кодирования струна Формат, в который возвращаются встраиваемые элементы. Может быть либо float, либо base64. По умолчанию — float. нет
ввод строка или массив Входной текст для внедрения, закодированный в виде строки или массива маркеров. Чтобы внедрить несколько входных данных в один запрос, передайте массив строк или массив массивов маркеров. Входные данные не должны превышать максимальные входные маркеры для модели (8192 маркеров для text-embedding-ada-002), не может быть пустой строкой, и любой массив должен иметь размер 2048 или меньше. Да
тип ввода струна тип входных данных для внедрения поиска для использования нет
Пользователь струна Уникальный идентификатор, представляющий пользователя, который может помочь в мониторинге и обнаружении злоупотреблений. нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json объект

Примеры

Пример

Верните встраивания для заданного запроса.

POST https://{endpoint}/openai/deployments/{deployment-id}/embeddings?api-version=2025-04-01-preview

{
 "input": [
  "this is a test"
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "data": [
      {
        "index": 0,
        "embedding": [
          -0.012838088,
          -0.007421397,
          -0.017617522,
          -0.028278312,
          -0.018666342,
          0.01737855,
          -0.01821495,
          -0.006950092,
          -0.009937238,
          -0.038580645,
          0.010674067,
          0.02412286,
          -0.013647936,
          0.013189907,
          0.0021125758,
          0.012406612,
          0.020790534,
          0.00074595667,
          0.008397198,
          -0.00535031,
          0.008968075,
          0.014351576,
          -0.014086051,
          0.015055214,
          -0.022211088,
          -0.025198232,
          0.0065186154,
          -0.036350243,
          0.009180495,
          -0.009698266,
          0.009446018,
          -0.008463579,
          -0.0020113448
        ]
      }
    ],
    "usage": {
      "prompt_tokens": 4,
      "total_tokens": 4
    }
  }
}

Завершение чата — создание

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

Создает завершение для сообщения чата

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор развертывания путь Да струна
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
аудио объект Параметры выходных данных звука. Требуется при запросе на вывод звука с modalities: ["audio"]. нет
└─ Формат перечисление Указывает выходной формат звука. Должен быть одним из wav, mp3, flac, opus или pcm16.

Возможные значения: wav, mp3, flac, opus, pcm16
нет
└️ голос перечисление Указывает тип голоса. Поддерживаемые голоса: alloy, echo, fable, onyxи novashimmer.

Возможные значения: alloy, echo, fable, onyx, nova, shimmer
нет
источники данных массив Записи конфигурации для расширений чата Azure OpenAI, которые используют их.
Эта дополнительная спецификация совместима только с Azure OpenAI.
нет
штраф за частоту число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры на основе их существующей частоты в тексте до сих пор, уменьшая вероятность повторения модели той же строки дословно.
нет 0
вызов_функции string или chatCompletionFunctionCallOption Не рекомендуется использовать в пользу tool_choice.

Определяет, какая функция (если есть) вызывается моделью.
none означает, что модель не вызывает функцию и вместо этого создает сообщение.
auto означает, что модель может выбирать между созданием сообщения или вызовом функции.
Указание определенной функции путем {"name": "my_function"} принудительного вызова этой функции моделью.

none значение по умолчанию, если функции отсутствуют. auto значение по умолчанию, если функции присутствуют.
нет
функции массив Не рекомендуется использовать в пользу tools.

Список функций, для которые модель может создавать входные данные JSON.
нет
логит_биас объект Изменяет вероятность появления указанных маркеров в завершении.

Принимает объект JSON, который сопоставляет маркеры (указанные идентификатором маркера в токенизаторе) со связанным значением предвзятости от -100 до 100. С математической точки зрения смещение добавляется к логитам, созданным моделью до выборки. Точный эффект зависит от модели, но значения от –1 до 1 должны уменьшать или увеличивать вероятность выбора; такие значения, как –100 или 100, должны приводить к запрету или эксклюзивному выбору соответствующего маркера.
нет Отсутствует
logprobs булевый Следует ли возвращать вероятности журналов выходных маркеров или нет. Если значение true, возвращает вероятности журнала каждого выходного маркера, возвращаемого в параметре contentmessage. нет Неправда
max_completion_tokens (максимальное количество токенов завершения) целое число Верхняя граница для числа маркеров, которые можно создать для завершения, включая видимые выходные маркеры и маркеры причин. Это поддерживается только в моделях серии o1. Расширит поддержку других моделей в будущем выпуске API. нет
макс_токены целое число Максимальное количество маркеров, которые можно создать в завершении чата.

Общая длина входных маркеров и созданных маркеров ограничена длиной контекста модели.
нет
сообщения массив Список сообщений, составляющих беседу до сих пор. Пример кода Python. Да
метаданные объект Определяемые разработчиком теги и значения, используемые для фильтрации завершений на панели мониторинга хранимых завершений. нет
Условия ChatCompletionModalities Типы выходных данных, которые нужно создать для этого запроса.
Большинство моделей могут создавать текст, который по умолчанию:

["text"]

Модель gpt-4o-audio-preview также может использоваться для создания звука. Чтобы запросить, что эта модель создает как текстовые, так и звуковые ответы, можно использовать:

["text", "audio"]
нет
н целое число Сколько вариантов завершения чата для каждого входного сообщения. Обратите внимание, что плата будет взиматься на основе количества созданных маркеров во всех вариантах. Имейте в виду n , чтобы 1 свести к минимуму затраты. нет 1
вызовы инструмента в параллельном режиме ParallelToolCalls Следует ли включить параллельные вызовы функций во время использования средства. нет Верно
прогноз ПрогнозContent Конфигурация прогнозируемых выходных данных, которая может значительно улучшить время отклика, когда большие части ответа модели известны заранее. Это наиболее распространено при повторном создании файла с незначительными изменениями в большинстве содержимого. нет
штраф за присутствие число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры в зависимости от того, появляются ли они в тексте до сих пор, что повышает вероятность того, что модель будет говорить о новых темах.
нет 0
усилия на рассуждение перечисление Только модели o1

Ограничивает усилия по рассуждениям моделей.

В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе.
Возможные значения: low, mediumhigh
нет
формат_ответа ResponseFormatText или ResponseFormatJsonObject или ResponseFormatJsonSchema Объект, указывающий формат, который должен выводить модель. Совместим с GPT-4o, GPT-4o mini, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo, чем gpt-3.5-turbo-1106более новые.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать вашей предоставленной схеме JSON.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
семя целое число Эта функция доступна в бета-версии.
Если задано, наша система будет предпринять лучшие усилия для выборки детерминированного, таким образом, что повторяющиеся запросы с одинаковыми и теми же параметрами должны возвращать тот же seed результат.
Детерминированность не гарантируется, и вы должны обратиться к параметру ответа system_fingerprint для мониторинга изменений на сервере.
нет
остановка строка или массив До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры.
нет
магазин булевый Независимо от того, следует ли хранить выходные данные этого запроса на завершение чата для использования в наших продуктах для дистилляции или оценки модели. нет
поток булевый Если задано, будут отправляться частичные разностные сообщения, например в ChatGPT. Маркеры будут отправляться как события, отправленные сервером только для данных, как они становятся доступными, при этом поток завершается сообщениемdata: [DONE]. Пример кода Python.
нет Неправда
параметры_потока chatCompletionStreamOptions Параметры потокового ответа. Этот параметр устанавливается только при установке stream: true.
нет Отсутствует
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.

Как правило, мы рекомендуем изменить это или top_p не оба.
нет 1
выбор инструмента chatCompletionToolChoiceOption Определяет, какое средство (если таковое) вызывается моделью. none означает, что модель не вызывает никаких инструментов и вместо этого создает сообщение. auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов. required означает, что модель должна вызывать один или несколько инструментов. Указание определенного средства с помощью {"type": "function", "function": {"name": "my_function"}} принудительного вызова этого средства моделью. none значение по умолчанию, если средства отсутствуют. auto значение по умолчанию, если существуют средства. нет
инструменты массив Список инструментов, которые может вызывать модель. В настоящее время в качестве инструмента поддерживаются только функции. Используйте это для предоставления списка функций, для которые модель может создавать входные данные JSON. Поддерживаются не более 128 функций.
нет
top_logprobs целое число Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. logprobs Необходимо задать значение true , если этот параметр используется. нет
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить это или temperature не оба.
нет 1
Пользователь струна Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений.
нет
контекст безопасности пользователя userSecurityContext Контекст безопасности пользователей содержит несколько параметров, описывающих само приложение ИИ, и конечный пользователь, взаимодействующий с приложением ИИ. Эти поля помогают группам по операциям безопасности исследовать и устранять инциденты безопасности, предоставляя комплексный подход к защите приложений ИИ. Узнайте больше о защите приложений ИИ с помощью Microsoft Defender для облака. нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json объект

Код состояния: по умолчанию

Описание: служба недоступна

Тип содержимого Тип Описание
application/json errorResponse

Примеры

Пример

Создает завершение для предоставленного запроса, параметров и выбранной модели.

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

{
 "messages": [
  {
   "role": "system",
   "content": "you are a helpful assistant that talks like a pirate"
  },
  {
   "role": "user",
   "content": "can you tell me how to care for a parrot?"
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Ahoy matey! So ye be wantin' to care for a fine squawkin' parrot, eh? Well, shiver me timbers, let ol' Cap'n Assistant share some wisdom with ye! Here be the steps to keepin' yer parrot happy 'n healthy:\n\n1. Secure a sturdy cage: Yer parrot be needin' a comfortable place to lay anchor! Be sure ye get a sturdy cage, at least double the size of the bird's wingspan, with enough space to spread their wings, yarrrr!\n\n2. Perches 'n toys: Aye, parrots need perches of different sizes, shapes, 'n textures to keep their feet healthy. Also, a few toys be helpin' to keep them entertained 'n their minds stimulated, arrrh!\n\n3. Proper grub: Feed yer feathered friend a balanced diet of high-quality pellets, fruits, 'n veggies to keep 'em strong 'n healthy. Give 'em fresh water every day, or ye\u00e2\u20ac\u2122ll have a scurvy bird on yer hands!\n\n4. Cleanliness: Swab their cage deck! Clean their cage on a regular basis: fresh water 'n food daily, the floor every couple of days, 'n a thorough scrubbing ev'ry few weeks, so the bird be livin' in a tidy haven, arrhh!\n\n5. Socialize 'n train: Parrots be a sociable lot, arrr! Exercise 'n interact with 'em daily to create a bond 'n maintain their mental 'n physical health. Train 'em with positive reinforcement, treat 'em kindly, yarrr!\n\n6. Proper rest: Yer parrot be needin' \u00e2\u20ac\u2122bout 10-12 hours o' sleep each night. Cover their cage 'n let them slumber in a dim, quiet quarter for a proper night's rest, ye scallywag!\n\n7. Keep a weather eye open for illness: Birds be hidin' their ailments, arrr! Be watchful for signs of sickness, such as lethargy, loss of appetite, puffin' up, or change in droppings, and make haste to a vet if need be.\n\n8. Provide fresh air 'n avoid toxins: Parrots be sensitive to draft and pollutants. Keep yer quarters well ventilated, but no drafts, arrr! Be mindful of toxins like Teflon fumes, candles, or air fresheners.\n\nSo there ye have it, me hearty! With proper care 'n commitment, yer parrot will be squawkin' \"Yo-ho-ho\" for many years to come! Good luck, sailor, and may the wind be at yer back!"
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Пример

Создает завершение на основе данных поиска Azure и управляемого удостоверения, назначаемого системой.

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

{
 "messages": [
  {
   "role": "user",
   "content": "can you tell me how to care for a dog?"
  }
 ],
 "data_sources": [
  {
   "type": "azure_search",
   "parameters": {
    "endpoint": "https://your-search-endpoint.search.windows.net/",
    "index_name": "{index name}",
    "authentication": {
     "type": "system_assigned_managed_identity"
    }
   }
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Content of the completion [doc1].",
          "context": {
            "citations": [
              {
                "content": "Citation content.",
                "title": "Citation Title",
                "filepath": "contoso.txt",
                "url": "https://contoso.blob.windows.net/container/contoso.txt",
                "chunk_id": "0"
              }
            ],
            "intent": "dog care"
          }
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Пример

Создает завершение на основе векторных данных изображения поиска Azure.

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

{
 "messages": [
  {
   "role": "user",
   "content": "can you tell me how to care for a dog?"
  }
 ],
 "data_sources": [
  {
   "type": "azure_search",
   "parameters": {
    "endpoint": "https://your-search-endpoint.search.windows.net/",
    "index_name": "{index name}",
    "query_type": "vector",
    "fields_mapping": {
     "image_vector_fields": [
      "image_vector"
     ]
    },
    "authentication": {
     "type": "api_key",
     "key": "{api key}"
    }
   }
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Content of the completion."
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Пример

Создает завершение на основе данных вектора поиска Azure, предыдущего сообщения помощника и управляемого удостоверения, назначаемого пользователем.

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

{
 "messages": [
  {
   "role": "user",
   "content": "can you tell me how to care for a cat?"
  },
  {
   "role": "assistant",
   "content": "Content of the completion [doc1].",
   "context": {
    "intent": "cat care"
   }
  },
  {
   "role": "user",
   "content": "how about dog?"
  }
 ],
 "data_sources": [
  {
   "type": "azure_search",
   "parameters": {
    "endpoint": "https://your-search-endpoint.search.windows.net/",
    "authentication": {
     "type": "user_assigned_managed_identity",
     "managed_identity_resource_id": "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resource-name}"
    },
    "index_name": "{index name}",
    "query_type": "vector",
    "embedding_dependency": {
     "type": "deployment_name",
     "deployment_name": "{embedding deployment name}"
    },
    "in_scope": true,
    "top_n_documents": 5,
    "strictness": 3,
    "role_information": "You are an AI assistant that helps people find information.",
    "fields_mapping": {
     "content_fields_separator": "\\n",
     "content_fields": [
      "content"
     ],
     "filepath_field": "filepath",
     "title_field": "title",
     "url_field": "url",
     "vector_fields": [
      "contentvector"
     ]
    }
   }
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Content of the completion [doc1].",
          "context": {
            "citations": [
              {
                "content": "Citation content 2.",
                "title": "Citation Title 2",
                "filepath": "contoso2.txt",
                "url": "https://contoso.blob.windows.net/container/contoso2.txt",
                "chunk_id": "0"
              }
            ],
            "intent": "dog care"
          }
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Пример

Создает завершение для предоставленного Azure Cosmos DB.

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

{
 "messages": [
  {
   "role": "user",
   "content": "can you tell me how to care for a dog?"
  }
 ],
 "data_sources": [
  {
   "type": "azure_cosmos_db",
   "parameters": {
    "authentication": {
     "type": "connection_string",
     "connection_string": "mongodb+srv://rawantest:{password}$@{cluster-name}.mongocluster.cosmos.azure.com/?tls=true&authMechanism=SCRAM-SHA-256&retrywrites=false&maxIdleTimeMS=120000"
    },
    "database_name": "vectordb",
    "container_name": "azuredocs",
    "index_name": "azuredocindex",
    "embedding_dependency": {
     "type": "deployment_name",
     "deployment_name": "{embedding deployment name}"
    },
    "fields_mapping": {
     "content_fields": [
      "content"
     ],
     "vector_fields": [
      "contentvector"
     ]
    }
   }
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Content of the completion [doc1].",
          "context": {
            "citations": [
              {
                "content": "Citation content.",
                "title": "Citation Title",
                "filepath": "contoso.txt",
                "url": "https://contoso.blob.windows.net/container/contoso.txt",
                "chunk_id": "0"
              }
            ],
            "intent": "dog care"
          }
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Пример

Создает завершение для предоставленной базы данных Mongo.

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

{
 "messages": [
  {
   "role": "user",
   "content": "can you tell me how to care for a dog?"
  }
 ],
 "data_sources": [
  {
   "type": "mongo_db",
   "parameters": {
    "authentication": {
     "type": "username_and_password",
     "username": "<username>",
     "password": "<password>"
    },
    "endpoint": "<endpoint_name>",
    "app_name": "<application name>",
    "database_name": "sampledb",
    "collection_name": "samplecollection",
    "index_name": "sampleindex",
    "embedding_dependency": {
     "type": "deployment_name",
     "deployment_name": "{embedding deployment name}"
    },
    "fields_mapping": {
     "content_fields": [
      "content"
     ],
     "vector_fields": [
      "contentvector"
     ]
    }
   }
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Content of the completion [doc1].",
          "context": {
            "citations": [
              {
                "content": "Citation content.",
                "title": "Citation Title",
                "filepath": "contoso.txt",
                "url": "https://contoso.blob.windows.net/container/contoso.txt",
                "chunk_id": "0"
              }
            ],
            "intent": "dog care"
          }
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Пример

Создает завершение для предоставленного Elasticsearch.

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

{
 "messages": [
  {
   "role": "user",
   "content": "can you tell me how to care for a dog?"
  }
 ],
 "data_sources": [
  {
   "type": "elasticsearch",
   "parameters": {
    "endpoint": "https://your-elasticsearch-endpoint.eastus.azurecontainer.io",
    "index_name": "{index name}",
    "authentication": {
     "type": "key_and_key_id",
     "key": "{key}",
     "key_id": "{key id}"
    }
   }
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Content of the completion [doc1].",
          "context": {
            "citations": [
              {
                "content": "Citation content.",
                "title": "Citation Title",
                "filepath": "contoso.txt",
                "url": "https://contoso.blob.windows.net/container/contoso.txt",
                "chunk_id": "0"
              }
            ],
            "intent": "dog care"
          }
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Пример

Создает завершение для предоставленного ресурса Pinecone.

POST https://{endpoint}/openai/deployments/{deployment-id}/chat/completions?api-version=2025-04-01-preview

{
 "messages": [
  {
   "role": "user",
   "content": "can you tell me how to care for a dog?"
  }
 ],
 "data_sources": [
  {
   "type": "pinecone",
   "parameters": {
    "authentication": {
     "type": "api_key",
     "key": "{api key}"
    },
    "environment": "{environment name}",
    "index_name": "{index name}",
    "embedding_dependency": {
     "type": "deployment_name",
     "deployment_name": "{embedding deployment name}"
    },
    "fields_mapping": {
     "title_field": "title",
     "url_field": "url",
     "filepath_field": "filepath",
     "content_fields": [
      "content"
     ],
     "content_fields_separator": "\n"
    }
   }
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "chatcmpl-7R1nGnsXO8n4oi9UPz2f3UHdgAYMn",
    "created": 1686676106,
    "choices": [
      {
        "index": 0,
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": "Content of the completion [doc1].",
          "context": {
            "citations": [
              {
                "content": "Citation content.",
                "title": "Citation Title",
                "filepath": "contoso.txt",
                "url": "https://contoso.blob.windows.net/container/contoso.txt",
                "chunk_id": "0"
              }
            ],
            "intent": "dog care"
          }
        }
      }
    ],
    "usage": {
      "completion_tokens": 557,
      "prompt_tokens": 33,
      "total_tokens": 590
    }
  }
}

Транскрибирование — создание

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview

Транскрибирует звук на язык ввода.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор развертывания путь Да струна
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: многочастный формат данных

Имя Тип Описание Обязательно По умолчанию
файл струна Объект звукового файла для транскрибирования. Да
язык струна Язык входного звука. Предоставление языка ввода в формате ISO-639-1 повышает точность и задержку. нет
подсказка струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен соответствовать языку звука. нет
формат_ответа audioResponseFormat Определяет формат выходных данных. нет
Температура число/номер Температура выборки от 0 до 1. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Если задано значение 0, модель будет использовать вероятность журнала для автоматического увеличения температуры до тех пор, пока определенные пороговые значения не будут достигнуты. нет 0
timestamp_granularities[] массив Гранулярность метки времени для заполнения этой транскрибирования. response_format необходимо задать verbose_json для использования детализации метки времени. Поддерживаются либо оба этих параметра: wordили segment. Примечание. Дополнительная задержка для меток времени сегмента отсутствует, но при создании меток времени слова возникает дополнительная задержка. нет сегмент

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json объект
текст/без форматирования струна Транскрибированные тексты в выходном формате (когда response_format был одним из textили vttsrt).

Примеры

Пример

Получает транскрибированный текст и связанные метаданные из предоставленных речевых звуковых данных.

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "text": "A structured object when requesting json or verbose_json"
  }
}

Пример

Получает транскрибированный текст и связанные метаданные из предоставленных речевых звуковых данных.

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/transcriptions?api-version=2025-04-01-preview

"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"

Ответы: код состояния: 200

{
  "type": "string",
  "example": "plain text when requesting text, srt, or vtt"
}

Переводы — создание

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview

Транскрибирует и преобразует входной звук на английский текст.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор развертывания путь Да струна
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: многочастный формат данных

Имя Тип Описание Обязательно По умолчанию
файл струна Звуковой файл для перевода. Да
подсказка струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен находиться на английском языке. нет
формат_ответа audioResponseFormat Определяет формат выходных данных. нет
Температура число/номер Температура выборки от 0 до 1. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Если задано значение 0, модель будет использовать вероятность журнала для автоматического увеличения температуры до тех пор, пока определенные пороговые значения не будут достигнуты. нет 0

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json объект
текст/без форматирования струна Транскрибированные тексты в выходном формате (когда response_format был одним из текста, vtt или srt).

Примеры

Пример

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

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview

"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"

Ответы: код состояния: 200

{
  "body": {
    "text": "A structured object when requesting json or verbose_json"
  }
}

Пример

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

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/translations?api-version=2025-04-01-preview

"---multipart-boundary\nContent-Disposition: form-data; name=\"file\"; filename=\"file.wav\"\nContent-Type: application/octet-stream\n\nRIFF..audio.data.omitted\n---multipart-boundary--"

Ответы: код состояния: 200

{
  "type": "string",
  "example": "plain text when requesting text, srt, or vtt"
}

Речь — создание

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/speech?api-version=2025-04-01-preview

Создает звук из входного текста.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор развертывания путь Да струна
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: многочастный формат данных

Имя Тип Описание Обязательно По умолчанию
ввод струна Текст для синтеза звука. Максимальная длина — 4096 символов. Да
формат_ответа перечисление Формат синтеза звука в.
Возможные значения: mp3, opus, aac, flac, wav, pcm
нет
скорость число/номер Скорость синтезированного звука. Выберите значение из 0.254.0. 1.0 — это значение по умолчанию. нет 1.0
голос перечисление Голос, используемый для синтеза речи.
Возможные значения: alloy, echo, fable, onyx, nova, shimmer
Да

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/octet-stream струна

Примеры

Пример

Синтезирует звук из предоставленного текста.

POST https://{endpoint}/openai/deployments/{deployment-id}/audio/speech?api-version=2025-04-01-preview

{
 "input": "Hi! What are you going to make?",
 "voice": "fable",
 "response_format": "mp3"
}

Ответы: код состояния: 200

{
  "body": "101010101"
}

Поколения изображений — создание

POST https://{endpoint}/openai/deployments/{deployment-id}/images/generations?api-version=2025-04-01-preview

Создает набор изображений из текстового заголовка с использованием заданной модели развертывания DALLE или gpt-image-1.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор развертывания путь Да струна
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
фон imageBackground Позволяет задать прозрачность фона созданных образов. Этот параметр поддерживается только для gpt-image-1. нет авто
н целое число Количество генерируемых изображений. Для dall-e-3 поддерживается только n=1. нет 1
сжатие вывода целое число Уровень сжатия (0–100%) для созданных образов. Этот параметр поддерживается только для gpt-image-1 с форматом выходных данных JPEG. нет 100
формат_выходных_данных imagesOutputFormat Формат файла, в котором возвращаются созданные изображения. Поддерживается только для gpt-image-1. нет PNG
подсказка струна Текстовое описание требуемых изображений. Максимальная длина — 32000 символов для gpt-image-1 и 4000 символов для dall-e-3 Да
качество imageQuality Качество создаваемого изображения. нет авто
формат_ответа imagesResponseFormat Формат, в котором возвращаются созданные изображения. нет URL-адрес
размер imageSize Размер созданных изображений. нет авто
стиль imageStyle Стиль созданных изображений. Поддерживается только для dall-e-3. нет яркий
Пользователь струна Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений. нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json generateImagesResponse

Код состояния: по умолчанию

Описание: произошла ошибка.

Тип содержимого Тип Описание
application/json dalleErrorResponse

Примеры

Пример

Создает изображения с запросом.

POST https://{endpoint}/openai/deployments/{deployment-id}/images/generations?api-version=2025-04-01-preview

{
 "prompt": "In the style of WordArt, Microsoft Clippy wearing a cowboy hat.",
 "n": 1,
 "style": "natural",
 "quality": "standard"
}

Ответы: код состояния: 200

{
  "body": {
    "created": 1698342300,
    "data": [
      {
        "revised_prompt": "A vivid, natural representation of Microsoft Clippy wearing a cowboy hat.",
        "prompt_filter_results": {
          "sexual": {
            "severity": "safe",
            "filtered": false
          },
          "violence": {
            "severity": "safe",
            "filtered": false
          },
          "hate": {
            "severity": "safe",
            "filtered": false
          },
          "self_harm": {
            "severity": "safe",
            "filtered": false
          },
          "profanity": {
            "detected": false,
            "filtered": false
          },
          "custom_blocklists": {
            "filtered": false,
            "details": []
          }
        },
        "url": "https://dalletipusw2.blob.core.windows.net/private/images/e5451cc6-b1ad-4747-bd46-b89a3a3b8bc3/generated_00.png?se=2023-10-27T17%3A45%3A09Z&...",
        "content_filter_results": {
          "sexual": {
            "severity": "safe",
            "filtered": false
          },
          "violence": {
            "severity": "safe",
            "filtered": false
          },
          "hate": {
            "severity": "safe",
            "filtered": false
          },
          "self_harm": {
            "severity": "safe",
            "filtered": false
          }
        }
      }
    ]
  }
}

Генерация изображений — редактирование

POST https://{endpoint}/openai/deployments/{deployment-id}/images/edits?api-version=2025-04-01-preview

Изменяет изображение из текстового заголовка для заданного развертывания модели gpt-image-1

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор развертывания путь Да струна
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: многочастный формат данных

Имя Тип Описание Обязательно По умолчанию
образ строка или массив Изображения для редактирования. Должен быть поддерживаемым файлом изображения или массивом изображений. Каждое изображение должно быть png или jpg-файл менее 25 МБ. Да
маска струна Дополнительное изображение с областями полной прозрачности (например, где альфа-канал равен нулю) указывает, где следует отредактировать изображение. Если есть несколько изображений, маска будет применена к первому изображению. Должен быть допустимым PNG-файлом, менее 4 МБ и иметь те же размеры, что и изображение. нет
н целое число Количество генерируемых изображений. нет 1
подсказка струна Текстовое описание требуемых изображений. Максимальная длина — 32000 символов. Да
качество imageQuality Качество создаваемого изображения. нет авто
формат_ответа imagesResponseFormat Формат, в котором возвращаются созданные изображения. нет URL-адрес
размер imageSize Размер созданных изображений. нет авто
Пользователь струна Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений. нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json generateImagesResponse

Код состояния: по умолчанию

Описание: произошла ошибка.

Тип содержимого Тип Описание
application/json dalleErrorResponse

Список — помощники

GET https://{endpoint}/openai/assistants?api-version=2025-04-01-preview

Возвращает список помощников.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
предел запрос нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.
заказ запрос нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для возрастания порядка и desc для убывания.
после запрос нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
перед запрос нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, начиная с obj_foo, следующий вызов может содержать before=obj_foo для получения предыдущей страницы списка.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json listAssistantsResponse

Примеры

Пример

Возвращает список помощников.

GET https://{endpoint}/openai/assistants?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "object": "list",
    "data": [
      {
        "id": "asst_abc123",
        "object": "assistant",
        "created_at": 1707257477,
        "name": "Stock Analyst",
        "description": null,
        "model": "gpt-4-1106-preview",
        "instructions": "You are a financial analyst that analyzes stock market prices and other financial data present on user uploaded files or by calling external APIs.",
        "tools": [
          {
            "type": "code_interpreter"
          }
        ],
        "tool_resources": {},
        "metadata": {},
        "top_p": 1.0,
        "temperature": 1.0,
        "response_format": "auto"
      },
      {
        "id": "asst_abc456",
        "object": "assistant",
        "created_at": 1698982718,
        "name": "My Assistant",
        "description": null,
        "model": "gpt-4-turbo",
        "instructions": "You are a helpful assistant designed to make me better at coding!",
        "tools": [],
        "tool_resources": {},
        "metadata": {},
        "top_p": 1.0,
        "temperature": 1.0,
        "response_format": "auto"
      },
      {
        "id": "asst_abc789",
        "object": "assistant",
        "created_at": 1698982643,
        "name": null,
        "description": null,
        "model": "gpt-4-turbo",
        "instructions": null,
        "tools": [],
        "tool_resources": {},
        "metadata": {},
        "top_p": 1.0,
        "temperature": 1.0,
        "response_format": "auto"
      }
    ],
    "first_id": "asst_abc123",
    "last_id": "asst_abc789",
    "has_more": false
  }
}

Создание — помощник

POST https://{endpoint}/openai/assistants?api-version=2025-04-01-preview

Создайте помощника с моделью и инструкциями.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
описание струна Описание помощника. Максимальная длина — 512 символов.
нет
инструкции струна Системные инструкции, которые использует помощник. Максимальная длина — 256 000 символов.
нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
модель струна Да
имя струна Имя помощника. Максимальная длина — 256 символов.
нет
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
ресурсы инструментов объект Набор ресурсов, используемых средствами помощника. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Хранилище векторов, присоединенное к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
└─ хранилища_векторов массив Помощник по созданию векторного хранилища с file_ids и присоединению его к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
инструменты массив Список инструментов, включенных помощником. На помощника может быть не более 128 инструментов. Средства могут быть типами code_interpreter, retrievalили function.
нет []
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json assistantObject

Примеры

Пример

Создайте помощника с моделью и инструкциями.

POST https://{endpoint}/openai/assistants?api-version=2025-04-01-preview

{
 "name": "Math Tutor",
 "instructions": "When a customer asks about a specific math problem, use Python to evaluate their query.",
 "tools": [
  {
   "type": "code_interpreter"
  }
 ],
 "model": "gpt-4-1106-preview"
}

Ответы: код состояния: 200

{
  "body": {
    "id": "asst_4nsG2qgNzimRPE7MazXTXbU7",
    "object": "assistant",
    "created_at": 1707295707,
    "name": "Math Tutor",
    "description": null,
    "model": "gpt-4-1106-preview",
    "instructions": "When a customer asks about a specific math problem, use Python to evaluate their query.",
    "tools": [
      {
        "type": "code_interpreter"
      }
    ],
    "metadata": {},
    "top_p": 1.0,
    "temperature": 1.0,
    "response_format": "auto"
  }
}

Получить - Ассистент

GET https://{endpoint}/openai/assistants/{assistant_id}?api-version=2025-04-01-preview

Извлекает помощника.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор ассистента путь Да струна Идентификатор извлекаемого помощника.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json assistantObject

Примеры

Пример

Извлекает помощника.

GET https://{endpoint}/openai/assistants/{assistant_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "asst_abc123",
    "object": "assistant",
    "created_at": 1699009709,
    "name": "HR Helper",
    "description": null,
    "model": "gpt-4-turbo",
    "instructions": "You are an HR bot, and you have access to files to answer employee questions about company policies.",
    "tools": [
      {
        "type": "file_search"
      }
    ],
    "metadata": {},
    "top_p": 1.0,
    "temperature": 1.0,
    "response_format": "auto"
  }
}

Изменение — помощник

POST https://{endpoint}/openai/assistants/{assistant_id}?api-version=2025-04-01-preview

Изменяет помощника.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор ассистента путь Да струна Идентификатор помощника для изменения.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
описание струна Описание помощника. Максимальная длина — 512 символов.
нет
инструкции струна Системные инструкции, которые использует помощник. Максимальная длина — 32768 символов.
нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
модель струна нет
имя струна Имя помощника. Максимальная длина — 256 символов.
нет
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
ресурсы инструментов объект Набор ресурсов, используемых средствами помощника. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Переопределяет список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Переопределяет хранилище векторов, подключенное к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
инструменты массив Список инструментов, включенных помощником. На помощника может быть не более 128 инструментов. Средства могут быть типами code_interpreter, retrievalили function.
нет []
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json assistantObject

Примеры

Пример

Изменяет помощника.

POST https://{endpoint}/openai/assistants/{assistant_id}?api-version=2025-04-01-preview

{
 "instructions": "You are an HR bot, and you have access to files to answer employee questions about company policies. Always response with info from either of the files.",
 "tools": [
  {
   "type": "file_search"
  }
 ],
 "model": "gpt-4-turbo"
}

Ответы: код состояния: 200

{
  "body": {
    "id": "asst_123",
    "object": "assistant",
    "created_at": 1699009709,
    "name": "HR Helper",
    "description": null,
    "model": "gpt-4-turbo",
    "instructions": "You are an HR bot, and you have access to files to answer employee questions about company policies. Always response with info from either of the files.",
    "tools": [
      {
        "type": "file_search"
      }
    ],
    "tool_resources": {
      "file_search": {
        "vector_store_ids": []
      }
    },
    "metadata": {},
    "top_p": 1.0,
    "temperature": 1.0,
    "response_format": "auto"
  }
}

Delete — Помощник

DELETE https://{endpoint}/openai/assistants/{assistant_id}?api-version=2025-04-01-preview

Удаление помощника.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор ассистента путь Да струна Идентификатор удаляемого помощника.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json deleteAssistantResponse

Примеры

Пример

Удаляет помощника.

DELETE https://{endpoint}/openai/assistants/{assistant_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "asst_4nsG2qgNzimRPE7MazXTXbU7",
    "object": "assistant.deleted",
    "deleted": true
  }
}

Create — Thread

POST https://{endpoint}/openai/threads?api-version=2025-04-01-preview

Создание потока.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
сообщения массив Список сообщений для запуска потока. нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
ресурсы инструментов объект Набор ресурсов, доступных средствам помощника в этом потоке. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Хранилище векторов, присоединенное к этому потоку. К потоку может быть подключено не более 1 векторного хранилища.
нет
└─ хранилища_векторов массив Вспомогательный объект для создания хранилища векторов с file_ids и присоединения его к этому потоку. К потоку может быть подключено не более 1 векторного хранилища.
нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json threadObject

Примеры

Пример

Создает поток.

POST https://{endpoint}/openai/threads?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "thread_v7V4csrNOxtNmgcwGg496Smx",
    "object": "thread",
    "created_at": 1707297136,
    "metadata": {}
  }
}

Get - Thread

GET https://{endpoint}/openai/threads/{thread_id}?api-version=2025-04-01-preview

Извлекает поток.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор потока для извлечения.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json threadObject

Примеры

Пример

Извлекает поток.

GET https://{endpoint}/openai/threads/{thread_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "thread_v7V4csrNOxtNmgcwGg496Smx",
    "object": "thread",
    "created_at": 1707297136,
    "metadata": {},
    "tool_resources": {
      "code_interpreter": {
        "file_ids": []
      }
    }
  }
}

Изменение — поток

POST https://{endpoint}/openai/threads/{thread_id}?api-version=2025-04-01-preview

Изменяет поток.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор потока для изменения. Изменить можно только metadata.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
ресурсы инструментов объект Набор ресурсов, доступных средствам помощника в этом потоке. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Хранилище векторов, присоединенное к этому потоку. К потоку может быть подключено не более 1 векторного хранилища.
нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json threadObject

Примеры

Пример

Изменяет поток.

POST https://{endpoint}/openai/threads/{thread_id}?api-version=2025-04-01-preview

{
 "metadata": {
  "modified": "true",
  "user": "abc123"
 }
}

Ответы: код состояния: 200

{
  "body": {
    "id": "thread_v7V4csrNOxtNmgcwGg496Smx",
    "object": "thread",
    "created_at": 1707297136,
    "metadata": {
      "modified": "true",
      "user": "abc123"
    },
    "tool_resources": {}
  }
}

Delete — Thread

DELETE https://{endpoint}/openai/threads/{thread_id}?api-version=2025-04-01-preview

Удаление потока.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор удаляемого потока.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json deleteThreadResponse

Примеры

Пример

Удаляет поток.

DELETE https://{endpoint}/openai/threads/{thread_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "thread_v7V4csrNOxtNmgcwGg496Smx",
    "object": "thread.deleted",
    "deleted": true
  }
}

Список — сообщения

GET https://{endpoint}/openai/threads/{thread_id}/messages?api-version=2025-04-01-preview

Возвращает список сообщений для данного потока.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификаторы тем, к которым относятся сообщения.
предел запрос нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.
заказ запрос нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для возрастания порядка и desc для убывания.
после запрос нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
перед запрос нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, начиная с obj_foo, следующий вызов может содержать before=obj_foo для получения предыдущей страницы списка.
идентификатор_запуска запрос нет струна Фильтруйте сообщения по идентификатору запуска, который создал их.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json СписокОтветовСообщений

Примеры

Пример

Вывод списка сообщений

GET https://{endpoint}/openai/threads/{thread_id}/messages?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "object": "list",
    "data": [
      {
        "id": "msg_abc123",
        "object": "thread.message",
        "created_at": 1699016383,
        "assistant_id": null,
        "thread_id": "thread_abc123",
        "run_id": null,
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": {
              "value": "How does AI work? Explain it in simple terms.",
              "annotations": []
            }
          }
        ],
        "attachments": [],
        "metadata": {}
      },
      {
        "id": "msg_abc456",
        "object": "thread.message",
        "created_at": 1699016383,
        "assistant_id": null,
        "thread_id": "thread_abc123",
        "run_id": null,
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": {
              "value": "Hello, what is AI?",
              "annotations": []
            }
          }
        ],
        "attachments": [],
        "metadata": {}
      }
    ],
    "first_id": "msg_abc123",
    "last_id": "msg_abc456",
    "has_more": false
  }
}

Создание — сообщение

POST https://{endpoint}/openai/threads/{thread_id}/messages?api-version=2025-04-01-preview

Создать сообщение.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификаторы потоков, для которых нужно создать сообщение.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
Вложения массив Список файлов, присоединенных к сообщению, и инструменты, к которому они должны быть добавлены. нет
содержимое струна Содержимое сообщения. Да
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
роль струна Роль сущности, создающей сообщение. Допустимые значения:
- user: указывает, что сообщение отправляется фактическим пользователем и должно использоваться в большинстве случаев для представления сообщений, созданных пользователем.
- assistant: указывает, что сообщение создается помощником. Используйте это значение для вставки сообщений от помощника в беседу.
Да

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json messageObject

Примеры

Пример

Создать сообщение.

POST https://{endpoint}/openai/threads/{thread_id}/messages?api-version=2025-04-01-preview

{
 "role": "user",
 "content": "What is the cube root of the sum of 12, 14, 1234, 4321, 90000, 123213541223, 443123123124, 5423324234, 234324324234, 653434534545, 200000000, 98237432984, 99999999, 99999999999, 220000000000, 3309587702? Give me the answer rounded to the nearest integer without commas or spaces."
}

Ответы: код состояния: 200

{
  "body": {
    "id": "msg_as3XIk1tpVP3hdHjWBGg3uG4",
    "object": "thread.message",
    "created_at": 1707298421,
    "assistant_id": null,
    "thread_id": "thread_v7V4csrNOxtNmgcwGg496Smx",
    "run_id": null,
    "role": "user",
    "content": [
      {
        "type": "text",
        "text": {
          "value": "What is the cube root of the sum of 12, 14, 1234, 4321, 90000, 123213541223, 443123123124, 5423324234, 234324324234, 653434534545, 200000000, 98237432984, 99999999, 99999999999, 220000000000, 3309587702? Give me the answer rounded to the nearest integer without commas or spaces.",
          "annotations": []
        }
      }
    ],
    "attachments": [],
    "metadata": {}
  }
}

Получить - Сообщение

GET https://{endpoint}/openai/threads/{thread_id}/messages/{message_id}?api-version=2025-04-01-preview

Получение сообщения.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор потоков, к которым принадлежит это сообщение.
Идентификатор_сообщения путь Да струна Идентификатор полученного сообщения.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json messageObject

Примеры

Пример

Получение сообщения.

GET https://{endpoint}/openai/threads/{thread_id}/messages/{message_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "msg_as3XIk1tpVP3hdHjWBGg3uG4",
    "object": "thread.message",
    "created_at": 1707298421,
    "thread_id": "thread_v7V4csrNOxtNmgcwGg496Smx",
    "role": "user",
    "content": [
      {
        "type": "text",
        "text": {
          "value": "What is the cube root of the sum of 12, 14, 1234, 4321, 90000, 123213541223, 443123123124, 5423324234, 234324324234, 653434534545, 200000000, 98237432984, 99999999, 99999999999, 220000000000, 3309587702? Give me the answer rounded to the nearest integer without commas or spaces.",
          "annotations": []
        }
      }
    ],
    "file_ids": [],
    "assistant_id": null,
    "run_id": null,
    "metadata": {}
  }
}

Изменение — сообщение

POST https://{endpoint}/openai/threads/{thread_id}/messages/{message_id}?api-version=2025-04-01-preview

Изменяет сообщение.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор потока, к которому принадлежит это сообщение.
Идентификатор_сообщения путь Да струна Идентификатор сообщения для изменения.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json messageObject

Примеры

Пример

Изменение сообщения.

POST https://{endpoint}/openai/threads/{thread_id}/messages/{message_id}?api-version=2025-04-01-preview

{
 "metadata": {
  "modified": "true",
  "user": "abc123"
 }
}

Ответы: код состояния: 200

{
  "body": {
    "id": "msg_abc123",
    "object": "thread.message",
    "created_at": 1699017614,
    "assistant_id": null,
    "thread_id": "thread_abc123",
    "run_id": null,
    "role": "user",
    "content": [
      {
        "type": "text",
        "text": {
          "value": "How does AI work? Explain it in simple terms.",
          "annotations": []
        }
      }
    ],
    "file_ids": [],
    "metadata": {
      "modified": "true",
      "user": "abc123"
    }
  }
}

Создание — поток и запуск

POST https://{endpoint}/openai/threads/runs?api-version=2025-04-01-preview

Создайте поток и запустите его в одном запросе.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
идентификатор ассистента струна Идентификатор помощника, используемого для выполнения этого выполнения. Да
инструкции струна Переопределите системное сообщение помощника по умолчанию. Это полезно для изменения поведения на основе каждого запуска. нет
max_completion_tokens (максимальное количество токенов завершения) целое число Максимальное количество маркеров завершения, которые могут использоваться в ходе выполнения. Выполнение сделает все возможное, чтобы использовать только количество маркеров завершения, указанных в нескольких поворотах выполнения. Если выполнение превышает указанное число маркеров завершения, выполнение завершится состоянием incomplete. Дополнительные сведения см. в incomplete_details.
нет
максимальное количество токенов запроса целое число Максимальное количество маркеров запроса, которые могут использоваться в ходе выполнения. Выполнение сделает все возможное, чтобы использовать только количество маркеров запроса, указанных в нескольких поворотах выполнения. Если выполнение превышает указанное число маркеров запроса, выполнение завершится состоянием incomplete. Дополнительные сведения см. в incomplete_details.
нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
модель струна Идентификатор моделей, используемых для выполнения этого выполнения. Если здесь указано значение, оно переопределит модель, связанную с помощником. В противном случае будет использоваться модель, связанная с помощником. нет
вызовы инструмента в параллельном режиме ParallelToolCalls Следует ли включить параллельные вызовы функций во время использования средства. нет Верно
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
поток булевый Если trueвозвращает поток событий, которые происходят во время событий запуска от имени сервера, завершая выполнение в состоянии терминала с сообщением data: [DONE] .
нет
параметры_потока chatCompletionStreamOptions Параметры потокового ответа. Этот параметр устанавливается только при установке stream: true.
нет Отсутствует
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
нить createThreadRequest нет
выбор инструмента assistantsApiToolChoiceOption Определяет, какое средство (если таковое) вызывается моделью.
none означает, что модель не вызывает средства и вместо этого создает сообщение.
auto является значением по умолчанию и означает, что модель может выбирать между созданием сообщения или вызовом средства.
Указание определенного инструмента, например {"type": "file_search"} или {"type": "function", "function": {"name": "my_function"}} принудительное вызов модели.
нет
ресурсы инструментов объект Набор ресурсов, используемых средствами помощника. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Идентификатор хранилища векторов, присоединенного к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
инструменты массив Переопределите средства, которые помощник может использовать для этого запуска. Это полезно для изменения поведения на основе каждого запуска. нет
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1
стратегия усечения усечениеObject Определяет, как поток будет усечен до выполнения. Используйте это для управления начальным окном контекста выполнения. нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json runObject

Примеры

Пример

Создайте поток и запустите его в одном запросе.

POST https://{endpoint}/openai/threads/runs?api-version=2025-04-01-preview

{
 "assistant_id": "asst_abc123",
 "thread": {
  "messages": [
   {
    "role": "user",
    "content": "Explain deep learning to a 5 year old."
   }
  ]
 }
}

Ответы: код состояния: 200

{
  "body": {
    "id": "run_abc123",
    "object": "thread.run",
    "created_at": 1699076792,
    "assistant_id": "asst_abc123",
    "thread_id": "thread_abc123",
    "status": "queued",
    "started_at": null,
    "expires_at": 1699077392,
    "cancelled_at": null,
    "failed_at": null,
    "completed_at": null,
    "required_action": null,
    "last_error": null,
    "model": "gpt-4-turbo",
    "instructions": "You are a helpful assistant.",
    "tools": [],
    "tool_resources": {},
    "metadata": {},
    "temperature": 1.0,
    "top_p": 1.0,
    "max_completion_tokens": null,
    "max_prompt_tokens": null,
    "truncation_strategy": {
      "type": "auto",
      "last_messages": null
    },
    "incomplete_details": null,
    "usage": null,
    "response_format": "auto",
    "tool_choice": "auto"
  }
}

Список — запуски

GET https://{endpoint}/openai/threads/{thread_id}/runs?api-version=2025-04-01-preview

Возвращает список запусков, принадлежащих потоку.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор потока (thread_id) путь Да струна Идентификатор потока, к которому относится запуск.
предел запрос нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.
заказ запрос нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для возрастания порядка и desc для убывания.
после запрос нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
перед запрос нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, начиная с obj_foo, следующий вызов может содержать before=obj_foo для получения предыдущей страницы списка.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json listRunsResponse

Примеры

Пример

Возвращает список запусков, принадлежащих потоку.

GET https://{endpoint}/openai/threads/{thread_id}/runs?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "object": "list",
    "data": [
      {
        "id": "run_abc123",
        "object": "thread.run",
        "created_at": 1699075072,
        "assistant_id": "asst_abc123",
        "thread_id": "thread_abc123",
        "status": "completed",
        "started_at": 1699075072,
        "expires_at": null,
        "cancelled_at": null,
        "failed_at": null,
        "completed_at": 1699075073,
        "last_error": null,
        "model": "gpt-4-turbo",
        "instructions": null,
        "incomplete_details": null,
        "tools": [
          {
            "type": "code_interpreter"
          }
        ],
        "tool_resources": {
          "code_interpreter": {
            "file_ids": [
              "file-abc123",
              "file-abc456"
            ]
          }
        },
        "metadata": {},
        "usage": {
          "prompt_tokens": 123,
          "completion_tokens": 456,
          "total_tokens": 579
        },
        "temperature": 1.0,
        "top_p": 1.0,
        "max_prompt_tokens": 1000,
        "max_completion_tokens": 1000,
        "truncation_strategy": {
          "type": "auto",
          "last_messages": null
        },
        "response_format": "auto",
        "tool_choice": "auto"
      },
      {
        "id": "run_abc456",
        "object": "thread.run",
        "created_at": 1699063290,
        "assistant_id": "asst_abc123",
        "thread_id": "thread_abc123",
        "status": "completed",
        "started_at": 1699063290,
        "expires_at": null,
        "cancelled_at": null,
        "failed_at": null,
        "completed_at": 1699063291,
        "last_error": null,
        "model": "gpt-4-turbo",
        "instructions": null,
        "incomplete_details": null,
        "tools": [
          {
            "type": "code_interpreter"
          }
        ],
        "tool_resources": {
          "code_interpreter": {
            "file_ids": [
              "file-abc123",
              "file-abc456"
            ]
          }
        },
        "metadata": {},
        "usage": {
          "prompt_tokens": 123,
          "completion_tokens": 456,
          "total_tokens": 579
        },
        "temperature": 1.0,
        "top_p": 1.0,
        "max_prompt_tokens": 1000,
        "max_completion_tokens": 1000,
        "truncation_strategy": {
          "type": "auto",
          "last_messages": null
        },
        "response_format": "auto",
        "tool_choice": "auto"
      }
    ],
    "first_id": "run_abc123",
    "last_id": "run_abc456",
    "has_more": false
  }
}

Создание — запуск

POST https://{endpoint}/openai/threads/{thread_id}/runs?api-version=2025-04-01-preview

Создайте запуск.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор выполняемого потока.
включить[] запрос нет массив Список дополнительных полей для включения в ответ. В настоящее время единственным поддерживаемым значением для получения содержимого результатов поиска файлов является step_details.tool_calls[*].file_search.results[*].content.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
дополнительные_инструкции струна Добавляет дополнительные инструкции в конце инструкций для выполнения. Это полезно для изменения поведения на основе каждого запуска без переопределения других инструкций. нет
дополнительные_сообщения массив Добавляет дополнительные сообщения в поток перед созданием запуска. нет
идентификатор ассистента струна Идентификатор помощника, используемого для выполнения этого выполнения. Да
инструкции струна Переопределите системное сообщение помощника по умолчанию. Это полезно для изменения поведения на основе каждого запуска. нет
max_completion_tokens (максимальное количество токенов завершения) целое число Максимальное количество маркеров завершения, которые могут использоваться в ходе выполнения. Выполнение сделает все возможное, чтобы использовать только количество маркеров завершения, указанных в нескольких поворотах выполнения. Если выполнение превышает указанное число маркеров завершения, выполнение завершится состоянием incomplete. Дополнительные сведения см. в incomplete_details.
нет
максимальное количество токенов запроса целое число Максимальное количество маркеров запроса, которые могут использоваться в ходе выполнения. Выполнение сделает все возможное, чтобы использовать только количество маркеров запроса, указанных в нескольких поворотах выполнения. Если выполнение превышает указанное число маркеров запроса, выполнение завершится состоянием incomplete. Дополнительные сведения см. в incomplete_details.
нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
модель струна Идентификатор модели, используемой для выполнения этого выполнения. Если здесь указано значение, оно переопределит модель, связанную с помощником. В противном случае будет использоваться модель, связанная с помощником. нет
вызовы инструмента в параллельном режиме ParallelToolCalls Следует ли включить параллельные вызовы функций во время использования средства. нет Верно
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
поток булевый Если trueвозвращает поток событий, которые происходят во время событий запуска от имени сервера, завершая выполнение в состоянии терминала с сообщением data: [DONE] .
нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
выбор инструмента assistantsApiToolChoiceOption Определяет, какое средство (если таковое) вызывается моделью.
none означает, что модель не вызывает средства и вместо этого создает сообщение.
auto является значением по умолчанию и означает, что модель может выбирать между созданием сообщения или вызовом средства.
Указание определенного инструмента, например {"type": "file_search"} или {"type": "function", "function": {"name": "my_function"}} принудительное вызов модели.
нет
инструменты массив Переопределите средства, которые помощник может использовать для этого запуска. Это полезно для изменения поведения на основе каждого запуска. нет
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1
стратегия усечения усечениеObject Определяет, как поток будет усечен до выполнения. Используйте это для управления начальным окном контекста выполнения. нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json runObject

Примеры

Пример

Создайте запуск.

POST https://{endpoint}/openai/threads/{thread_id}/runs?api-version=2025-04-01-preview

{
 "assistant_id": "asst_abc123"
}

Ответы: код состояния: 200

{
  "body": {
    "id": "run_abc123",
    "object": "thread.run",
    "created_at": 1699063290,
    "assistant_id": "asst_abc123",
    "thread_id": "thread_abc123",
    "status": "queued",
    "started_at": 1699063290,
    "expires_at": null,
    "cancelled_at": null,
    "failed_at": null,
    "completed_at": 1699063291,
    "last_error": null,
    "model": "gpt-4-turbo",
    "instructions": null,
    "incomplete_details": null,
    "tools": [
      {
        "type": "code_interpreter"
      }
    ],
    "metadata": {},
    "usage": null,
    "temperature": 1.0,
    "top_p": 1.0,
    "max_prompt_tokens": 1000,
    "max_completion_tokens": 1000,
    "truncation_strategy": {
      "type": "auto",
      "last_messages": null
    },
    "response_format": "auto",
    "tool_choice": "auto"
  }
}

Получить - Запустить

GET https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}?api-version=2025-04-01-preview

Извлекает запуск.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор выполняемых потоков.
идентификатор_запуска путь Да струна Идентификатор извлекаемого запуска.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json runObject

Примеры

Пример

Возвращает выполнение.

GET https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "run_HsO8tYM4K5AAMAHgK0J3om8Q",
    "object": "thread.run",
    "created_at": 1707303196,
    "assistant_id": "asst_JtTwHk28cIocgFXZPCBxhOzl",
    "thread_id": "thread_eRNwflE3ncDYak1np6MdMHJh",
    "status": "completed",
    "started_at": 1707303197,
    "expires_at": null,
    "cancelled_at": null,
    "failed_at": null,
    "completed_at": 1707303201,
    "last_error": null,
    "model": "gpt-4-1106-preview",
    "instructions": "You are an AI model that empowers every person and every organization on the planet to achieve more.",
    "tools": [],
    "file_ids": [],
    "metadata": {}
  }
}

Изменение — запуск

POST https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}?api-version=2025-04-01-preview

Изменяет выполнение.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор выполняемых потоков.
идентификатор_запуска путь Да струна Идентификатор запуска для изменения.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json runObject

Примеры

Пример

Изменяет выполнение.

POST https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}?api-version=2025-04-01-preview

{
 "metadata": {
  "user_id": "user_abc123"
 }
}

Ответы: код состояния: 200

{
  "body": {
    "id": "run_abc123",
    "object": "thread.run",
    "created_at": 1699075072,
    "assistant_id": "asst_abc123",
    "thread_id": "thread_abc123",
    "status": "completed",
    "started_at": 1699075072,
    "expires_at": null,
    "cancelled_at": null,
    "failed_at": null,
    "completed_at": 1699075073,
    "last_error": null,
    "model": "gpt-4-turbo",
    "instructions": null,
    "incomplete_details": null,
    "tools": [
      {
        "type": "code_interpreter"
      }
    ],
    "tool_resources": {
      "code_interpreter": {
        "file_ids": [
          "file-abc123",
          "file-abc456"
        ]
      }
    },
    "metadata": {
      "user_id": "user_abc123"
    },
    "usage": {
      "prompt_tokens": 123,
      "completion_tokens": 456,
      "total_tokens": 579
    },
    "temperature": 1.0,
    "top_p": 1.0,
    "max_prompt_tokens": 1000,
    "max_completion_tokens": 1000,
    "truncation_strategy": {
      "type": "auto",
      "last_messages": null
    },
    "response_format": "auto",
    "tool_choice": "auto"
  }
}

Отправка — выходные данные средства для запуска

POST https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}/submit_tool_outputs?api-version=2025-04-01-preview

Если выполнение имеет status: "requires_action" и required_action.type есть submit_tool_outputs, эта конечная точка может использоваться для отправки выходных данных из вызовов средства после их завершения. Все выходные данные должны быть отправлены в одном запросе.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор потоков, к которым принадлежит этот запуск.
идентификатор_запуска путь Да струна Идентификатор выполнения, требующего отправки результатов работы инструмента.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
поток булевый Если trueвозвращает поток событий, которые происходят во время событий запуска от имени сервера, завершая выполнение в состоянии терминала с сообщением data: [DONE] .
нет
выходные данные инструмента массив Список инструментов, для которых отправляются выходные данные. Да

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json runObject

Примеры

Пример

Если выполнение имеет status: "requires_action" и required_action.type есть submit_tool_outputs, эта конечная точка может использоваться для отправки выходных данных из вызовов средства после их завершения. Все выходные данные должны быть отправлены в одном запросе.

POST https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}/submit_tool_outputs?api-version=2025-04-01-preview

{
 "tool_outputs": [
  {
   "tool_call_id": "call_001",
   "output": "70 degrees and sunny."
  }
 ]
}

Ответы: код состояния: 200

{
  "body": {
    "id": "run_123",
    "object": "thread.run",
    "created_at": 1699075592,
    "assistant_id": "asst_123",
    "thread_id": "thread_123",
    "status": "queued",
    "started_at": 1699075592,
    "expires_at": 1699076192,
    "cancelled_at": null,
    "failed_at": null,
    "completed_at": null,
    "last_error": null,
    "model": "gpt-4-turbo",
    "instructions": null,
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_current_weather",
          "description": "Get the current weather in a given location",
          "parameters": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "description": "The city and state, e.g. San Francisco, CA"
              },
              "unit": {
                "type": "string",
                "enum": [
                  "celsius",
                  "fahrenheit"
                ]
              }
            },
            "required": [
              "location"
            ]
          }
        }
      }
    ],
    "metadata": {},
    "usage": null,
    "temperature": 1.0,
    "top_p": 1.0,
    "max_prompt_tokens": 1000,
    "max_completion_tokens": 1000,
    "truncation_strategy": {
      "type": "auto",
      "last_messages": null
    },
    "response_format": "auto",
    "tool_choice": "auto"
  }
}

Отмена — запуск

POST https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}/cancel?api-version=2025-04-01-preview

Отменяет запуск, который является in_progress.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор потока, к которому принадлежит этот запуск.
идентификатор_запуска путь Да струна Идентификатор запуска, который необходимо отменить.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json runObject

Примеры

Пример

Отменяет запуск, который является in_progress.

POST https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}/cancel?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "run_abc123",
    "object": "thread.run",
    "created_at": 1699076126,
    "assistant_id": "asst_abc123",
    "thread_id": "thread_abc123",
    "status": "cancelling",
    "started_at": 1699076126,
    "expires_at": 1699076726,
    "cancelled_at": null,
    "failed_at": null,
    "completed_at": null,
    "last_error": null,
    "model": "gpt-4-turbo",
    "instructions": "You summarize books.",
    "tools": [
      {
        "type": "file_search"
      }
    ],
    "tool_resources": {
      "file_search": {
        "vector_store_ids": [
          "vs_123"
        ]
      }
    },
    "metadata": {},
    "usage": null,
    "temperature": 1.0,
    "top_p": 1.0,
    "response_format": "auto"
  }
}

Список — шаги выполнения

GET https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}/steps?api-version=2025-04-01-preview

Возвращает список шагов выполнения, принадлежащих выполнению.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор потока, к которому относятся выполнение и шаги выполнения.
идентификатор_запуска путь Да струна Идентификатор запуска, к которому относятся шаги выполнения.
предел запрос нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.
заказ запрос нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для возрастания порядка и desc для убывания.
после запрос нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
перед запрос нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, начиная с obj_foo, следующий вызов может содержать before=obj_foo для получения предыдущей страницы списка.
версия API запрос Да струна
включить[] запрос нет массив Список дополнительных полей для включения в ответ. В настоящее время единственным поддерживаемым значением для получения содержимого результатов поиска файлов является step_details.tool_calls[*].file_search.results[*].content.

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json listRunStepsResponse

Примеры

Пример

Возвращает список шагов выполнения, принадлежащих выполнению.

GET https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}/steps?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "object": "list",
    "data": [
      {
        "id": "step_abc123",
        "object": "thread.run.step",
        "created_at": 1699063291,
        "run_id": "run_abc123",
        "assistant_id": "asst_abc123",
        "thread_id": "thread_abc123",
        "type": "message_creation",
        "status": "completed",
        "cancelled_at": null,
        "completed_at": 1699063291,
        "expired_at": null,
        "failed_at": null,
        "last_error": null,
        "step_details": {
          "type": "message_creation",
          "message_creation": {
            "message_id": "msg_abc123"
          }
        },
        "usage": {
          "prompt_tokens": 123,
          "completion_tokens": 456,
          "total_tokens": 579
        }
      }
    ],
    "first_id": "step_abc123",
    "last_id": "step_abc456",
    "has_more": false
  }
}

Получение — шаг выполнения

GET https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}/steps/{step_id}?api-version=2025-04-01-preview

Извлекает шаг выполнения.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
thread_id путь Да струна Идентификатор потока, к которому относятся выполнение и шаг выполнения.
идентификатор_запуска путь Да струна Идентификатор выполнения, к которому принадлежит шаг выполнения.
step_id путь Да струна Идентификатор шага выполнения, который требуется получить.
включить[] запрос нет массив Список дополнительных полей для включения в ответ. В настоящее время единственным поддерживаемым значением для получения содержимого результатов поиска файлов является step_details.tool_calls[*].file_search.results[*].content.
версия API запрос Да струна

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json runStepObject

Примеры

Пример

Извлекает шаг выполнения.

GET https://{endpoint}/openai/threads/{thread_id}/runs/{run_id}/steps/{step_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "step_abc123",
    "object": "thread.run.step",
    "created_at": 1699063291,
    "run_id": "run_abc123",
    "assistant_id": "asst_abc123",
    "thread_id": "thread_abc123",
    "type": "message_creation",
    "status": "completed",
    "cancelled_at": null,
    "completed_at": 1699063291,
    "expired_at": null,
    "failed_at": null,
    "last_error": null,
    "step_details": {
      "type": "message_creation",
      "message_creation": {
        "message_id": "msg_abc123"
      }
    },
    "usage": {
      "prompt_tokens": 123,
      "completion_tokens": 456,
      "total_tokens": 579
    }
  }
}

Список — векторные хранилища

GET https://{endpoint}/openai/vector_stores?api-version=2025-04-01-preview

Возвращает список хранилищ векторов.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
предел запрос нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.
заказ запрос нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для возрастания порядка и desc для убывания.
после запрос нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
перед запрос нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, начиная с obj_foo, следующий вызов может содержать before=obj_foo для получения предыдущей страницы списка.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json listVectorStoresResponse

Примеры

Пример

Возвращает список хранилищ векторов.

GET https://{endpoint}/openai/vector_stores?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "object": "list",
    "data": [
      {
        "id": "vs_abc123",
        "object": "vector_store",
        "created_at": 1699061776,
        "name": "Support FAQ",
        "bytes": 139920,
        "file_counts": {
          "in_progress": 0,
          "completed": 3,
          "failed": 0,
          "cancelled": 0,
          "total": 3
        }
      },
      {
        "id": "vs_abc456",
        "object": "vector_store",
        "created_at": 1699061776,
        "name": "Support FAQ v2",
        "bytes": 139920,
        "file_counts": {
          "in_progress": 0,
          "completed": 3,
          "failed": 0,
          "cancelled": 0,
          "total": 3
        }
      }
    ],
    "first_id": "vs_abc123",
    "last_id": "vs_abc456",
    "has_more": false
  }
}

Создание — векторное хранилище

POST https://{endpoint}/openai/vector_stores?api-version=2025-04-01-preview

Создайте векторное хранилище.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
стратегия разбивки на части autoChunkingStrategyRequestParam или staticChunkingStrategyRequestParam Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . Применимо только в том случае, если file_ids не пуст. нет
истекает через vectorStoreExpirationAfter Политика истечения срока действия для хранилища векторов. нет
идентификаторы_файлов массив Список идентификаторов файлов, которые следует использовать векторным хранилищем. Полезно для таких средств, как file_search доступ к файлам. нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
имя струна Имя векторного хранилища. нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreObject

Примеры

Пример

Создает векторное хранилище.

POST https://{endpoint}/openai/vector_stores?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "vs_abc123",
    "object": "vector_store",
    "created_at": 1699061776,
    "name": "Support FAQ",
    "bytes": 139920,
    "file_counts": {
      "in_progress": 0,
      "completed": 3,
      "failed": 0,
      "cancelled": 0,
      "total": 3
    }
  }
}

Get — Vector Store

GET https://{endpoint}/openai/vector_stores/{vector_store_id}?api-version=2025-04-01-preview

Извлекает векторное хранилище.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор извлекаемого хранилища векторов.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreObject

Примеры

Пример

Извлекает векторное хранилище.

GET https://{endpoint}/openai/vector_stores/{vector_store_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "vs_abc123",
    "object": "vector_store",
    "created_at": 1699061776
  }
}

Изменение — векторное хранилище

POST https://{endpoint}/openai/vector_stores/{vector_store_id}?api-version=2025-04-01-preview

Изменяет векторное хранилище.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор измененного хранилища векторов.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
истекает через vectorStoreExpirationAfter Политика истечения срока действия для хранилища векторов. нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
имя струна Имя векторного хранилища. нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreObject

Примеры

Пример

Изменяет векторное хранилище.

POST https://{endpoint}/openai/vector_stores/{vector_store_id}?api-version=2025-04-01-preview

{
 "name": "Support FAQ"
}

Ответы: код состояния: 200

{
  "body": {
    "id": "vs_abc123",
    "object": "vector_store",
    "created_at": 1699061776,
    "name": "Support FAQ",
    "bytes": 139920,
    "file_counts": {
      "in_progress": 0,
      "completed": 3,
      "failed": 0,
      "cancelled": 0,
      "total": 3
    }
  }
}

Удаление — векторное хранилище

DELETE https://{endpoint}/openai/vector_stores/{vector_store_id}?api-version=2025-04-01-preview

Удаление векторного хранилища.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор удаленного хранилища векторов.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json deleteVectorStoreResponse

Примеры

Пример

Удаляет векторное хранилище.

DELETE https://{endpoint}/openai/vector_stores/{vector_store_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "vs_abc123",
    "object": "vector_store.deleted",
    "deleted": true
  }
}

Список — файлы векторного хранилища

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/files?api-version=2025-04-01-preview

Возвращает список файлов векторного хранилища.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор хранилища векторов, к которому принадлежат файлы.
предел запрос нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.
заказ запрос нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для возрастания порядка и desc для убывания.
после запрос нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
перед запрос нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, начиная с obj_foo, следующий вызов может содержать before=obj_foo для получения предыдущей страницы списка.
фильтр запрос нет струна
Возможные значения: in_progress, , completedfailedcancelled
Фильтрация по состоянию файла. Один из in_progress, completed, failed, cancelled.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json listVectorStoreFilesResponse

Примеры

Пример

Возвращает список файлов векторного хранилища.

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/files?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "object": "list",
    "data": [
      {
        "id": "file-abc123",
        "object": "vector_store.file",
        "created_at": 1699061776,
        "vector_store_id": "vs_abc123"
      },
      {
        "id": "file-abc456",
        "object": "vector_store.file",
        "created_at": 1699061776,
        "vector_store_id": "vs_abc123"
      }
    ],
    "first_id": "file-abc123",
    "last_id": "file-abc456",
    "has_more": false
  }
}

Создание файла векторного хранилища

POST https://{endpoint}/openai/vector_stores/{vector_store_id}/files?api-version=2025-04-01-preview

Создайте файл векторного хранилища, вложив файл в векторное хранилище.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор векторного хранилища, для которого создается файл.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
стратегия разбивки на части chunkingStrategyRequestParam Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . нет
идентификатор_файла струна Идентификатор файла, который должен использовать хранилище векторов. Полезно для таких средств, как file_search доступ к файлам. Да

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreFileObject

Примеры

Пример

Создайте файл векторного хранилища, вложив файл в векторное хранилище.

POST https://{endpoint}/openai/vector_stores/{vector_store_id}/files?api-version=2025-04-01-preview

{
 "file_id": "file-abc123"
}

Ответы: код состояния: 200

{
  "body": {
    "id": "file-abc123",
    "object": "vector_store.file",
    "created_at": 1699061776,
    "usage_bytes": 1234,
    "vector_store_id": "vs_abcd",
    "status": "completed",
    "last_error": null
  }
}

Получение файла векторного хранилища

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/files/{file_id}?api-version=2025-04-01-preview

Извлекает файл векторного хранилища.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор векторного хранилища, к которому принадлежит файл.
идентификатор_файла путь Да струна Идентификатор извлекаемого файла.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreFileObject

Примеры

Пример

Извлекает файл векторного хранилища.

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/files/{file_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "file-abc123",
    "object": "vector_store.file",
    "created_at": 1699061776,
    "vector_store_id": "vs_abcd",
    "status": "completed",
    "last_error": null
  }
}

Delete — векторный файл хранилища

DELETE https://{endpoint}/openai/vector_stores/{vector_store_id}/files/{file_id}?api-version=2025-04-01-preview

Удаление файла векторного хранилища. Это приведет к удалению файла из векторного хранилища, но сам файл не будет удален. Чтобы удалить файл, используйте конечную точку удаления файла.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор векторного хранилища, к которому принадлежит файл.
идентификатор_файла путь Да струна Идентификатор удаленного файла.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json deleteVectorStoreFileResponse

Примеры

Пример

Удаление файла векторного хранилища. Это приведет к удалению файла из векторного хранилища, но сам файл не будет удален. Чтобы удалить файл, используйте конечную точку удаления файла.

DELETE https://{endpoint}/openai/vector_stores/{vector_store_id}/files/{file_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "file_abc123",
    "object": "vector_store.file.deleted",
    "deleted": true
  }
}

Обновить атрибуты файла векторного хранилища

POST https://{endpoint}/openai/vector_stores/{vector_store_id}/files/{file_id}?api-version=2025-04-01-preview

Обновление атрибутов в файле векторного хранилища.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор векторного хранилища, к которому принадлежит файл.
идентификатор_файла путь Да струна Идентификатор файла для обновления атрибутов.

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
атрибуты VectorStoreFileAttributes Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами.
Да

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreFileObject

Получение содержимого файла векторного хранилища

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/files/{file_id}/content?api-version=2025-04-01-preview

Извлеките проанализированное содержимое файла векторного хранилища.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор хранилища векторов.
идентификатор_файла путь Да струна Идентификатор файла в хранилище векторов.

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json VectorStoreFileContentResponse

Хранилище векторов поиска

POST https://{endpoint}/openai/vector_stores/{vector_store_id}/search?api-version=2025-04-01-preview

Поиск векторного хранилища соответствующих блоков на основе фильтра атрибутов запроса и файла.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор хранилища векторов для поиска.

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
фильтры ComparisonFilter или CompoundFilter Фильтр для применения на основе атрибутов файла. нет
максимальное_количество_результатов целое число Максимальное количество отображаемых результатов. Это число должно быть от 1 до 50 включительно. нет 10
запрос строка или массив Строка запроса для поиска Да
опции рейтинга объект Параметры ранжирования для поиска. нет
Рангер └️ перечисление
Возможные значения: auto, default-2024-11-15
нет
└─ порог оценки число/номер нет 0
переписать запрос булевый Следует ли переписать запрос естественного языка для векторного поиска. нет Неправда

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json VectorStoreSearchResultsPage

Создание пакета файлов векторного хранилища

POST https://{endpoint}/openai/vector_stores/{vector_store_id}/file_batches?api-version=2025-04-01-preview

Создайте пакет файла векторного хранилища.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор векторного хранилища, для которого создается пакет файлов.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
стратегия разбивки на части chunkingStrategyRequestParam Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . нет
идентификаторы_файлов массив Список идентификаторов файлов, которые следует использовать векторном хранилище. Полезно для таких средств, как file_search доступ к файлам. Да

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreFileBatchObject

Примеры

Пример

Создайте пакет файла векторного хранилища.

POST https://{endpoint}/openai/vector_stores/{vector_store_id}/file_batches?api-version=2025-04-01-preview

{
 "file_ids": [
  "file-abc123",
  "file-abc456"
 ]
}

Ответы: код состояния: 200

{
  "id": "vsfb_abc123",
  "object": "vector_store.file_batch",
  "created_at": 1699061776,
  "vector_store_id": "vs_abc123",
  "status": "in_progress",
  "file_counts": {
    "in_progress": 1,
    "completed": 1,
    "failed": 0,
    "cancelled": 0,
    "total": 0
  }
}

Получение пакета файлов векторного хранилища

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/file_batches/{batch_id}?api-version=2025-04-01-preview

Извлекает пакет файла векторного хранилища.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор хранилища векторов, к которому принадлежит пакет файла.
batch_id путь Да струна Идентификатор извлекаемого пакета файлов.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreFileBatchObject

Примеры

Пример

Извлекает пакет файла векторного хранилища.

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/file_batches/{batch_id}?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "vsfb_abc123",
    "object": "vector_store.file_batch",
    "created_at": 1699061776,
    "vector_store_id": "vs_abc123",
    "status": "in_progress",
    "file_counts": {
      "in_progress": 1,
      "completed": 1,
      "failed": 0,
      "cancelled": 0,
      "total": 0
    }
  }
}

Отмена — пакет файла векторного хранилища

POST https://{endpoint}/openai/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel?api-version=2025-04-01-preview

Отмена пакета файла векторного хранилища. Это пытается отменить обработку файлов в этом пакете как можно скорее.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор хранилища векторов, к которому принадлежит пакет файла.
batch_id путь Да струна Идентификатор партии файлов, которую нужно отменить.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json vectorStoreFileBatchObject

Примеры

Пример

Отмена пакета файла векторного хранилища. Это пытается отменить обработку файлов в этом пакете как можно скорее.

POST https://{endpoint}/openai/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "id": "vsfb_abc123",
    "object": "vector_store.file_batch",
    "created_at": 1699061776,
    "vector_store_id": "vs_abc123",
    "status": "cancelling",
    "file_counts": {
      "in_progress": 12,
      "completed": 3,
      "failed": 0,
      "cancelled": 0,
      "total": 15
    }
  }
}

Список — пакетные файлы векторного хранилища

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/file_batches/{batch_id}/files?api-version=2025-04-01-preview

Возвращает список файлов векторного хранилища в пакете.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_хранилища_векторов путь Да струна Идентификатор хранилища векторов, к которому принадлежат файлы.
batch_id путь Да струна Идентификатор пакета файлов, к которому принадлежат файлы.
предел запрос нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.
заказ запрос нет струна
Возможные значения: asc, desc
Сортировка объектов по их метке времени created_at. asc для возрастания порядка и desc для убывания.
после запрос нет струна Курсор для использования в разбиении на страницы. after — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка.
перед запрос нет струна Курсор для использования в разбиении на страницы. before — это идентификатор объекта, определяющий место в списке. Например, если вы делаете запрос списка и получаете 100 объектов, начиная с obj_foo, следующий вызов может содержать before=obj_foo для получения предыдущей страницы списка.
фильтр запрос нет струна
Возможные значения: in_progress, , completedfailedcancelled
Фильтрация по состоянию файла. Один из in_progress, completed, failed, cancelled.
версия API запрос Да струна версия API

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json listVectorStoreFilesResponse

Примеры

Пример

Возвращает список файлов векторного хранилища.

GET https://{endpoint}/openai/vector_stores/{vector_store_id}/file_batches/{batch_id}/files?api-version=2025-04-01-preview

Ответы: код состояния: 200

{
  "body": {
    "object": "list",
    "data": [
      {
        "id": "file-abc123",
        "object": "vector_store.file",
        "created_at": 1699061776,
        "vector_store_id": "vs_abc123"
      },
      {
        "id": "file-abc456",
        "object": "vector_store.file",
        "created_at": 1699061776,
        "vector_store_id": "vs_abc123"
      }
    ],
    "first_id": "file-abc123",
    "last_id": "file-abc456",
    "has_more": false
  }
}

Создание: Realtimesession

POST https://{endpoint}/openai/realtimeapi/sessions?api-version=2025-04-01-preview

Создайте временный маркер API для использования в клиентских приложениях с API Realtime. Можно настроить с такими же параметрами сеанса, как и у события клиента session.update. Она возвращает объект сеанса и ключ client_secret, содержащий временный токен для API, который можно использовать для проверки подлинности клиентов браузера для API Реального времени.

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
формат_входного_аудио перечисление Формат входного звука. Параметры: pcm16, g711_ulawили g711_alaw.
Для pcm16 входной звук должен быть 16-разрядным PCM с частотой выборки 24 кГц, одним каналом (моно) и младшим порядком байтов.

Возможные значения: pcm16, g711_ulawg711_alaw
нет
подавление шума входного аудиосигнала объект Настройка для уменьшения шума входного звука. Чтобы отключить, это можно установить на null.
Фильтры для уменьшения шума обрабатывают звук, добавленный во входной звуковой буфер перед отправкой в VAD и модель.
Фильтрация звука может повысить точность обнаружения VAD и поворота (уменьшая ложные срабатывания) и производительность модели, повышая восприятие входного звука.
нет
└─ Тип перечисление Тип уменьшения шума. near_field предназначен для микрофонов близкого разговора, таких как наушники, far_field предназначен для микрофонов с дальним полем, таких как ноутбук или микрофоны конференц-зала.

Возможные значения: near_field, far_field
нет
ввод стенограммы аудио объект Настройка транскрибирования входного аудио, по умолчанию отключена и может быть установлена на null, чтобы отключить аудиотранскрибирование после включения. Транскрибирование входного звука не является собственным для модели, так как модель использует звук напрямую. Транскрибирование выполняется асинхронно через конечную точку транскрибирования и должно рассматриваться как руководство по входным звуковым содержимым, а не точно то, что слышала модель. Клиент может при необходимости задать язык и запрашивать транскрибирование, они предлагают дополнительные рекомендации для службы транскрибирования.
нет
└─ язык струна Язык входного звука. Предоставление языка ввода в формате ISO-639-1 (например en, ) повышает точность и задержку.
нет
└─ Модель струна Модель, используемая для транскрибирования, текущие параметры: gpt-4o-transcribeи gpt-4o-mini-transcribewhisper-1.
нет
└─ Запрос струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука.
Для whisper-1этого запрос — это список ключевых слов.
Для gpt-4o-transcribe моделей запрос — это произвольная текстовая строка (например, "ожидайте слова, связанные с технологией").
нет
инструкции струна Системные инструкции по умолчанию (т. е. системное сообщение) предопределены для вызовов модели. Это поле позволяет клиенту управлять моделью по нужным ответам. Модель может быть настроена по формату и содержанию ответа (например, "быть чрезвычайно кратким", "вести себя дружелюбно", "вот примеры хороших ответов") и на звуковое поведение (например, "говорить быстро", "вносить в голос эмоции", "смеяться часто"). Нет гарантии, что модель будет следовать инструкциям, но они служат для нее руководством по желаемому поведению.

Обратите внимание, что сервер задает инструкции по умолчанию, которые будут использоваться, если это поле не задано, и которые видны в событии session.created в начале сеанса.
нет
максимальное_количество_токенов_вывода_ответа целое число или строка Максимальное количество выходных маркеров для одного ответа помощника, включающее вызовы инструментов. Укажите целое число от 1 до 4096, чтобы ограничить выходные маркеры или inf максимальные доступные маркеры для данной модели. По умолчанию — inf.
нет
Условия Набор модальностей, с которыми может реагировать модель. Чтобы отключить звук, установите для этого значение ["text"].
нет
модель струна Имя развертывания, используемого для этого сеанса.
нет
формат_выходного_аудио перечисление Формат выходного звука. Параметры: pcm16, g711_ulawили g711_alaw.
Для pcm16 выходного аудио частота дискретизации составляет 24 кГц.

Возможные значения: pcm16, g711_ulawg711_alaw
нет
Температура число/номер Температура выборки для модели ограничена [0.6, 1.2]. Для звуковых моделей температура 0,8 настоятельно рекомендуется для оптимальной производительности.
нет 0,8
выбор инструмента струна Как модель выбирает инструменты. Параметры: auto, nonerequiredили укажите функцию.
нет авто
инструменты массив Средства (функции), доступные для модели. нет
обнаружение поворотов объект Конфигурация для обнаружения поворота, VAD или семантического VAD сервера эфира. Это можно установить в null для отключения, в этом случае клиент должен вручную активировать реакцию модели.
VAD на сервере означает, что модель будет обнаруживать начало и конец речи на основе громкости звука и отвечать в конце речи пользователя.
Семантическая VAD более совершенная и использует модель обнаружения смены реплик (в сочетании с VAD), чтобы семантически оценить, закончил ли пользователь говорить, а затем динамически устанавливает тайм-аут на основе этой вероятности. Например, если пользователь отключает аудиозапись, uhhmмодель будет оценить низкую вероятность завершения и ждать больше времени, пока пользователь продолжит говорить. Это может быть полезно для более естественных бесед, но может иметь более высокую задержку.
нет
└─create_response булевый Следует ли автоматически создавать ответ при возникновении события остановки VAD.
нет Верно
└─ рвение перечисление Только для режима semantic_vad используется. Стремление модели реагировать. low будет ждать, пока пользователь продолжит говорить, high будет реагировать быстрее. auto значение по умолчанию и эквивалентно medium.

Возможные значения: low, , mediumhighauto
нет
└interrupt_response булевый Следует ли автоматически прерывать любой текущий ответ с выходными данными беседы по умолчанию (т. е. conversationautoпри возникновении события запуска VAD).
нет Верно
└prefix_padding_ms целое число Только для режима server_vad используется. Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). Значение по умолчанию — 300 мс.
нет
└️ silence_duration_ms целое число Только для режима server_vad используется. Длительность молчания для обнаружения остановки речи (в миллисекундах). Значение по умолчанию — 500 мс. С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя.
нет
Пороговое значение └️ число/номер Только для режима server_vad используется. Порог активации для VAD (0.0 до 1.0), по умолчанию используется значение 0.5. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах.
нет
└─ Тип перечисление Тип обнаружения поворота.

Возможные значения: server_vad, semantic_vad
нет
голос VoiceIdsShared нет

Ответы

Код состояния: 200

Описание: сеанс успешно создан.

Тип содержимого Тип Описание
application/json RealtimeSessionCreateResponse

Создание — транскрипция сессии в реальном времени

POST https://{endpoint}/openai/realtimeapi/transcription_sessions?api-version=2025-04-01-preview

Создайте эфемерный маркер API для использования в клиентских приложениях с API Реального времени специально для транскрибирования в режиме реального времени. Можно настроить с такими же параметрами сеанса, как и у события клиента transcription_session.update. Она возвращает объект сеанса и ключ client_secret, содержащий временный токен для API, который можно использовать для проверки подлинности клиентов браузера для API Реального времени.

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
включать массив Набор элементов для включения в транскрибирование. Текущие доступные элементы:
- item.input_audio_transcription.logprobs
нет
формат_входного_аудио перечисление Формат входного звука. Параметры: pcm16, g711_ulawили g711_alaw.
Для pcm16 входной звук должен быть 16-разрядным PCM с частотой выборки 24 кГц, одним каналом (моно) и младшим порядком байтов.

Возможные значения: pcm16, g711_ulawg711_alaw
нет
подавление шума входного аудиосигнала объект Настройка для уменьшения шума входного звука. Чтобы отключить, это можно установить на null.
Фильтры для уменьшения шума обрабатывают звук, добавленный во входной звуковой буфер перед отправкой в VAD и модель.
Фильтрация звука может повысить точность обнаружения VAD и поворота (уменьшая ложные срабатывания) и производительность модели, повышая восприятие входного звука.
нет
└─ Тип перечисление Тип уменьшения шума. near_field предназначен для микрофонов близкого разговора, таких как наушники, far_field предназначен для микрофонов с дальним полем, таких как ноутбук или микрофоны конференц-зала.

Возможные значения: near_field, far_field
нет
ввод стенограммы аудио объект Конфигурация входного транскрибирования звука. Клиент может при необходимости задать язык и запрашивать транскрибирование, они предлагают дополнительные рекомендации для службы транскрибирования.
нет
└─ язык струна Язык входного звука. Предоставление языка ввода в формате ISO-639-1 (например en, ) повышает точность и задержку.
нет
└─ Модель перечисление Модель, используемая для транскрибирования, текущие параметры: gpt-4o-transcribeи gpt-4o-mini-transcribewhisper-1.

Возможные значения: gpt-4o-transcribe, gpt-4o-mini-transcribewhisper-1
нет
└─ Запрос струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука.
Для whisper-1этого запрос — это список ключевых слов.
Для gpt-4o-transcribe моделей запрос — это произвольная текстовая строка (например, "ожидайте слова, связанные с технологией").
нет
Условия Набор модальностей, с которыми может реагировать модель. Чтобы отключить звук, установите для этого значение ["text"].
нет
обнаружение поворотов объект Конфигурация для обнаружения поворота, VAD или семантического VAD сервера эфира. Это можно установить в null для отключения, в этом случае клиент должен вручную активировать реакцию модели.
VAD на сервере означает, что модель будет обнаруживать начало и конец речи на основе громкости звука и отвечать в конце речи пользователя.
Семантическая VAD более совершенная и использует модель обнаружения смены реплик (в сочетании с VAD), чтобы семантически оценить, закончил ли пользователь говорить, а затем динамически устанавливает тайм-аут на основе этой вероятности. Например, если пользователь отключает аудиозапись, uhhmмодель будет оценить низкую вероятность завершения и ждать больше времени, пока пользователь продолжит говорить. Это может быть полезно для более естественных бесед, но может иметь более высокую задержку.
нет
└─create_response булевый Следует ли автоматически создавать ответ при возникновении события остановки VAD. Недоступно для сеансов транскрибирования.
нет Верно
└─ рвение перечисление Только для режима semantic_vad используется. Стремление модели реагировать. low будет ждать, пока пользователь продолжит говорить, high будет реагировать быстрее. auto значение по умолчанию и эквивалентно medium.

Возможные значения: low, , mediumhighauto
нет
└interrupt_response булевый Следует ли автоматически прерывать любой текущий ответ с выходными данными беседы по умолчанию (т. е. conversationautoпри возникновении события запуска VAD). Недоступно для сеансов транскрибирования.
нет Верно
└prefix_padding_ms целое число Только для режима server_vad используется. Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). Значение по умолчанию — 300 мс.
нет
└️ silence_duration_ms целое число Только для режима server_vad используется. Длительность молчания для обнаружения остановки речи (в миллисекундах). Значение по умолчанию — 500 мс. С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя.
нет
Пороговое значение └️ число/номер Только для режима server_vad используется. Порог активации для VAD (0.0 до 1.0), по умолчанию используется значение 0.5. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах.
нет
└─ Тип перечисление Тип обнаружения поворота.

Возможные значения: server_vad, semantic_vad
нет

Ответы

Код состояния: 200

Описание: сеанс успешно создан.

Тип содержимого Тип Описание
application/json RealtimeTranscriptionSessionCreateResponse

Ответы

POST https://{endpoint}/openai/responses?api-version=2025-04-01-preview

Создает модельный ответ.

Тело запроса

Content-Type: application/json

Имя Тип Описание Обязательно По умолчанию
включать массив нет
ввод строка или массив Входные данные модели Да
инструкции струна Вставляет сообщение системы (или разработчика) в качестве первого элемента в контексте модели.

При использовании вместе с previous_response_idэтим инструкции из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах.
нет
максимальное_число_токенов целое число Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и состояние беседы.
нет
вызовы инструмента в параллельном режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно.
нет Верно
предыдущий_идентификатор_ответа струна Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. Узнайте больше о состоянии беседы.
нет
рассуждение Рассуждение Только модели o-серии

Параметры конфигурации для моделей рассуждений.
нет
магазин булевый Следует ли хранить созданный ответ модели для последующего получения через API.
нет Верно
поток булевый Если задано значение true, данные ответа модели будут передаваться клиенту по мере его создания с помощью событий, отправляемых сервером.
См. ниже раздел "Потоковая передача" для получения дополнительной информации.
нет Неправда
текст объект Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. Подробнее:
— текстовые входные и выходные данные
— структурированные выходные данные
нет
└─ Формат TextResponseFormatConfiguration Объект, указывающий формат, который должен выводить модель.

Настройка { "type": "json_schema" } включает структурированные выходные данные, что гарантирует, что модель будет соответствовать предоставленной схеме JSON.

Формат по умолчанию — это { "type": "text" } без дополнительных параметров.

Не рекомендуется использовать для gpt-4o и более новых моделей:

Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его.
нет
выбор инструмента ToolChoiceOptions или ToolChoiceTypes или ToolChoiceFunction Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать.
нет
инструменты массив Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.

Ниже приведены две категории инструментов, которые можно предоставить модели:

- Встроенные инструменты: инструменты, предоставляемые OpenAI для расширения
Возможности модели
нет
усечение перечисление Стратегия усечения, которую следует использовать для генерирования ответа модели.
- auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.
- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.

Возможные значения: auto, disabled
нет

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json ответ
текст/поток-события responseStreamEvent

Код состояния: по умолчанию

Описание: служба недоступна

Тип содержимого Тип Описание
application/json errorResponse

API ответов — входные элементы

GET https://{endpoint}/openai/responses/{response_id}?api-version=2025-04-01-preview

Извлекает ответ модели с заданным идентификатором.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_ответа путь Да струна Идентификатор полученного ответа.
включать запрос нет массив Дополнительные поля для включения в ответ. Более подробную информацию см. выше в параметре создания ответа include.

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json ответ

Код состояния: по умолчанию

Описание: служба недоступна

Тип содержимого Тип Описание
application/json errorResponse

Удаление ответа

DELETE https://{endpoint}/openai/responses/{response_id}?api-version=2025-04-01-preview

Удаляет ответ модели с заданным идентификатором.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_ответа путь Да струна Идентификатор ответа для удаления.

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Код состояния: 404

Описание: не найдено

Тип содержимого Тип Описание
application/json ошибка

Код состояния: по умолчанию

Описание: служба недоступна

Тип содержимого Тип Описание
application/json errorResponse

API ответов — список элементов ответа

GET https://{endpoint}/openai/responses/{response_id}/input_items?api-version=2025-04-01-preview

Возвращает список входных элементов для заданного ответа.

Параметры URI

Имя В Обязательно Тип Описание
конечная точка путь Да URL-адрес строки Поддерживаемые конечные точки Azure OpenAI (протокол и имя узла, например: https://aoairesource.openai.azure.com Замените aoairesource именем ресурса Azure OpenAI. https://{your-resource-name}.openai.azure.com
идентификатор_ответа путь Да струна Идентификатор ответа, чтобы извлечь входные элементы.
предел запрос нет целое число Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20.
заказ запрос нет струна
Возможные значения: asc, desc
Порядок, в котором следует возвращать входные элементы. По умолчанию — asc.
- asc: возвращает входные элементы в порядке возрастания.
- desc: возвращает входные элементы в порядке убывания.
после запрос нет струна Идентификатор элемента для перечисления элементов после, используемый в разбиении на страницы.
перед запрос нет струна Идентификатор элемента, по которому будут перечислены предыдущие элементы, используемый для постраничной навигации.

Заголовок запроса

Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.

Имя Обязательно Тип Описание
Авторизация Верно струна Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}

Чтобы создать маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.com

Тип: oauth2
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
размах: https://cognitiveservices.azure.com/.default
API-ключ Верно струна Укажите здесь ключ API OpenAI для Azure

Ответы

Код состояния: 200

Описание: ОК

Тип содержимого Тип Описание
application/json responseItemList

Компоненты

ответ ошибки

Имя Тип Описание Обязательно По умолчанию
ошибка ошибка нет

errorBase

Имя Тип Описание Обязательно По умолчанию
код струна нет
сообщение струна нет

ошибка

Имя Тип Описание Обязательно По умолчанию
внутренняя ошибка innerError Внутренняя ошибка с дополнительными сведениями. нет
параметр струна нет
тип струна нет

внутренняя ошибка

Внутренняя ошибка с дополнительными сведениями.

Имя Тип Описание Обязательно По умолчанию
код innerErrorCode Коды ошибок для внутреннего объекта ошибки. нет
результаты фильтрации контента contentFilterPromptResults Сведения о категории фильтрации содержимого (ненавидимая, сексуальность, насилие, self_harm), если она обнаружена, а также уровень серьезности (very_low, низкий, средний, высокомасштабируемый, определяющий интенсивность и уровень риска вредного содержимого) и если он был отфильтрован или нет. Сведения о содержимом и ненормативной лексике, если он обнаружен, и если он был отфильтрован или нет. И сведения о списке блокировок клиента, если он был отфильтрован и его идентификатор. нет

внутреннийКодОшибки

Коды ошибок для внутреннего объекта ошибки.

Недвижимость Ценность
Описание Коды ошибок для внутреннего объекта ошибки.
Тип струна
Значения ResponsibleAIPolicyViolation

dalleErrorResponse

Имя Тип Описание Обязательно По умолчанию
ошибка ошибка Dalle нет

dalleError

Имя Тип Описание Обязательно По умолчанию
внутренняя ошибка dalleInnerError Внутренняя ошибка с дополнительными сведениями. нет
параметр струна нет
тип струна нет

dalleInnerError

Внутренняя ошибка с дополнительными сведениями.

Имя Тип Описание Обязательно По умолчанию
код innerErrorCode Коды ошибок для внутреннего объекта ошибки. нет
результаты фильтрации контента dalleFilterResults Сведения о категории фильтрации содержимого (ненавидимая, сексуальность, насилие, self_harm), если она обнаружена, а также уровень серьезности (very_low, низкий, средний, высокомасштабируемый, определяющий интенсивность и уровень риска вредного содержимого) и если он был отфильтрован или нет. Сведения о содержимом и ненормативной лексике, если он обнаружен, и если он был отфильтрован или нет. И сведения о списке блокировок клиента, если он был отфильтрован и его идентификатор. нет
пересмотренный_запрос струна Запрос, который использовался для создания образа, если в запросе была любая редакция. нет

Текстовое поле завершения фильтра контента

Описывает диапазон в созданном тексте завершения. Смещение 0 является первой точкой кода UTF32 текста завершения.

Имя Тип Описание Обязательно По умолчанию
смещение_конца_завершения целое число Смещение первой точки кода UTF32, которая исключается из диапазона. Это поле всегда равно completion_start_offset для пустых диапазонов. Это поле всегда больше completion_start_offset для непустых диапазонов. Да
смещение_начала_завершения целое число Смещение точки кода UTF32, которая начинает диапазон. Да

базовыйРезультатФильтрацииКонтента

Имя Тип Описание Обязательно По умолчанию
отфильтрованный булевый Да

Результат фильтрации по степени тяжести

Имя Тип Описание Обязательно По умолчанию
отфильтрованный булевый Да
суровость струна нет

Обнаружен результат фильтра контента

Имя Тип Описание Обязательно По умолчанию
Обнаружены булевый нет
отфильтрованный булевый Да

Обнаружен фильтр контента с результатом цитирования

Имя Тип Описание Обязательно По умолчанию
цитата объект нет
URL-адрес струна нет
Лицензия струна нет

обнаружение фильтрации контента с завершением текстовых диапазонов

Имя Тип Описание Обязательно По умолчанию
подробности массив нет

Результат фильтрации контента по идентификатору

Имя Тип Описание Обязательно По умолчанию
отфильтрованный булевый Да
идентификатор струна нет

основаРезультатовФильтраКонтента

Сведения о результатах фильтрации содержимого.

Имя Тип Описание Обязательно По умолчанию
настраиваемые списки блокировок ДетализированныеРезультатыФильтраСодержания Результаты фильтрации содержимого с подробными сведениями о идентификаторах фильтра содержимого для отфильтрованных сегментов. нет
ошибка errorBase нет
ненавидеть результат тяжести фильтрации контента нет
богохульство Результат обнаружения фильтра контента нет
самоповреждение результат тяжести фильтрации контента нет
половой результат тяжести фильтрации контента нет
насилие результат тяжести фильтрации контента нет

результаты контентного фильтра запроса

Сведения о категории фильтрации содержимого (ненавидимая, сексуальность, насилие, self_harm), если она обнаружена, а также уровень серьезности (very_low, низкий, средний, высокомасштабируемый, определяющий интенсивность и уровень риска вредного содержимого) и если он был отфильтрован или нет. Сведения о содержимом и ненормативной лексике, если он обнаружен, и если он был отфильтрован или нет. И сведения о списке блокировок клиента, если он был отфильтрован и его идентификатор.

Имя Тип Описание Обязательно По умолчанию
настраиваемые списки блокировок ДетализированныеРезультатыФильтраСодержания Результаты фильтрации содержимого с подробными сведениями о идентификаторах фильтра содержимого для отфильтрованных сегментов. нет
ошибка errorBase нет
ненавидеть результат тяжести фильтрации контента нет
косвенная атака Результат обнаружения фильтра контента нет
Джейлбрейк Результат обнаружения фильтра контента нет
богохульство Результат обнаружения фильтра контента нет
самоповреждение результат тяжести фильтрации контента нет
половой результат тяжести фильтрации контента нет
насилие результат тяжести фильтрации контента нет

результатыВыбораФильтраКонтента

Сведения о категории фильтрации содержимого (ненавидимая, сексуальность, насилие, self_harm), если она обнаружена, а также уровень серьезности (very_low, низкий, средний, высокомасштабируемый, определяющий интенсивность и уровень риска вредного содержимого) и если он был отфильтрован или нет. Сведения о стороннем тексте и ненормативной лексике, если он обнаружен, и если он был отфильтрован или нет. И сведения о списке блокировок клиента, если он был отфильтрован и его идентификатор.

Имя Тип Описание Обязательно По умолчанию
настраиваемые списки блокировок ДетализированныеРезультатыФильтраСодержания Результаты фильтрации содержимого с подробными сведениями о идентификаторах фильтра содержимого для отфильтрованных сегментов. нет
ошибка errorBase нет
ненавидеть результат тяжести фильтрации контента нет
богохульство Результат обнаружения фильтра контента нет
код_защищённого_материала Обнаружен фильтр контента с результатом цитирования нет
защищённый_текст_материала Результат обнаружения фильтра контента нет
самоповреждение результат тяжести фильтрации контента нет
половой результат тяжести фильтрации контента нет
непроводящий материал РезультатОбнаруженияКонтентногоФильтраСТекстовымиСпанами нет
насилие результат тяжести фильтрации контента нет

Подробные результаты фильтрации контента

Результаты фильтрации содержимого с подробными сведениями о идентификаторах фильтра содержимого для отфильтрованных сегментов.

Имя Тип Описание Обязательно По умолчанию
подробности массив нет
отфильтрованный булевый Да

результат фильтрации запроса

Результаты фильтрации содержимого для одного запроса.

Имя Тип Описание Обязательно По умолчанию
результаты фильтрации контента contentFilterPromptResults Сведения о категории фильтрации содержимого (ненавидимая, сексуальность, насилие, self_harm), если она обнаружена, а также уровень серьезности (very_low, низкий, средний, высокомасштабируемый, определяющий интенсивность и уровень риска вредного содержимого) и если он был отфильтрован или нет. Сведения о содержимом и ненормативной лексике, если он обнаружен, и если он был отфильтрован или нет. И сведения о списке блокировок клиента, если он был отфильтрован и его идентификатор. нет
индекс_подсказки целое число нет

фильтрация результатов

Результаты фильтрации содержимого для нуля или более запросов в запросе. В запросе потоковой передачи результаты для различных запросов могут поступать в разное время или в разных заказах.

Для этого компонента не определены свойства.

РезультатыФильтрацииКонтентаDalle

Сведения о результатах фильтрации содержимого.

Имя Тип Описание Обязательно По умолчанию
ненавидеть результат тяжести фильтрации контента нет
самоповреждение результат тяжести фильтрации контента нет
половой результат тяжести фильтрации контента нет
насилие результат тяжести фильтрации контента нет

Результаты фильтрации dalle

Сведения о категории фильтрации содержимого (ненавидимая, сексуальность, насилие, self_harm), если она обнаружена, а также уровень серьезности (very_low, низкий, средний, высокомасштабируемый, определяющий интенсивность и уровень риска вредного содержимого) и если он был отфильтрован или нет. Сведения о содержимом и ненормативной лексике, если он обнаружен, и если он был отфильтрован или нет. И сведения о списке блокировок клиента, если он был отфильтрован и его идентификатор.

Имя Тип Описание Обязательно По умолчанию
настраиваемые списки блокировок ДетализированныеРезультатыФильтраСодержания Результаты фильтрации содержимого с подробными сведениями о идентификаторах фильтра содержимого для отфильтрованных сегментов. нет
ненавидеть результат тяжести фильтрации контента нет
Джейлбрейк Результат обнаружения фильтра контента нет
богохульство Результат обнаружения фильтра контента нет
самоповреждение результат тяжести фильтрации контента нет
половой результат тяжести фильтрации контента нет
насилие результат тяжести фильтрации контента нет

Общий запрос на завершение чата

Имя Тип Описание Обязательно По умолчанию
штраф за частоту число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры на основе их существующей частоты в тексте до сих пор, уменьшая вероятность повторения модели той же строки дословно. нет 0
логит_биас объект Изменяет вероятность появления указанных маркеров в завершении. Принимает объект JSON, который сопоставляет маркеры (указанные идентификатором маркера в токенизаторе) со связанным значением предвзятости от -100 до 100. С математической точки зрения смещение добавляется к логитам, созданным моделью до выборки. Точный эффект зависит от модели, но значения от –1 до 1 должны уменьшать или увеличивать вероятность выбора; такие значения, как –100 или 100, должны приводить к запрету или эксклюзивному выбору соответствующего маркера. нет
max_completion_tokens (максимальное количество токенов завершения) целое число Верхняя граница для числа маркеров, которые можно создать для завершения, включая видимые выходные маркеры и маркеры причин. Это поддерживается только в моделях серии o1. Расширит поддержку других моделей в будущем выпуске API. нет
макс_токены целое число Максимальное количество маркеров, разрешенных для созданного ответа. По умолчанию число маркеров, возвращаемых моделью, будет (4096 — маркеры запроса). Это несовместимо с моделями серии o1. нет 4096
метаданные объект Определяемые разработчиком теги и значения, используемые для фильтрации завершений на панели мониторинга хранимых завершений. нет
штраф за присутствие число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры в зависимости от того, появляются ли они в тексте до сих пор, что повышает вероятность того, что модель будет говорить о новых темах. нет 0
остановка строка или массив До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры. нет
магазин булевый Независимо от того, следует ли хранить выходные данные этого запроса на завершение чата для использования в наших продуктах для дистилляции или оценки модели. нет
поток булевый Если задано, будут отправляться частичные разностные сообщения, например в ChatGPT. Маркеры будут отправляться как события, отправленные сервером только для данных, как они становятся доступными, при этом поток завершается сообщением data: [DONE] . нет Неправда
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
Как правило, мы рекомендуем изменить это или top_p не оба.
нет 1
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.
Как правило, мы рекомендуем изменить это или temperature не оба.
нет 1
Пользователь струна Уникальный идентификатор, представляющий пользователя, который может помочь Azure OpenAI отслеживать и обнаруживать злоупотребления. нет

СоздатьЗапросЗавершения

Имя Тип Описание Обязательно По умолчанию
Лучшее из целое число best_of Создает завершения на стороне сервера и возвращает "лучший" (один с наибольшей вероятностью журнала на токен). Потоковую передачу результатов выполнить нельзя.

При использовании с n, параметр best_of определяет количество возможных завершений, а n указывает, сколько следует вернуть. best_of должно быть больше n.

Примечание. Так как этот параметр создает множество завершений, он может быстро использовать квоту маркера. Используйте тщательно и убедитесь, что у вас есть разумные параметры для max_tokens и stop.
нет 1
эхо булевый Возвращает запрос в дополнение к завершению
нет Неправда
штраф за частоту число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры на основе их существующей частоты в тексте до сих пор, уменьшая вероятность повторения модели той же строки дословно.
нет 0
логит_биас объект Изменяет вероятность появления указанных маркеров в завершении.

Принимает объект JSON, который сопоставляет маркеры (указанные идентификатором маркера в маркеризаторе GPT) с соответствующим значением предвзятости от -100 до 100. С математической точки зрения смещение добавляется к логитам, созданным моделью до выборки. Точный эффект зависит от модели, но значения от –1 до 1 должны уменьшать или увеличивать вероятность выбора; такие значения, как –100 или 100, должны приводить к запрету или эксклюзивному выбору соответствующего маркера.

Например, можно передать {"50256": -100} маркер |endoftext|< для предотвращения >создания маркера |endoftext.
нет Отсутствует
logprobs целое число Включите вероятности журнала в logprobs наиболее вероятные выходные маркеры, а также выбранные маркеры. Например, если logprobs значение равно 5, API вернет список из 5 наиболее вероятных маркеров. API всегда возвращает logprob пример маркера, поэтому в ответе может быть до logprobs+1 элементов.

Максимальное значение logprobs для 5.
нет Отсутствует
макс_токены целое число Максимальное количество токенов, которые могут быть сгенерированы в ходе завершения.

Количество маркеров запроса плюс max_tokens не может превышать длину контекста модели.
нет 16
н целое число Количество завершений, создаваемых для каждого запроса.

Примечание. Так как этот параметр создает множество завершений, он может быстро использовать квоту маркера. Используйте тщательно и убедитесь, что у вас есть разумные параметры для max_tokens и stop.
нет 1
штраф за присутствие число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры в зависимости от того, появляются ли они в тексте до сих пор, что повышает вероятность того, что модель будет говорить о новых темах.
нет 0
подсказка строка или массив Запросы для создания завершений, закодированных в виде строки, массива строк, массива маркеров или массива массивов маркеров.

Обратите внимание, что <|endoftext|> — это разделитель документов, который модель видит во время обучения, поэтому если запрос не указан, модель будет создаваться как будто с начала нового документа.
Да
семя целое число Если задано, наша система будет предпринять лучшие усилия для выборки детерминированного, таким образом, что повторяющиеся запросы с одинаковыми и теми же параметрами должны возвращать тот же seed результат.

Детерминированность не гарантируется, и вы должны обратиться к параметру ответа system_fingerprint для мониторинга изменений на сервере.
нет
остановка строка или массив До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры. Возвращенный текст не будет содержать последовательность остановки.
нет
поток булевый Потоковая передача частичного хода выполнения. Если задано, маркеры будут отправляться как события, отправленные сервером только для данных, как они становятся доступными, с потокомdata: [DONE], завершаемым сообщением. Пример кода Python.
нет Неправда
суффикс струна Суффикс, который приходит после завершения вставленного текста.

Этот параметр поддерживается только для gpt-3.5-turbo-instruct.
нет Отсутствует
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.

Как правило, мы рекомендуем изменить это или top_p не оба.
нет 1
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить это или temperature не оба.
нет 1
Пользователь струна Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений.
нет

создатьОтветНаЗавершение

Представляет ответ завершения из API. Примечание. В отличие от конечной точки чата объекты потокового и непотокового ответа используют одну и ту же фигуру (в отличие от конечной точки чата).

Имя Тип Описание Обязательно По умолчанию
Выбор массив Список вариантов завершения модели, созданной для ввода запроса. Да
созданный целое число Метка времени Unix (в секундах) при создании завершения. Да
идентификатор струна Уникальный идентификатор завершения. Да
модель струна Модель, используемая для завершения. Да
объект перечисление Тип объекта, который всегда является "text_completion"
Возможные значения: text_completion
Да
результаты_фильтрации_запросов promptFilterResults Результаты фильтрации содержимого для нуля или более запросов в запросе. В запросе потоковой передачи результаты для различных запросов могут поступать в разное время или в разных заказах. нет
системный отпечаток струна Этот отпечаток представляет конфигурацию серверной части, с которой работает модель.

Можно использовать в сочетании с параметром seed запроса, чтобы понять, когда внутренние изменения были внесены, что может повлиять на детерминированность.
нет
использование completionUsage Статистика использования для запроса завершения. нет

создатьЗапросНаЗаполнениеЧата

Имя Тип Описание Обязательно По умолчанию
аудио объект Параметры выходных данных звука. Требуется при запросе на вывод звука с modalities: ["audio"]. нет
└─ Формат перечисление Указывает выходной формат звука. Должен быть одним из wav, mp3, flac, opus или pcm16.

Возможные значения: wav, mp3, flac, opus, pcm16
нет
└️ голос перечисление Указывает тип голоса. Поддерживаемые голоса: alloy, echo, fable, onyxи novashimmer.

Возможные значения: alloy, echo, fable, onyx, nova, shimmer
нет
источники данных массив Записи конфигурации для расширений чата Azure OpenAI, которые используют их.
Эта дополнительная спецификация совместима только с Azure OpenAI.
нет
штраф за частоту число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры на основе их существующей частоты в тексте до сих пор, уменьшая вероятность повторения модели той же строки дословно.
нет 0
вызов_функции string или chatCompletionFunctionCallOption Не рекомендуется использовать в пользу tool_choice.

Определяет, какая функция (если есть) вызывается моделью.
none означает, что модель не вызывает функцию и вместо этого создает сообщение.
auto означает, что модель может выбирать между созданием сообщения или вызовом функции.
Указание определенной функции путем {"name": "my_function"} принудительного вызова этой функции моделью.

none значение по умолчанию, если функции отсутствуют. auto значение по умолчанию, если функции присутствуют.
нет
функции массив Не рекомендуется использовать в пользу tools.

Список функций, для которые модель может создавать входные данные JSON.
нет
логит_биас объект Изменяет вероятность появления указанных маркеров в завершении.

Принимает объект JSON, который сопоставляет маркеры (указанные идентификатором маркера в токенизаторе) со связанным значением предвзятости от -100 до 100. С математической точки зрения смещение добавляется к логитам, созданным моделью до выборки. Точный эффект зависит от модели, но значения от –1 до 1 должны уменьшать или увеличивать вероятность выбора; такие значения, как –100 или 100, должны приводить к запрету или эксклюзивному выбору соответствующего маркера.
нет Отсутствует
logprobs булевый Следует ли возвращать вероятности журналов выходных маркеров или нет. Если значение true, возвращает вероятности журнала каждого выходного маркера, возвращаемого в параметре contentmessage. нет Неправда
max_completion_tokens (максимальное количество токенов завершения) целое число Верхняя граница для числа маркеров, которые можно создать для завершения, включая видимые выходные маркеры и маркеры причин. Это поддерживается только в моделях серии o1. Расширит поддержку других моделей в будущем выпуске API. нет
макс_токены целое число Максимальное количество маркеров, которые можно создать в завершении чата.

Общая длина входных маркеров и созданных маркеров ограничена длиной контекста модели.
нет
сообщения массив Список сообщений, составляющих беседу до сих пор. Пример кода Python. Да
метаданные объект Определяемые разработчиком теги и значения, используемые для фильтрации завершений на панели мониторинга хранимых завершений. нет
Условия ChatCompletionModalities Типы выходных данных, которые нужно создать для этого запроса.
Большинство моделей могут создавать текст, который по умолчанию:

["text"]

Модель gpt-4o-audio-preview также может использоваться для создания звука. Чтобы запросить, что эта модель создает как текстовые, так и звуковые ответы, можно использовать:

["text", "audio"]
нет
н целое число Сколько вариантов завершения чата для каждого входного сообщения. Обратите внимание, что плата будет взиматься на основе количества созданных маркеров во всех вариантах. Имейте в виду n , чтобы 1 свести к минимуму затраты. нет 1
вызовы инструмента в параллельном режиме ParallelToolCalls Следует ли включить параллельные вызовы функций во время использования средства. нет Верно
прогноз ПрогнозContent Конфигурация прогнозируемых выходных данных, которая может значительно улучшить время отклика, когда большие части ответа модели известны заранее. Это наиболее распространено при повторном создании файла с незначительными изменениями в большинстве содержимого. нет
штраф за присутствие число/номер Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры в зависимости от того, появляются ли они в тексте до сих пор, что повышает вероятность того, что модель будет говорить о новых темах.
нет 0
усилия на рассуждение перечисление Только модели o1

Ограничивает усилия по рассуждениям моделей.

В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе.
Возможные значения: low, mediumhigh
нет
формат_ответа ResponseFormatText или ResponseFormatJsonObject или ResponseFormatJsonSchema Объект, указывающий формат, который должен выводить модель. Совместим с GPT-4o, GPT-4o mini, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo, чем gpt-3.5-turbo-1106более новые.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать вашей предоставленной схеме JSON.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
семя целое число Эта функция доступна в бета-версии.
Если задано, наша система будет предпринять лучшие усилия для выборки детерминированного, таким образом, что повторяющиеся запросы с одинаковыми и теми же параметрами должны возвращать тот же seed результат.
Детерминированность не гарантируется, и вы должны обратиться к параметру ответа system_fingerprint для мониторинга изменений на сервере.
нет
остановка строка или массив До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры.
нет
магазин булевый Независимо от того, следует ли хранить выходные данные этого запроса на завершение чата для использования в наших продуктах для дистилляции или оценки модели. нет
поток булевый Если задано, будут отправляться частичные разностные сообщения, например в ChatGPT. Маркеры будут отправляться как события, отправленные сервером только для данных, как они становятся доступными, при этом поток завершается сообщениемdata: [DONE]. Пример кода Python.
нет Неправда
параметры_потока chatCompletionStreamOptions Параметры потокового ответа. Этот параметр устанавливается только при установке stream: true.
нет Отсутствует
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.

Как правило, мы рекомендуем изменить это или top_p не оба.
нет 1
выбор инструмента chatCompletionToolChoiceOption Определяет, какое средство (если таковое) вызывается моделью. none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение. auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов. required означает, что модель должна вызывать один или несколько инструментов. Указание определенного средства с помощью {"type": "function", "function": {"name": "my_function"}} принудительного вызова этого средства моделью. none значение по умолчанию, если средства отсутствуют. auto значение по умолчанию, если существуют средства. нет
инструменты массив Список инструментов, которые может вызывать модель. В настоящее время в качестве инструмента поддерживаются только функции. Используйте это для предоставления списка функций, для которые модель может создавать входные данные JSON. Поддерживаются не более 128 функций.
нет
top_logprobs целое число Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. logprobs Необходимо задать значение true , если этот параметр используется. нет
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить это или temperature не оба.
нет 1
Пользователь струна Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений.
нет
контекст безопасности пользователя userSecurityContext Контекст безопасности пользователей содержит несколько параметров, описывающих само приложение ИИ, и конечный пользователь, взаимодействующий с приложением ИИ. Эти поля помогают группам по операциям безопасности исследовать и устранять инциденты безопасности, предоставляя комплексный подход к защите приложений ИИ. Узнайте больше о защите приложений ИИ с помощью Microsoft Defender для облака. нет

контекст безопасности пользователя

Контекст безопасности пользователей содержит несколько параметров, описывающих само приложение ИИ, и конечный пользователь, взаимодействующий с приложением ИИ. Эти поля помогают группам по операциям безопасности исследовать и устранять инциденты безопасности, предоставляя комплексный подход к защите приложений ИИ. Узнайте больше о защите приложений ИИ с помощью Microsoft Defender для облака.

Имя Тип Описание Обязательно По умолчанию
название_приложения струна Имя приложения. Конфиденциальная личная информация не должна быть включена в это поле. нет
идентификатор_конечного_пользователя струна Этот идентификатор — это идентификатор объекта пользователя Microsoft Entra (ранее Azure Active Directory), используемый для проверки подлинности конечных пользователей в созданном приложении ИИ. Конфиденциальная личная информация не должна быть включена в это поле. нет
id_арендатора_конечного_пользователя струна Идентификатор клиента Microsoft 365, к которому принадлежит конечный пользователь. Это необходимо, если созданное приложение ИИ является мультитенантным. нет
IP-адрес источника струна Записывает IP-адрес исходного клиента, принимающие форматы IPv4 и IPv6. нет

функции завершения чата

Имя Тип Описание Обязательно По умолчанию
описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
имя струна Имя вызываемой функции. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. Да
Параметры FunctionParameters Параметры, которые принимают функции, описаны как объект схемы JSON. Примеры см. в руководстве и справочнике по схеме JSON для документации по формату.

Опущение parameters определяет функцию с пустым списком параметров.
нет

опция вызова функции завершения чата

Указание определенной функции путем {"name": "my_function"} принудительного вызова этой функции моделью.

Имя Тип Описание Обязательно По умолчанию
имя струна Имя вызываемой функции. Да

параметрыФункцииЗавершенияЧата

Параметры, которые принимают функции, описаны как объект схемы JSON. См. руководство или примеры и справочник по схеме JSON для документации по формату.

Для этого компонента не определены свойства.

сообщение-запрос завершения чата

Этот компонент может быть одним из следующих компонентов:

Запрос сообщение разработчика о завершении чата

Предоставленные разработчиком инструкции по выполнению модели независимо от сообщений, отправляемых пользователем. При использовании моделей o1 и более поздних developer версий сообщения заменяют предыдущие system сообщения.

Имя Тип Описание Обязательно По умолчанию
содержимое строка или массив Содержимое сообщения разработчика. Да
имя струна Необязательное имя участника. Предоставляет сведения о модели, чтобы различать участников одной роли. нет
роль перечисление Роль автора сообщений в данном случае developer.
Возможные значения: developer
Да

системное сообщение запроса завершения чата

Имя Тип Описание Обязательно По умолчанию
содержимое строка или массив Содержимое системного сообщения. Да
имя струна Необязательное имя участника. Предоставляет сведения о модели, чтобы различать участников одной роли. нет
роль перечисление Роль автора сообщений в данном случае system.
Возможные значения: system
Да

Сообщение пользователя запроса завершения чата

Имя Тип Описание Обязательно По умолчанию
содержимое строка или массив Содержимое сообщения пользователя.
Да
имя струна Необязательное имя участника. Предоставляет сведения о модели, чтобы различать участников одной роли. нет
роль перечисление Роль автора сообщений в данном случае user.
Возможные значения: user
Да

ЗапросЗавершенияЧатаПомощника

Имя Тип Описание Обязательно По умолчанию
содержимое строка или массив Содержимое сообщения помощника. Обязательный, если tool_calls не указан или function_call не указан.
нет
вызов_функции объект Устаревшие и замененные tool_calls. Имя и аргументы вызываемой функции, созданной моделью. нет
└─ аргументы струна Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Обратите внимание, что модель не всегда создает допустимые json и может галлюцинировать параметры, не определенные схемой функции. Перед вызовом функции проверьте аргументы в коде. нет
└️ имя струна Имя вызываемой функции. нет
имя струна Необязательное имя участника. Предоставляет сведения о модели, чтобы различать участников одной роли. нет
отказ струна Сообщение об отказе помощником. нет
роль перечисление Роль автора сообщений в данном случае assistant.
Возможные значения: assistant
Да
вызовы инструментов chatCompletionMessageToolCalls Вызовы средства, созданные моделью, например вызовы функций. нет

Сообщение инструмента запроса завершения чата

Имя Тип Описание Обязательно По умолчанию
содержимое строка или массив Содержимое сообщения средства. Да
роль перечисление Роль автора сообщений в данном случае tool.
Возможные значения: tool
Да
идентификатор вызова инструмента струна Вызов средства, на который отвечает это сообщение. Да

сообщение функции запроса завершения чата

Имя Тип Описание Обязательно По умолчанию
содержимое струна Содержимое сообщения функции. Да
имя струна Имя вызываемой функции. Да
роль перечисление Роль автора сообщений в данном случае function.
Возможные значения: function
Да

ЗапросЧатаНаЗавершениеСообщенияРазработчикаСодержимоеЧасти

Этот компонент может быть одним из следующих компонентов:

Системное сообщение с содержанием запроса завершения чата

Этот компонент может быть одним из следующих компонентов:

содержимое сообщения пользователя в запросе на завершение чата

Этот компонент может быть одним из следующих компонентов:

ЧастьСообщенияПомощникаЗапросаЗавершенияЧата

Этот компонент может быть одним из следующих компонентов:

ИнструментЗапросаСообщенияЧатаСодержание

Этот компонент может быть одним из следующих компонентов:

Часть текста содержимого запроса на завершение чата

Имя Тип Описание Обязательно По умолчанию
текст струна Текстовое содержимое. Да
тип перечисление Тип части содержимого.
Возможные значения: text
Да

Запрос завершения чата Содержимое сообщения Часть аудио

Имя Тип Описание Обязательно По умолчанию
входной_аудио объект Да
└─ Данные струна Звуковые данные в кодировке Base64. нет
└─ Формат перечисление Формат закодированных звуковых данных. В настоящее время поддерживается wav и mp3.

Возможные значения: wav, mp3
нет
тип перечисление Тип части содержимого. Всегда input_audio.
Возможные значения: input_audio
Да

сообщениеЗапросаЗавершенияЧатаКонтентЧастиИзображение

Имя Тип Описание Обязательно По умолчанию
ссылка_на_изображение объект Да
└️ подробные сведения перечисление Указывает уровень детализации изображения. Дополнительные сведения см. в руководстве по визуальному представлению.
Возможные значения: auto, lowhigh
нет
└─ URL струна URL-адрес изображения или данных в кодировке Base64. нет
тип перечисление Тип части содержимого.
Возможные значения: image_url
Да

Запрос отклонен: сообщение не завершено

Имя Тип Описание Обязательно По умолчанию
отказ струна Сообщение об отказе, созданное моделью. Да
тип перечисление Тип части содержимого.
Возможные значения: refusal
Да

конфигурация расширения чата Azure

Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа. Использование этой конфигурации совместимо только с Azure OpenAI.

###Discriminator для azureChatExtensionConfiguration

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
azure_search azureSearchChatExtensionConfiguration
azure_cosmos_db azureCosmosDBChatExtensionConfiguration
elasticsearch elasticsearchChatExtensionConfiguration
mongo_db mongoDBChatExtensionConfiguration
pinecone pineconeChatExtensionConfiguration
Имя Тип Описание Обязательно По умолчанию
тип azureChatExtensionType Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа.
Использование этой конфигурации совместимо только с Azure OpenAI.
Да

ТипРасширенияAzureChat

Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа. Использование этой конфигурации совместимо только с Azure OpenAI.

Недвижимость Ценность
Описание Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа.
Использование этой конфигурации совместимо только с Azure OpenAI.
Тип струна
Значения azure_search
azure_cosmos_db
elasticsearch
mongo_db
pinecone

Настройка расширения чата для поиска в Azure

Определенное представление настраиваемых параметров поиска Azure при использовании его в качестве расширения чата OpenAI в Azure.

Имя Тип Описание Обязательно По умолчанию
Параметры azureSearchChatExtensionParameters Параметры поиска Azure при использовании в качестве расширения чата OpenAI в Azure. нет
тип azureChatExtensionType Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа.
Использование этой конфигурации совместимо только с Azure OpenAI.
Да

параметрыРасширенияЧатаAzureSearch

Параметры поиска Azure при использовании в качестве расширения чата OpenAI в Azure.

Имя Тип Описание Обязательно По умолчанию
разрешить_частичный_результат булевый Если задано значение true, система позволит использовать частичные результаты поиска, и запрос завершается ошибкой, если все запросы завершаются ошибкой. Если запрос не указан или указан как false, запрос завершится ошибкой, если какой-либо поисковый запрос завершается ошибкой. нет Неправда
аутентификация onYourDataApiKeyAuthenticationOptions или onYourDataSystemAssignedManagedIdentityAuthenticationOptions или onYourDataUserAssignedManagedIdentityAuthenticationOptions или onYourDataAccessTokenAuthenticationOptions Да
встраивание_зависимости onYourDataEndpointVectorizationSource или onYourDataDeploymentNameVectorizationSource или onYourDataIntegratedVectorizationSource нет
конечная точка струна Абсолютный путь конечной точки для используемого ресурса поиска Azure. Да
соответствие полей Опции настройки полей индекса в AzureSearch Необязательные параметры для управления обработкой полей при использовании настроенного ресурса поиска Azure. нет
фильтр струна Фильтр поиска. нет
в пределах области булевый Следует ли ограничить запросы использованием индексированных данных. нет
включить контексты массив Включенные свойства контекста вывода. Если не указано, значение по умолчанию равно citations и intent. нет
имя_индекса струна Имя индекса, используемого как доступное в ресурсе поиска Azure. Да
Максимальное количество поисковых запросов целое число Максимальное количество перезаписных запросов должно отправляться в поставщик поиска для одного сообщения пользователя. Если это не указано, система решит количество запросов для отправки. нет
тип_запроса azureSearchQueryType Тип запроса поиска Azure, который должен выполняться при использовании в качестве расширения чата Azure OpenAI. нет
семантическая конфигурация струна Дополнительная семантическая конфигурация для запроса. нет
строгость целое число Настроенная строгость фильтрации релевантности поиска. Чем выше строгость, тем выше точность, но более низкий отзыв ответа. нет
топ_n_документы целое число Настроено первое число документов для функции настроенного запроса. нет

опции сопоставления полей индекса Azure Search

Необязательные параметры для управления обработкой полей при использовании настроенного ресурса поиска Azure.

Имя Тип Описание Обязательно По умолчанию
поля_контента массив Имена полей индекса, которые следует рассматривать как содержимое. нет
разделитель полей содержания струна Шаблон разделителя, который должны использовать поля содержимого. нет
поле_пути_к_файлу струна Имя поля индекса, используемого в качестве файлового пути. нет
векторные поля изображений массив Имена полей, представляющих векторные данные изображения. нет
поле_название струна Имя поля индекса, используемого в качестве заголовка. нет
поле_ссылки струна Имя поля индекса, используемого в качестве URL-адреса. нет
векторные поля массив Имена полей, представляющих векторные данные. нет

Тип запроса Azure Search

Тип запроса поиска Azure, который должен выполняться при использовании в качестве расширения чата Azure OpenAI.

Недвижимость Ценность
Описание Тип запроса поиска Azure, который должен выполняться при использовании в качестве расширения чата Azure OpenAI.
Тип струна
Значения simple
semantic
vector
vector_simple_hybrid
vector_semantic_hybrid

Конфигурация расширения чата Azure Cosmos DB

Определенное представление настраиваемых параметров для Azure Cosmos DB при использовании в качестве расширения чата OpenAI в Azure.

Имя Тип Описание Обязательно По умолчанию
Параметры azureCosmosDBChatExtensionParameters Параметры, используемые при настройке расширений чата Azure OpenAI в чате данных при использовании Azure Cosmos DB для виртуальных ядер MongoDB. нет
тип azureChatExtensionType Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа.
Использование этой конфигурации совместимо только с Azure OpenAI.
Да

azureCosmosDBПараметрыРасширенияЧата

Параметры, используемые при настройке расширений чата Azure OpenAI в чате данных при использовании Azure Cosmos DB для виртуальных ядер MongoDB.

Имя Тип Описание Обязательно По умолчанию
разрешить_частичный_результат булевый Если задано значение true, система позволит использовать частичные результаты поиска, и запрос завершается ошибкой, если все запросы завершаются ошибкой. Если запрос не указан или указан как false, запрос завершится ошибкой, если какой-либо поисковый запрос завершается ошибкой. нет Неправда
аутентификация onYourDataConnectionStringПараметрыАутентификации Параметры проверки подлинности Azure OpenAI On Your Data при использовании строка подключения. Да
имя_контейнера струна Имя контейнера ресурсов Azure Cosmos DB. Да
название_базы_данных струна Имя базы данных виртуальных ядер MongoDB для использования с Azure Cosmos DB. Да
встраивание_зависимости onYourDataEndpointVectorizationSource или onYourDataDeploymentNameVectorizationSource Да
соответствие полей azureCosmosDBFieldMappingOptions Необязательные параметры для управления обработкой полей при использовании настроенного ресурса Azure Cosmos DB. Да
в пределах области булевый Следует ли ограничить запросы использованием индексированных данных. нет
включить контексты массив Включенные свойства контекста вывода. Если не указано, значение по умолчанию равно citations и intent. нет
имя_индекса струна Имя индекса виртуального ядра MongoDB для использования с Azure Cosmos DB. Да
Максимальное количество поисковых запросов целое число Максимальное количество перезаписных запросов должно отправляться в поставщик поиска для одного сообщения пользователя. Если это не указано, система решит количество запросов для отправки. нет
строгость целое число Настроенная строгость фильтрации релевантности поиска. Чем выше строгость, тем выше точность, но более низкий отзыв ответа. нет
топ_n_документы целое число Настроено первое число документов для функции настроенного запроса. нет

Опции отображения полей в Azure Cosmos DB

Необязательные параметры для управления обработкой полей при использовании настроенного ресурса Azure Cosmos DB.

Имя Тип Описание Обязательно По умолчанию
поля_контента массив Имена полей индекса, которые следует рассматривать как содержимое. Да
разделитель полей содержания струна Шаблон разделителя, который должны использовать поля содержимого. нет
поле_пути_к_файлу струна Имя поля индекса, используемого в качестве файлового пути. нет
поле_название струна Имя поля индекса, используемого в качестве заголовка. нет
поле_ссылки струна Имя поля индекса, используемого в качестве URL-адреса. нет
векторные поля массив Имена полей, представляющих векторные данные. Да

КонфигурацияРасширенияЧатаElasticsearch

Определенное представление настраиваемых параметров для Elasticsearch при использовании в качестве расширения чата OpenAI в Azure.

Имя Тип Описание Обязательно По умолчанию
Параметры elasticsearchChatExtensionParameters Параметры для использования при настройке Elasticsearch® в качестве расширения чата Azure OpenAI. нет
тип azureChatExtensionType Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа.
Использование этой конфигурации совместимо только с Azure OpenAI.
Да

Параметры расширения чата Elasticsearch

Параметры для использования при настройке Elasticsearch® в качестве расширения чата Azure OpenAI.

Имя Тип Описание Обязательно По умолчанию
разрешить_частичный_результат булевый Если задано значение true, система позволит использовать частичные результаты поиска, и запрос завершается ошибкой, если все запросы завершаются ошибкой. Если запрос не указан или указан как false, запрос завершится ошибкой, если какой-либо поисковый запрос завершается ошибкой. нет Неправда
аутентификация onYourDataKeyAndKeyIdAuthenticationOptions или onYourDataEncodedApiKeyAuthenticationOptions Да
встраивание_зависимости onYourDataEndpointVectorizationSource или onYourDataDeploymentNameVectorizationSource или onYourDataModelIdVectorizationSource нет
конечная точка струна Конечная точка Elasticsearch®. Да
соответствие полей elasticsearchIndexFieldMappingOptions Необязательные параметры для управления обработкой полей при использовании настроенного ресурса Elasticsearch.® нет
в пределах области булевый Следует ли ограничить запросы использованием индексированных данных. нет
включить контексты массив Включенные свойства контекста вывода. Если не указано, значение по умолчанию равно citations и intent. нет
имя_индекса струна Имя индекса Elasticsearch®. Да
Максимальное количество поисковых запросов целое число Максимальное количество перезаписных запросов должно отправляться в поставщик поиска для одного сообщения пользователя. Если это не указано, система решит количество запросов для отправки. нет
тип_запроса elasticsearchQueryType Тип поискового запроса Elasticsearch®, который должен быть выполнен при использовании в качестве расширения чата Azure OpenAI. нет
строгость целое число Настроенная строгость фильтрации релевантности поиска. Чем выше строгость, тем выше точность, но более низкий отзыв ответа. нет
топ_n_документы целое число Настроено первое число документов для функции настроенного запроса. нет

Параметры отображения полей индекса для Elasticsearch

Необязательные параметры для управления обработкой полей при использовании настроенного ресурса Elasticsearch.®

Имя Тип Описание Обязательно По умолчанию
поля_контента массив Имена полей индекса, которые следует рассматривать как содержимое. нет
разделитель полей содержания струна Шаблон разделителя, который должны использовать поля содержимого. нет
поле_пути_к_файлу струна Имя поля индекса, используемого в качестве файлового пути. нет
поле_название струна Имя поля индекса, используемого в качестве заголовка. нет
поле_ссылки струна Имя поля индекса, используемого в качестве URL-адреса. нет
векторные поля массив Имена полей, представляющих векторные данные. нет

ТипЗапросаElasticsearch

Тип поискового запроса Elasticsearch®, который должен быть выполнен при использовании в качестве расширения чата Azure OpenAI.

Недвижимость Ценность
Описание Тип поискового запроса Elasticsearch®, который должен быть выполнен при использовании в качестве расширения чата Azure OpenAI.
Тип струна
Значения simple
vector

Конфигурация чата с расширением MongoDB

Определенное представление настраиваемых параметров для Mongo DB при использовании в качестве расширения чата Azure OpenAI.

Имя Тип Описание Обязательно По умолчанию
Параметры mongoDBChatExtensionParameters Параметры, используемые при настройке расширений чата Azure OpenAI в чате данных при использовании Mongo DB. нет
тип azureChatExtensionType Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа.
Использование этой конфигурации совместимо только с Azure OpenAI.
Да

Параметры расширения чата для mongoDB (mongoDBChatExtensionParameters)

Параметры, используемые при настройке расширений чата Azure OpenAI в чате данных при использовании Mongo DB.

Имя Тип Описание Обязательно По умолчанию
разрешить_частичный_результат булевый Если задано значение true, система позволит использовать частичные результаты поиска, и запрос завершается ошибкой, если все запросы завершаются ошибкой. Если запрос не указан или указан как false, запрос завершится ошибкой, если какой-либо поисковый запрос завершается ошибкой. нет Неправда
имя_приложения струна Имя приложения Mongo DB. Да
аутентификация варианты аутентификации имени пользователя и пароля для YourData Параметры проверки подлинности Azure OpenAI On Your Data при использовании имени пользователя и пароля. Да
название_коллекции струна Имя коллекции Базы данных Mongo. Да
название_базы_данных струна Имя базы данных Mongo DB. Да
встраивание_зависимости onYourDataEndpointVectorizationSource или onYourDataDeploymentNameVectorizationSource Да
конечная точка струна Имя конечной точки кластера Mongo DB. Да
соответствие полей mongoDBFieldMappingOptions Необязательные параметры для управления обработкой полей при использовании настроенного ресурса Mongo DB. Да
в пределах области булевый Следует ли ограничить запросы использованием индексированных данных. нет
включить контексты массив Включенные свойства контекста вывода. Если не указано, значение по умолчанию равно citations и intent. нет
имя_индекса струна Имя индекса Mongo DB. Да
Максимальное количество поисковых запросов целое число Максимальное количество перезаписных запросов должно отправляться в поставщик поиска для одного сообщения пользователя. Если это не указано, система решит количество запросов для отправки. нет
строгость целое число Настроенная строгость фильтрации релевантности поиска. Чем выше строгость, тем выше точность, но более низкий отзыв ответа. нет
топ_n_документы целое число Настроено первое число документов для функции настроенного запроса. нет

Опции сопоставления полей MongoDB

Необязательные параметры для управления обработкой полей при использовании настроенного ресурса Mongo DB.

Имя Тип Описание Обязательно По умолчанию
поля_контента массив Имена полей индекса, которые следует рассматривать как содержимое. Да
разделитель полей содержания струна Шаблон разделителя, который должны использовать поля содержимого. нет
поле_пути_к_файлу струна Имя поля индекса, используемого в качестве файлового пути. нет
поле_название струна Имя поля индекса, используемого в качестве заголовка. нет
поле_ссылки струна Имя поля индекса, используемого в качестве URL-адреса. нет
векторные поля массив Имена полей, представляющих векторные данные. Да

Конфигурация расширения для pineconeChat

Определенное представление настраиваемых параметров для Pinecone при использовании его в качестве расширения чата Azure OpenAI.

Имя Тип Описание Обязательно По умолчанию
Параметры pineconeChatExtensionParameters Параметры настройки расширений чата Azure OpenAI Pinecone. нет
тип azureChatExtensionType Представление данных конфигурации для одного расширения чата Azure OpenAI. Это будет использоваться запросом завершения чата, который должен использовать расширения чата Azure OpenAI для расширения поведения ответа.
Использование этой конфигурации совместимо только с Azure OpenAI.
Да

pineconeChatExtensionParameters

Параметры настройки расширений чата Azure OpenAI Pinecone.

Имя Тип Описание Обязательно По умолчанию
разрешить_частичный_результат булевый Если задано значение true, система позволит использовать частичные результаты поиска, и запрос завершается ошибкой, если все запросы завершаются ошибкой. Если запрос не указан или указан как false, запрос завершится ошибкой, если какой-либо поисковый запрос завершается ошибкой. нет Неправда
аутентификация Параметры проверки подлинности с использованием ключа API для onYourData Параметры проверки подлинности Azure OpenAI On Your Data при использовании ключа API. Да
встраивание_зависимости наВашихДанныхРазвертываниеИмяВекториализацияИсточник Сведения о источнике векторизации, используемом Azure OpenAI On Your Data при применении векторного поиска, основанного на имени развертывания модели внутренних внедрения в том же ресурсе Azure OpenAI. Да
окружающая среда струна Имя среды Pinecone. Да
соответствие полей pineconeFieldMappingOptions Необязательные параметры для управления обработкой полей при использовании настроенного ресурса Pinecone. Да
в пределах области булевый Следует ли ограничить запросы использованием индексированных данных. нет
включить контексты массив Включенные свойства контекста вывода. Если не указано, значение по умолчанию равно citations и intent. нет
имя_индекса струна Имя индекса базы данных Pinecone. Да
Максимальное количество поисковых запросов целое число Максимальное количество перезаписных запросов должно отправляться в поставщик поиска для одного сообщения пользователя. Если это не указано, система решит количество запросов для отправки. нет
строгость целое число Настроенная строгость фильтрации релевантности поиска. Чем выше строгость, тем выше точность, но более низкий отзыв ответа. нет
топ_n_документы целое число Настроено первое число документов для функции настроенного запроса. нет

ПараметрыОтображенияПоляШишки

Необязательные параметры для управления обработкой полей при использовании настроенного ресурса Pinecone.

Имя Тип Описание Обязательно По умолчанию
поля_контента массив Имена полей индекса, которые следует рассматривать как содержимое. Да
разделитель полей содержания струна Шаблон разделителя, который должны использовать поля содержимого. нет
поле_пути_к_файлу струна Имя поля индекса, используемого в качестве файлового пути. нет
поле_название струна Имя поля индекса, используемого в качестве заголовка. нет
поле_ссылки струна Имя поля индекса, используемого в качестве URL-адреса. нет

варианты аутентификации вашей информации

Параметры проверки подлинности для Azure OpenAI в данных.

Дискриминатор для onYourDataAuthenticationOptions

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
api_key Параметры проверки подлинности с использованием ключа API для onYourData
connection_string onYourDataConnectionStringПараметрыАутентификации
key_and_key_id опции аутентификации с использованием ключа данных и идентификатора ключа
encoded_api_key onYourDataEncodedApiKeyАутентификационныеОпции
access_token параметры аутентификации токена доступа к вашим данным
system_assigned_managed_identity Параметры Аутентификации Управляемой Идентичности Назначенной Системой Данных
user_assigned_managed_identity onYourDataПользовательНазначенныйУправляемаяИдентичностьОпцииАутентификации
username_and_password варианты аутентификации имени пользователя и пароля для YourData
Имя Тип Описание Обязательно По умолчанию
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да

onYourDataContextProperty

Свойство контекста.

Недвижимость Ценность
Описание Свойство контекста.
Тип струна
Значения citations
intent
all_retrieved_documents

Тип аутентификации ваших данных

Типы проверки подлинности, поддерживаемые Azure OpenAI в данных.

Недвижимость Ценность
Описание Типы проверки подлинности, поддерживаемые Azure OpenAI в данных.
Тип струна
Значения api_key
connection_string
key_and_key_id
encoded_api_key
access_token
system_assigned_managed_identity
user_assigned_managed_identity
username_and_password

параметры аутентификации ключа API для ваших данных

Параметры проверки подлинности Azure OpenAI On Your Data при использовании ключа API.

Имя Тип Описание Обязательно По умолчанию
ключ струна Ключ API, используемый для проверки подлинности. нет
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да

параметрыАутентификацииВашегоСтрокиПодключенияДанных

Параметры проверки подлинности Azure OpenAI On Your Data при использовании строка подключения.

Имя Тип Описание Обязательно По умолчанию
строка подключения струна Строка подключения, используемый для проверки подлинности. нет
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да

ОпцииАутентификацииСВашимиКлючамиДанныхИИдентификаторамиКлючей

Параметры проверки подлинности Azure OpenAI On Your Data при использовании пары идентификаторов elasticsearch и ключа.

Имя Тип Описание Обязательно По умолчанию
ключ струна Ключ Elasticsearch, используемый для проверки подлинности. нет
идентификатор ключа струна Идентификатор ключа Elasticsearch, используемый для проверки подлинности. нет
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да

onYourDataEncodedApiKeyАутентификационныеОпции

Параметры проверки подлинности Azure OpenAI On Your Data при использовании ключа API в кодировке Elasticsearch.

Имя Тип Описание Обязательно По умолчанию
кодированный_ключ_API струна Ключ API в кодировке Elasticsearch, используемый для проверки подлинности. нет
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да

ПараметрыАутентификацииТокенаДоступаВашихДанных

Параметры проверки подлинности Azure OpenAI On Your Data при использовании маркера доступа.

Имя Тип Описание Обязательно По умолчанию
маркер доступа (access_token) струна Маркер доступа, используемый для проверки подлинности. нет
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да

Параметры аутентификации системы управления вашими данными, назначенной управляемой идентификацией

Параметры проверки подлинности Azure OpenAI On Your Data при использовании управляемого удостоверения, назначаемого системой.

Имя Тип Описание Обязательно По умолчанию
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да

Параметры аутентификации с управляемой идентификацией, назначенной пользователями в системе onYourData

Параметры проверки подлинности Azure OpenAI On Your Data при использовании управляемого удостоверения, назначаемого пользователем.

Имя Тип Описание Обязательно По умолчанию
идентификатор ресурса управляемой идентификации струна Идентификатор ресурса управляемого удостоверения, назначаемого пользователем, который будет использоваться для проверки подлинности. нет
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да

параметры аутентификации по имени пользователя и паролю для YourData

Параметры проверки подлинности Azure OpenAI On Your Data при использовании имени пользователя и пароля.

Имя Тип Описание Обязательно По умолчанию
пароль струна Пароль. для проверки подлинности. нет
тип типАутентификацииВашихДанных Типы проверки подлинности, поддерживаемые Azure OpenAI в данных. Да
имя пользователя струна Имя пользователя, используемое для проверки подлинности. нет

onYourDataVectorizationSource

Абстрактное представление источника векторизации для Azure OpenAI On Your Data с помощью векторного поиска.

Этот компонент использует свойство type для дискриминации между различными типами:

Значение типа Схема
endpoint onYourDataEndpointVectorizationSource
deployment_name наВашихДанныхРазвертываниеИмяВекториализацияИсточник
integrated наИсточникИнтегрированнойВекторизацииВашихДанных
model_id onВашМодельДанныхIdВекторизацияИсточник
Имя Тип Описание Обязательно По умолчанию
тип ВашТипИсточникаДанныхДляВекторизации Представляет доступные источники Azure OpenAI On Your Data, которые можно использовать для настройки векторизации данных для использования с векторным поиском. Да

ВашТипИсточникВекториазцииДанных

Представляет доступные источники Azure OpenAI On Your Data, которые можно использовать для настройки векторизации данных для использования с векторным поиском.

Недвижимость Ценность
Описание Представляет доступные источники Azure OpenAI On Your Data, которые можно использовать для настройки векторизации данных для использования с векторным поиском.
Тип струна
Значения endpoint
deployment_name
integrated
model_id

наВашемDataEndpointVectorizationSource

Сведения о источнике векторизации, используемом Azure OpenAI On Your Data при применении векторного поиска, основанном на вызове общедоступной конечной точки Azure OpenAI для внедрения.

Имя Тип Описание Обязательно По умолчанию
аутентификация onYourDataApiKeyAuthenticationOptions или onYourDataAccessTokenAuthenticationOptions нет
размеры целое число Количество измерений, которые должны быть внедренными. Поддерживается только в text-embedding-3 и более поздних моделях. нет
конечная точка струна Указывает URL-адрес конечной точки ресурса, из которого должны быть получены внедренные модули. Он должен быть в формате https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings. Параметр запроса версии API не разрешен. нет
тип ВашТипИсточникаДанныхДляВекторизации Представляет доступные источники Azure OpenAI On Your Data, которые можно использовать для настройки векторизации данных для использования с векторным поиском. Да

onYourDataDeploymentNameВекторизацияИсточник

Сведения о источнике векторизации, используемом Azure OpenAI On Your Data при применении векторного поиска, основанном на имени развертывания модели внутреннего внедрения в том же ресурсе Azure OpenAI.

Имя Тип Описание Обязательно По умолчанию
имя_развертывания струна Указывает имя развертывания модели, используемого для векторизации. Это развертывание модели должно находиться в одном ресурсе Azure OpenAI, но при использовании этого развертывания модели с помощью внутреннего вызова, а не общедоступного, что позволяет выполнять поиск векторов даже в частных сетях. нет
размеры целое число Количество измерений, которые должны быть внедренными. Поддерживается только в text-embedding-3 и более поздних моделях. нет
тип ВашТипИсточникаДанныхДляВекторизации Представляет доступные источники Azure OpenAI On Your Data, которые можно использовать для настройки векторизации данных для использования с векторным поиском. Да

система интегрированной векторизации ваших данных

Представляет интегрированный векторизатор, определенный в ресурсе поиска.

Имя Тип Описание Обязательно По умолчанию
тип ВашТипИсточникаДанныхДляВекторизации Представляет доступные источники Azure OpenAI On Your Data, которые можно использовать для настройки векторизации данных для использования с векторным поиском. Да

идентификатор векторатизации вашей модели данных

Сведения о источнике векторизации, используемом Azure OpenAI On Your Data при применении векторного поиска, основанном на идентификаторе модели службы поиска. В настоящее время поддерживается только Elasticsearch.®

Имя Тип Описание Обязательно По умолчанию
идентификатор_модели струна Указывает идентификатор модели, используемый для векторизации. Этот идентификатор модели должен быть определен в службе поиска. нет
тип ВашТипИсточникаДанныхДляВекторизации Представляет доступные источники Azure OpenAI On Your Data, которые можно использовать для настройки векторизации данных для использования с векторным поиском. Да

azureChatExtensionsСообщениеКонтекст

Представление дополнительных сведений о контексте, доступных при использовании расширений чата Azure OpenAI в создании соответствующего ответа на завершение чата. Эти сведения контекста заполняются только при использовании запроса Azure OpenAI, настроенного для использования соответствующего расширения.

Имя Тип Описание Обязательно По умолчанию
все_полученные_документы массив Все извлеченные документы. нет
Цитаты массив Результат извлечения источника данных, используемый для создания сообщения помощника в ответе. нет
намерение струна Обнаруженное намерение из журнала чата, используемое для передачи в следующий поворот для переноса контекста. нет

цитата

сведения о ссылке для сообщения ответа о завершении чата.

Имя Тип Описание Обязательно По умолчанию
идентификатор_блока струна Идентификатор фрагмента ссылки. нет
содержимое струна Содержимое ссылки. Да
путь к файлу струна Путь к файлу ссылки. нет
переоценка_оценки число/номер Оценка повторного использования извлеченного документа. нет
заголовок струна Заголовок ссылки. нет
URL-адрес струна URL-адрес ссылки. нет

извлечённый документ

Извлеченный документ.

Имя Тип Описание Обязательно По умолчанию
идентификатор_блока струна Идентификатор фрагмента ссылки. нет
содержимое струна Содержимое ссылки. Да
индекс_источника_данных целое число Индекс источника данных. нет
путь к файлу струна Путь к файлу ссылки. нет
причина фильтрации filterReason Причина фильтрации извлеченного документа. нет
исходный_рейтинг_поиска число/номер Исходная оценка поиска извлеченного документа. нет
переоценка_оценки число/номер Оценка повторного использования извлеченного документа. нет
поисковые запросы массив Поисковые запросы, используемые для извлечения документа. нет
заголовок струна Заголовок ссылки. нет
URL-адрес струна URL-адрес ссылки. нет

причина фильтрации

Причина фильтрации извлеченного документа.

Недвижимость Ценность
Описание Причина фильтрации извлеченного документа.
Тип струна
Значения score
rerank

вызов инструмента завершения чата

Имя Тип Описание Обязательно По умолчанию
функция объект Функция, вызываемая моделью. Да
└─ аргументы струна Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Обратите внимание, что модель не всегда создает допустимые json и может галлюцинировать параметры, не определенные схемой функции. Перед вызовом функции проверьте аргументы в коде. нет
└️ имя струна Имя вызываемой функции. нет
идентификатор струна Идентификатор вызова средства. Да
тип тип вызова инструмента Тип вызова средства в данном случае function. Да

Тип вызова инструмента

Тип вызова средства в данном случае function.

Недвижимость Ценность
Описание Тип вызова средства в данном случае function.
Тип струна
Значения function

инструмент для обработки запросов завершения чата

Имя Тип Описание Обязательно По умолчанию
содержимое струна Содержимое сообщения. нет
идентификатор вызова инструмента струна Вызов средства, на который отвечает это сообщение. нет

Функция запроса сообщения для завершения чата

Имя Тип Описание Обязательно По умолчанию
содержимое струна Содержимое сообщения. нет
имя струна Содержимое сообщения. нет
роль перечисление Роль автора сообщений в данном случае function.
Возможные значения: function
нет

createChatCompletionResponse

Представляет ответ завершения чата, возвращаемый моделью на основе предоставленных входных данных.

Имя Тип Описание Обязательно По умолчанию
Выбор массив Список вариантов завершения чата. Может быть больше одного, если n больше 1. Да
созданный целое число Метка времени Unix (в секундах) при создании завершения чата. Да
идентификатор струна Уникальный идентификатор завершения чата. Да
модель струна Модель, используемая для завершения чата. Да
объект перечисление Тип объекта, который всегда chat.completionявляется .
Возможные значения: chat.completion
Да
результаты_фильтрации_запросов promptFilterResults Результаты фильтрации содержимого для нуля или более запросов в запросе. В запросе потоковой передачи результаты для различных запросов могут поступать в разное время или в разных заказах. нет
системный отпечаток струна Этот отпечаток представляет конфигурацию серверной части, с которой работает модель.

Можно использовать в сочетании с параметром seed запроса, чтобы понять, когда внутренние изменения были внесены, что может повлиять на детерминированность.
нет
использование completionUsage Статистика использования для запроса завершения. нет

createChatCompletionStreamResponse

Представляет потоковый фрагмент ответа завершения чата, возвращаемого моделью, на основе предоставленных входных данных.

Имя Тип Описание Обязательно По умолчанию
Выбор массив Список вариантов завершения чата. Может содержать несколько элементов, если n больше 1.
Да
созданный целое число Метка времени Unix (в секундах) при создании завершения чата. Каждый блок имеет одинаковую метку времени. Да
идентификатор струна Уникальный идентификатор завершения чата. Каждый блок имеет один и тот же идентификатор. Да
модель струна Модель для создания завершения. Да
объект перечисление Тип объекта, который всегда chat.completion.chunkявляется .
Возможные значения: chat.completion.chunk
Да
системный отпечаток струна Этот отпечаток представляет конфигурацию серверной части, с которой работает модель.
Можно использовать в сочетании с параметром seed запроса, чтобы понять, когда внутренние изменения были внесены, что может повлиять на детерминированность.
нет

chatCompletionStreamResponseDelta

Разностное завершение чата, созданное потоковой передачей ответов модели.

Имя Тип Описание Обязательно По умолчанию
содержимое струна Содержимое сообщения блока. нет
вызов_функции объект Устаревшие и замененные tool_calls. Имя и аргументы вызываемой функции, созданной моделью. нет
└─ аргументы струна Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Обратите внимание, что модель не всегда создает допустимые json и может галлюцинировать параметры, не определенные схемой функции. Перед вызовом функции проверьте аргументы в коде. нет
└️ имя струна Имя вызываемой функции. нет
отказ струна Сообщение об отказе, созданное моделью. нет
роль перечисление Роль автора этого сообщения.
Возможные значения: system, , userassistanttool
нет
вызовы инструментов массив нет

чатКомплитМесседжТулКолЧанк

Имя Тип Описание Обязательно По умолчанию
функция объект нет
└─ аргументы струна Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Обратите внимание, что модель не всегда создает допустимые json и может галлюцинировать параметры, не определенные схемой функции. Перед вызовом функции проверьте аргументы в коде. нет
└️ имя струна Имя вызываемой функции. нет
идентификатор струна Идентификатор вызова средства. нет
индекс целое число Да
тип перечисление Тип средства. В настоящее время поддерживается только function .
Возможные значения: function
нет

Опции потока завершения чата (chatCompletionStreamOptions)

Параметры потокового ответа. Этот параметр устанавливается только при установке stream: true.

Имя Тип Описание Обязательно По умолчанию
включить_использование булевый Если задано, перед сообщением будет передаваться data: [DONE] дополнительный блок. Поле usage на этом блоке отображает статистику использования маркеров для всего запроса, и choices поле всегда будет пустым массивом. Все остальные блоки также будут содержать usage поле, но со значением NULL.
нет

Параметр chatCompletionChoiceLogProbs

Сведения о вероятности журнала для выбора.

Имя Тип Описание Обязательно По умолчанию
содержимое массив Список маркеров содержимого сообщения с информацией о вероятности журнала. Да
отказ массив Список маркеров отказа сообщения с информацией о вероятности журнала. нет

вероятностная логарифмическая оценка токена завершения чата

Имя Тип Описание Обязательно По умолчанию
байт массив Список целых чисел, представляющих представление маркера UTF-8 байт. Полезно в случаях, когда символы представлены несколькими токенами, а их байтовые представления должны объединяться для создания правильного текстового представления. Может быть null , если для маркера нет представления байтов. Да
logprob число/номер Вероятность этого токена в журнале. Да
токен струна Маркер. Да
top_logprobs массив Список наиболее вероятных маркеров и их вероятности журналов в этой позиции маркера. В редких случаях количество запрошенных top_logprobs возвращаемых данных может быть меньше. Да

сообщениеОтветОб окончанииЧата

Сообщение о завершении чата, созданное моделью.

Имя Тип Описание Обязательно По умолчанию
аудио объект Если запрашивается модальность вывода звука, этот объект содержит данные о звуковом ответе модели. нет
└─ Данные струна Звуковые байты в кодировке Base64, созданные моделью, в формате, указанном в запросе.
нет
└ истекает_в целое число Метка времени Unix (в секундах), когда этот звуковой ответ больше не будет доступен на сервере для использования в многоэтапных беседах.
нет
Идентификатор └️ струна Уникальный идентификатор для этого звукового ответа. нет
└─ Расшифровка струна Расшифровка звука, созданного моделью. нет
содержимое струна Содержимое сообщения. Да
контекст azureChatExtensionsMessageContext Представление дополнительных сведений о контексте, доступных при использовании расширений чата Azure OpenAI в создании соответствующего ответа на завершение чата. Эти сведения контекста заполняются только при использовании запроса Azure OpenAI, настроенного для использования соответствующего расширения. нет
вызов_функции вызов функции завершения чата Устаревшие и замененные tool_calls. Имя и аргументы вызываемой функции, созданной моделью. нет
отказ струна Сообщение об отказе, созданное моделью. Да
роль chatCompletionResponseMessageRole Роль автора сообщения ответа. Да
вызовы инструментов массив Вызовы средства, созданные моделью, например вызовы функций. нет

рольСообщенияОтветаЗавершенияЧата

Роль автора сообщения ответа.

Недвижимость Ценность
Описание Роль автора сообщения ответа.
Тип струна
Значения assistant

Опция выбора инструмента завершения чата

Определяет, какое средство (если таковое) вызывается моделью. none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение. auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов. required означает, что модель должна вызывать один или несколько инструментов. Указание определенного средства с помощью {"type": "function", "function": {"name": "my_function"}} принудительного вызова этого средства моделью. none значение по умолчанию, если средства отсутствуют. auto значение по умолчанию, если существуют средства.

Этот компонент может быть одним из следующих компонентов:

выборИменованногоИнструментаЗавершенияЧата

Указывает средство, которое должна использовать модель. Используется для принудительного вызова определенной функции.

Имя Тип Описание Обязательно По умолчанию
функция объект Да
└️ имя струна Имя вызываемой функции. нет
тип перечисление Тип средства. В настоящее время поддерживается только function .
Возможные значения: function
Да

ParallelToolCalls

Следует ли включить параллельные вызовы функций во время использования средства.

Для этого компонента не определены свойства.

ПрогнозContent

Статическое прогнозируемое выходное содержимое, например содержимое создаваемого текстового файла.

Имя Тип Описание Обязательно По умолчанию
содержимое строка или массив Содержимое, которое должно быть сопоставлено при создании ответа модели. Если созданные маркеры будут соответствовать этому содержимому, можно быстро вернуть весь ответ модели. Да
тип перечисление Тип прогнозируемого содержимого, который требуется предоставить. Этот тип в настоящее время всегда content.
Возможные значения: content
Да

чатCompletionMessageToolCalls

Вызовы средства, созданные моделью, например вызовы функций.

Для этого компонента не определены свойства.

Режимы завершения чата

Типы выходных данных, которые нужно создать для этого запроса. Большинство моделей могут создавать текст, который по умолчанию:

["text"]

Модель gpt-4o-audio-preview также может использоваться для создания звука. Чтобы запросить, что эта модель создает как текстовые, так и звуковые ответы, можно использовать:

["text", "audio"]

Для этого компонента не определены свойства.

chatCompletionFunctionCall

Устаревшие и замененные tool_calls. Имя и аргументы вызываемой функции, созданной моделью.

Имя Тип Описание Обязательно По умолчанию
аргументы струна Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Обратите внимание, что модель не всегда создает допустимые json и может галлюцинировать параметры, не определенные схемой функции. Перед вызовом функции проверьте аргументы в коде. Да
имя струна Имя вызываемой функции. Да

Использование завершения

Статистика использования для запроса завершения.

Имя Тип Описание Обязательно По умолчанию
токены завершения целое число Количество маркеров в созданном завершении. Да
детали_токенов_завершения объект Разбивка маркеров, используемых в завершении. нет
└️ accepted_prediction_tokens целое число При использовании прогнозируемых выходных данных число маркеров в прогнозе, появившемся в завершении. нет
└audio_tokens целое число Маркеры ввода звука, созданные моделью. нет
└️ reasoning_tokens целое число Маркеры, созданные моделью для рассуждений. нет
└─ отклонённые_токены_предсказания целое число При использовании прогнозируемых выходных данных число маркеров в прогнозе, которое не отображалось в завершении. Однако, как и маркеры причин, эти маркеры по-прежнему учитываются в общих маркерах завершения для целей выставления счетов, выходных данных и контекстного окна. нет
подсказывающие токены целое число Количество маркеров в запросе. Да
сведения_о_токенах_запроса объект Сведения о маркерах запроса. нет
└audio_tokens целое число Маркеры ввода звука, представленные в запросе. нет
└ cached_tokens целое число Количество кэшированных маркеров запроса. нет
общее количество токенов целое число Общее количество маркеров, используемых в запросе (запрос + завершение). Да

инструмент завершения чата

Имя Тип Описание Обязательно По умолчанию
функция FunctionObject Да
тип перечисление Тип средства. В настоящее время поддерживается только function .
Возможные значения: function
Да

ПараметрыФункции

Параметры, которые принимают функции, описаны как объект схемы JSON. Примеры см. в руководстве и справочнике по схеме JSON для документации по формату.

Опущение parameters определяет функцию с пустым списком параметров.

Для этого компонента не определены свойства.

FunctionObject

Имя Тип Описание Обязательно По умолчанию
описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
имя струна Имя вызываемой функции. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. Да
Параметры FunctionParameters Параметры, которые принимают функции, описаны как объект схемы JSON. Примеры см. в руководстве и справочнике по схеме JSON для документации по формату.

Опущение parameters определяет функцию с пустым списком параметров.
нет
строгий булевый Следует ли включить строгое соблюдение схемы при создании вызова функции. Если задано значение true, модель будет соответствовать точной схеме, определенной parameters в поле. Только подмножество схемы JSON поддерживается, если stricttrue. нет Неправда

ФорматОтветаТекст

Имя Тип Описание Обязательно По умолчанию
тип перечисление Тип формата ответа, который определяется: text
Возможные значения: text
Да

ФорматОтветаJsonObject

Имя Тип Описание Обязательно По умолчанию
тип перечисление Тип формата ответа, который определяется: json_object
Возможные значения: json_object
Да

ResponseFormatJsonSchemaSchemaSchema

Схема формата ответа, описанная как объект схемы JSON.

Для этого компонента не определены свойства.

ФорматОтветаJSONСхема

Имя Тип Описание Обязательно По умолчанию
JSON-схема объект Да
└─ Описание струна Описание формата ответа, которое используется моделью для определения того, как отвечать в этом формате. нет
└️ имя струна Имя формата ответа. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. нет
└─ Схема ResponseFormatJsonSchemaSchemaSchema Схема формата ответа, описанная как объект схемы JSON. нет
└─ строгий булевый Следует ли включить строгое соблюдение схемы при создании выходных данных. Если задано значение true, модель всегда будет соответствовать точной схеме, определенной schema в поле. Только подмножество схемы JSON поддерживается, если stricttrue. нет Неправда
тип перечисление Тип формата ответа, который определяется: json_schema
Возможные значения: json_schema
Да

общий выбор завершения чата

Имя Тип Описание Обязательно По умолчанию
причина окончания струна нет
индекс целое число нет

создатьЗапросНаПеревод

Запрос на перевод.

Имя Тип Описание Обязательно По умолчанию
файл струна Звуковой файл для перевода. Да
подсказка струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен находиться на английском языке. нет
формат_ответа audioResponseFormat Определяет формат выходных данных. нет
Температура число/номер Температура выборки от 0 до 1. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Если задано значение 0, модель будет использовать вероятность журнала для автоматического увеличения температуры до тех пор, пока определенные пороговые значения не будут достигнуты. нет 0

аудиоОтвет

Ответ на преобразование или транскрибирование при response_format json

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

audioVerboseResponse

Ответ перевода или транскрибирования при verbose_json response_format

Имя Тип Описание Обязательно По умолчанию
продолжительность число/номер Длительность. нет
язык струна Язык. нет
сегменты массив нет
задача струна Тип звуковой задачи. нет
текст струна Переведенный или транскрибированные тексты. Да
форме массив нет

формат аудиоответа

Определяет формат выходных данных.

Недвижимость Ценность
Описание Определяет формат выходных данных.
Тип струна
Значения json
text
srt
verbose_json
vtt

запрос на создание транскрипции

Запрос транскрибирования.

Имя Тип Описание Обязательно По умолчанию
файл струна Объект звукового файла для транскрибирования. Да
язык струна Язык входного звука. Предоставление языка ввода в формате ISO-639-1 повышает точность и задержку. нет
подсказка струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен соответствовать языку звука. нет
формат_ответа audioResponseFormat Определяет формат выходных данных. нет
Температура число/номер Температура выборки от 0 до 1. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Если задано значение 0, модель будет использовать вероятность журнала для автоматического увеличения температуры до тех пор, пока определенные пороговые значения не будут достигнуты. нет 0
timestamp_granularities[] массив Гранулярность метки времени для заполнения этой транскрибирования. response_format необходимо задать verbose_json для использования детализации метки времени. Поддерживаются либо оба этих параметра: wordили segment. Примечание. Дополнительная задержка для меток времени сегмента отсутствует, но при создании меток времени слова возникает дополнительная задержка. нет сегмент

аудиосегмент

Сегмент транскрибирования или перевода.

Имя Тип Описание Обязательно По умолчанию
avg_logprob число/номер Средняя вероятность журнала. нет
коэффициент сжатия число/номер Коэффициент уплотнения. нет
конец число/номер Смещение конца сегмента. нет
идентификатор целое число Идентификатор сегмента. нет
вероятность_отсутствия_речи число/номер Вероятность "нет речи". нет
искать число/номер Смещение сегмента. нет
начало число/номер Смещение запуска сегмента. нет
Температура число/номер Температура. нет
текст струна Сегментирование текста. нет
Маркеры массив Маркеры текста. нет

audioWord

Транскрибирование или перевод слова.

Имя Тип Описание Обязательно По умолчанию
конец число/номер Смещение конца Word. нет
начало число/номер Смещение запуска Word. нет
слово струна Слово нет

создать запрос на речь

Запрос речи.

Имя Тип Описание Обязательно По умолчанию
ввод струна Текст для синтеза звука. Максимальная длина — 4096 символов. Да
формат_ответа перечисление Формат синтеза звука в.
Возможные значения: mp3, opus, aac, flac, wav, pcm
нет
скорость число/номер Скорость синтезированного звука. Выберите значение из 0.254.0. 1.0 — это значение по умолчанию. нет 1.0
голос перечисление Голос, используемый для синтеза речи.
Возможные значения: alloy, echo, fable, onyx, nova, shimmer
Да

качество изображения

Качество создаваемого изображения.

Недвижимость Ценность
Описание Качество создаваемого изображения.
Тип струна
По умолчанию авто
Значения auto
high
medium
low
hd
standard

форматОтветаИзображений (imagesResponseFormat)

Формат, в котором возвращаются созданные изображения.

Недвижимость Ценность
Описание Формат, в котором возвращаются созданные изображения.
Тип струна
По умолчанию URL-адрес
Значения url
b64_json

формат вывода изображений

Формат файла, в котором возвращаются созданные изображения. Поддерживается только для gpt-image-1.

Недвижимость Ценность
Описание Формат файла, в котором возвращаются созданные изображения. Поддерживается только для gpt-image-1.
Тип струна
По умолчанию PNG
Значения png
jpeg

размер изображения

Размер созданных изображений.

Недвижимость Ценность
Описание Размер созданных изображений.
Тип струна
По умолчанию авто
Значения auto
1792x1024
1024x1792
1024x1024
1024x1536
1536x1024

стиль изображения

Стиль созданных изображений. Поддерживается только для dall-e-3.

Недвижимость Ценность
Описание Стиль созданных изображений. Поддерживается только для dall-e-3.
Тип струна
По умолчанию яркий
Значения vivid
natural

фон изображения

Позволяет задать прозрачность фона созданных образов. Этот параметр поддерживается только для gpt-image-1.

Недвижимость Ценность
Описание Позволяет задать прозрачность фона созданных образов. Этот параметр поддерживается только для gpt-image-1.
Тип струна
По умолчанию авто
Значения transparent
opaque
auto

Запрос на генерацию изображений

Имя Тип Описание Обязательно По умолчанию
фон imageBackground Позволяет задать прозрачность фона созданных образов. Этот параметр поддерживается только для gpt-image-1. нет авто
н целое число Количество генерируемых изображений. Для dall-e-3 поддерживается только n=1. нет 1
сжатие вывода целое число Уровень сжатия (0–100%) для созданных образов. Этот параметр поддерживается только для gpt-image-1 с форматом выходных данных JPEG. нет 100
формат_выходных_данных imagesOutputFormat Формат файла, в котором возвращаются созданные изображения. Поддерживается только для gpt-image-1. нет PNG
подсказка струна Текстовое описание требуемых изображений. Максимальная длина — 32000 символов для gpt-image-1 и 4000 символов для dall-e-3 Да
качество imageQuality Качество создаваемого изображения. нет авто
формат_ответа imagesResponseFormat Формат, в котором возвращаются созданные изображения. нет URL-адрес
размер imageSize Размер созданных изображений. нет авто
стиль imageStyle Стиль созданных изображений. Поддерживается только для dall-e-3. нет яркий
Пользователь струна Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений. нет

запросНаРедактированиеИзображений

Имя Тип Описание Обязательно По умолчанию
образ строка или массив Изображения для редактирования. Должен быть поддерживаемым файлом изображения или массивом изображений. Каждое изображение должно быть png или jpg-файл менее 25 МБ. Да
маска струна Дополнительное изображение с областями полной прозрачности (например, где альфа-канал равен нулю) указывает, где следует отредактировать изображение. Если есть несколько изображений, маска будет применена к первому изображению. Должен быть допустимым PNG-файлом, менее 4 МБ и иметь те же размеры, что и изображение. нет
н целое число Количество генерируемых изображений. нет 1
подсказка струна Текстовое описание требуемых изображений. Максимальная длина — 32000 символов. Да
качество imageQuality Качество создаваемого изображения. нет авто
формат_ответа imagesResponseFormat Формат, в котором возвращаются созданные изображения. нет URL-адрес
размер imageSize Размер созданных изображений. нет авто
Пользователь струна Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений. нет

generateImagesResponse

Имя Тип Описание Обязательно По умолчанию
созданный целое число Метка времени unix при создании операции. Да
данные массив Результат операции при успешном выполнении Да
использование imageGenerationsUsage Представляет сведения об использовании токенов для запросов на создание изображений. Только для gpt-image-1. нет

результат изображения

URL-адрес изображения или закодированный образ в случае успешного выполнения и ошибка в противном случае.

Имя Тип Описание Обязательно По умолчанию
b64_json струна Изображение в кодировке Base64 нет
результаты фильтрации контента РезультатыФильтрацииКонтентаDalle Сведения о результатах фильтрации содержимого. нет
результаты_фильтрации_запросов dalleFilterResults Сведения о категории фильтрации содержимого (ненавидимая, сексуальность, насилие, self_harm), если она обнаружена, а также уровень серьезности (very_low, низкий, средний, высокомасштабируемый, определяющий интенсивность и уровень риска вредного содержимого) и если он был отфильтрован или нет. Сведения о содержимом и ненормативной лексике, если он обнаружен, и если он был отфильтрован или нет. И сведения о списке блокировок клиента, если он был отфильтрован и его идентификатор. нет
пересмотренный_запрос струна Запрос, который использовался для создания образа, если в запросе была любая редакция. нет
URL-адрес струна URL-адрес изображения. нет

использование генераций изображений

Представляет сведения об использовании токенов для запросов на создание изображений. Только для gpt-image-1.

Имя Тип Описание Обязательно По умолчанию
входные_токены целое число Количество входных токенов. нет
детали_входных_токенов объект Подробная разбивка входных токенов. нет
└image_tokens целое число Количество токенов изображения. нет
└️ текст_токены целое число Количество текстовых маркеров. нет
выходные токены целое число Количество выходных токенов. нет
общее количество токенов целое число Общее количество используемых токенов. нет

линия

Объект строки содержимого, состоящий из соседней последовательности элементов содержимого, таких как слова и знаки выделения.

Имя Тип Описание Обязательно По умолчанию
Охватывает массив Массив диапазонов, представляющих обнаруженные объекты и сведения о ограничивающем поле. Да
текст струна Да

пядь

Объект диапазона, представляющий обнаруженный объект и сведения о ограничивающем поле.

Имя Тип Описание Обязательно По умолчанию
длина целое число Длина диапазона в символах, измеряемая в кодовых точках Юникода. Да
смещение целое число Смещение символов в тексте, в котором начинается диапазон. Это смещение определяется как позиция первого символа диапазона, подсчитывая от начала текста как кодовые точки Юникода. Да
многоугольник массив Массив объектов, представляющих точки в многоугольнике, который заключает обнаруженный объект. Да
текст струна Текстовое содержимое диапазона, представляющего обнаруженный объект. Да

использование завершения выполнения

Статистика использования, связанная с выполнением. Это значение будет иметь значение null , если выполнение не в состоянии терминала (т. е. in_progress, queuedи т. д.).

Имя Тип Описание Обязательно По умолчанию
токены завершения целое число Количество маркеров завершения, используемых в ходе выполнения. Да
подсказывающие токены целое число Количество маркеров запроса, используемых в ходе выполнения. Да
общее количество токенов целое число Общее количество используемых маркеров (запрос и завершение). Да

выполнение использования шага

Статистика использования, связанная с шагом выполнения. Это значение будет находиться null в состоянии in_progressшага выполнения.

Имя Тип Описание Обязательно По умолчанию
токены завершения целое число Количество маркеров завершения, используемых на этапе выполнения. Да
подсказывающие токены целое число Количество маркеров запроса, используемых на этапе выполнения. Да
общее количество токенов целое число Общее количество используемых маркеров (запрос и завершение). Да

ОпцияФорматаОтветаАссистентовAPI

Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.

Этот компонент может быть одним из следующих компонентов:

форматОтветаДляАссистентовApi

Объект, описывающий ожидаемые выходные данные модели. Если json_object в run разрешено передавать только function тип tools . Если text модель может возвращать текст или любое необходимое значение.

Имя Тип Описание Обязательно По умолчанию
тип струна Должен быть одним из text или json_object. нет текст

тип Enum: AssistantsApiResponseFormat

Ценность Описание
текст
объект JSON

ассистентОбъект

Представляет объект assistant , который может вызывать модель и использовать средства.

Имя Тип Описание Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) для момента создания помощника. Да
описание струна Описание помощника. Максимальная длина — 512 символов.
Да
идентификатор струна Идентификатор, на который можно ссылаться в конечных точках API. Да
инструкции струна Системные инструкции, которые использует помощник. Максимальная длина — 256 000 символов.
Да
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
Да
модель струна Идентификатор используемой модели. Да
имя струна Имя помощника. Максимальная длина — 256 символов.
Да
объект струна Тип объекта, который всегда assistantявляется . Да
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
ресурсы инструментов объект Набор ресурсов, используемых средствами помощника. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Идентификатор хранилища векторов, присоединенного к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
инструменты массив Список инструментов, включенных помощником. На помощника может быть не более 128 инструментов. Средства могут быть типами code_interpreter, file_searchили function.
Да []
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1

объект Enum: AssistantObjectType

Ценность Описание
помощник Тип объекта, который всегда является помощником

создатьЗапросАссистенту

Имя Тип Описание Обязательно По умолчанию
описание струна Описание помощника. Максимальная длина — 512 символов.
нет
инструкции струна Системные инструкции, которые использует помощник. Максимальная длина — 256 000 символов.
нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
модель струна Да
имя струна Имя помощника. Максимальная длина — 256 символов.
нет
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
ресурсы инструментов объект Набор ресурсов, используемых средствами помощника. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Хранилище векторов, присоединенное к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
└─ хранилища_векторов массив Помощник по созданию векторного хранилища с file_ids и присоединению его к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
инструменты массив Список инструментов, включенных помощником. На помощника может быть не более 128 инструментов. Средства могут быть типами code_interpreter, retrievalили function.
нет []
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1

изменитьЗапросАссистента

Имя Тип Описание Обязательно По умолчанию
описание струна Описание помощника. Максимальная длина — 512 символов.
нет
инструкции струна Системные инструкции, которые использует помощник. Максимальная длина — 32768 символов.
нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
модель струна нет
имя струна Имя помощника. Максимальная длина — 256 символов.
нет
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
ресурсы инструментов объект Набор ресурсов, используемых средствами помощника. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Переопределяет список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Переопределяет хранилище векторов, подключенное к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
инструменты массив Список инструментов, включенных помощником. На помощника может быть не более 128 инструментов. Средства могут быть типами code_interpreter, retrievalили function.
нет []
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1

удалитьОтветПомощника

Имя Тип Описание Обязательно По умолчанию
удалено булевый Да
идентификатор струна Да
объект струна Да

объект Enum: DeleteAssistantResponseState

Ценность Описание
ассистент удален

списокОтветовАссистентов

Имя Тип Описание Обязательно По умолчанию
данные массив Да
первый_идентификатор струна Да
есть_еще булевый Да
last_id струна Да
объект струна Да

Код инструментов ассистента

Имя Тип Описание Обязательно По умолчанию
тип струна Тип определяемого средства: code_interpreter Да

тип Enum: assistantToolsCodeType

Ценность Описание
Интерпретатор кода

инструментыАссистентаПоискаФайлов

Имя Тип Описание Обязательно По умолчанию
поиск файла объект Переопределяет средство поиска файлов. нет
└️ max_num_results целое число Максимальное количество результатов, которые должен выводить средство поиска файлов. Значение по умолчанию — 20 для моделей gpt-4* и 5 для gpt-3.5-turbo. Это число должно быть от 1 до 50 включительно.

Обратите внимание, что средство поиска файлов может выводить меньше max_num_results результатов.
нет
тип струна Тип определяемого средства: file_search Да

type Enum: Тип поиска файлов инструментов ассистента

Ценность Описание
поиск файла

инструменты помощника поиск файлов только по типу

Имя Тип Описание Обязательно По умолчанию
тип струна Тип определяемого средства: file_search Да

type Enum: Тип поиска файлов инструментов ассистента

Ценность Описание
поиск файла

функцияИнструментовАссистента

Имя Тип Описание Обязательно По умолчанию
функция объект Определение функции. Да
└─ Описание струна Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. нет
└️ имя струна Имя вызываемой функции. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. нет
Параметры └️ chatCompletionFunctionParameters (параметры функции завершения чата) Параметры, которые принимают функции, описаны как объект схемы JSON. См. руководство или примеры и справочник по схеме JSON для документации по формату. нет
тип струна Тип определяемого средства: function Да

Type Enum: assistantToolsFunction

Ценность Описание
функция

усечениеObject

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

Имя Тип Описание Обязательно По умолчанию
последние_сообщения целое число Количество последних сообщений из потока при создании контекста для выполнения. нет
тип струна Стратегия усечения, используемая для потока. Значение по умолчанию — auto. Если задано значение last_messages, поток будет усечен до n последних сообщений в потоке. Если задано значение auto, сообщения в середине потока будут удалены, чтобы соответствовать длине контекста модели. max_prompt_tokens Да

Type Enum: TruncationType

Ценность Описание
авто
последние_сообщения

опция выбора инструмента API для помощника

Определяет, какое средство (если таковое) вызывается моделью. none означает, что модель не будет вызывать средства и вместо этого создает сообщение. auto является значением по умолчанию и означает, что модель может выбирать между созданием сообщения или вызовом средства. Указание определенного инструмента, например {"type": "file_search"} или {"type": "function", "function": {"name": "my_function"}} принудительное вызов модели.

Этот компонент может быть одним из следующих компонентов:

выбор инструмента «assistantsNamed»

Указывает средство, которое должна использовать модель. Используйте для принудительного вызова модели определенного средства.

Имя Тип Описание Обязательно По умолчанию
функция объект нет
└️ имя струна Имя вызываемой функции. нет
тип струна Тип средства. Если тип имеет тип function, необходимо задать имя функции. Да

тип Enum: AssistantsNamedToolChoiceType

Ценность Описание
функция
Интерпретатор кода
поиск файла

runObject

Представляет выполнение процесса на потоке.

Имя Тип Описание Обязательно По умолчанию
идентификатор ассистента струна Идентификатор помощника, используемого для выполнения этого запуска. Да
отменено_в целое число Метка времени Unix (в секундах) для момента отмены выполнения. Да
завершено_в целое число Метка времени Unix (в секундах) для завершения выполнения. Да
создано_в целое число Метка времени Unix (в секундах) для момента создания запуска. Да
срок_действия_до целое число Метка времени Unix (в секундах) для истечения срока действия выполнения. Да
не удалось в целое число Метка времени Unix (в секундах) для момента сбоя выполнения. Да
идентификатор струна Идентификатор, на который можно ссылаться в конечных точках API. Да
неполные_данные объект Сведения о том, почему выполнение является неполным. Будет, null если выполнение не является неполным. Да
└─ Причина струна Причина, по которой выполнение является неполным. Это указывает, какой определенный предел маркера был достигнут в течение выполнения. нет
инструкции струна Инструкции, используемые помощником для этого запуска. Да
последняя_ошибка объект Последняя ошибка, связанная с этим выполнением. null Если ошибок нет. Да
└─ Код струна Один из server_error или rate_limit_exceeded. нет
Сообщение └️ струна Описание ошибки, доступной для чтения человеком. нет
max_completion_tokens (максимальное количество токенов завершения) целое число Максимальное количество маркеров завершения, указанных в ходе выполнения.
Да
максимальное количество токенов запроса целое число Максимальное количество маркеров запроса, указанных в ходе выполнения.
Да
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
Да
модель струна Модель, используемая помощником для этого запуска. Да
объект струна Тип объекта, который всегда thread.runявляется . Да
вызовы инструмента в параллельном режиме ParallelToolCalls Следует ли включить параллельные вызовы функций во время использования средства. нет Верно
требуемое_действие объект Сведения о действии, необходимом для продолжения выполнения. null Если никаких действий не требуется. Да
└─ отправить_выходные_данные_инструмента объект Сведения о выходных данных средства, необходимых для продолжения выполнения. нет
└─ вызовы_инструментов массив Список соответствующих вызовов средства. нет
└─ Тип перечисление На данный момент это всегда submit_tool_outputs.
Возможные значения: submit_tool_outputs
нет
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
Да
начато_в целое число Метка времени Unix (в секундах) для начала выполнения. Да
статус струна Состояние выполнения, которое может быть , , , , , queued, in_progressrequires_actionили cancelling. cancelledfailedcompletedexpired Да
Температура число/номер Температура выборки, используемая для этого запуска. Если значение не задано, значение по умолчанию — 1. нет
thread_id струна Идентификатор потока, на котором выполнялось выполнение в рамках этого запуска. Да
выбор инструмента assistantsApiToolChoiceOption Определяет, какое средство (если таковое) вызывается моделью.
none означает, что модель не будет вызывать средства и вместо этого создает сообщение.
auto является значением по умолчанию и означает, что модель может выбирать между созданием сообщения или вызовом средства.
Указание определенного инструмента, например {"type": "file_search"} или {"type": "function", "function": {"name": "my_function"}} принудительное вызов модели.
Да
инструменты массив Список инструментов, используемых помощником для этого запуска. Да []
top_p число/номер Значение выборки ядра, используемое для этого запуска. Если значение не задано, значение по умолчанию — 1. нет
стратегия усечения усечениеObject Определяет, как поток будет усечен до выполнения. Используйте это для управления начальным окном контекста выполнения. Да
использование runCompletionUsage Статистика использования, связанная с выполнением. Это значение будет иметь значение null , если выполнение не в состоянии терминала (т. е. in_progress, queuedи т. д.). Да

объект Enum: runObjectType

Ценность Описание
thread.run Тип объекта run, который всегда является thread.run

Состояние перечисления: RunObjectStatus

Ценность Описание
Очереди Состояние очереди
в процессе Состояние in_progress
требуется действие Состояние required_action
Отмена Состояние отмены
отменено Отмененное состояние
ошибка Состояние сбоя
завершено Завершенное состояние
срок действия истек Состояние с истекшим сроком действия

создатьЗапросНаЗапуск

Имя Тип Описание Обязательно По умолчанию
дополнительные_инструкции струна Добавляет дополнительные инструкции в конце инструкций для выполнения. Это полезно для изменения поведения на основе каждого запуска без переопределения других инструкций. нет
дополнительные_сообщения массив Добавляет дополнительные сообщения в поток перед созданием запуска. нет
идентификатор ассистента струна Идентификатор помощника, используемого для выполнения этого выполнения. Да
инструкции струна Переопределите системное сообщение помощника по умолчанию. Это полезно для изменения поведения на основе каждого запуска. нет
max_completion_tokens (максимальное количество токенов завершения) целое число Максимальное количество маркеров завершения, которые могут использоваться в ходе выполнения. Выполнение сделает все возможное, чтобы использовать только количество маркеров завершения, указанных в нескольких поворотах выполнения. Если выполнение превышает указанное число маркеров завершения, выполнение завершится состоянием incomplete. Дополнительные сведения см. в incomplete_details.
нет
максимальное количество токенов запроса целое число Максимальное количество маркеров запроса, которые могут использоваться в ходе выполнения. Выполнение сделает все возможное, чтобы использовать только количество маркеров запроса, указанных в нескольких поворотах выполнения. Если выполнение превышает указанное число маркеров запроса, выполнение завершится состоянием incomplete. Дополнительные сведения см. в incomplete_details.
нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
модель струна Идентификатор модели, используемой для выполнения этого выполнения. Если здесь указано значение, оно переопределит модель, связанную с помощником. В противном случае будет использоваться модель, связанная с помощником. нет
вызовы инструмента в параллельном режиме ParallelToolCalls Следует ли включить параллельные вызовы функций во время использования средства. нет Верно
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
поток булевый Если trueвозвращает поток событий, которые происходят во время событий запуска от имени сервера, завершая выполнение в состоянии терминала с сообщением data: [DONE] .
нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
выбор инструмента assistantsApiToolChoiceOption Определяет, какое средство (если таковое) вызывается моделью.
none означает, что модель не будет вызывать средства и вместо этого создает сообщение.
auto является значением по умолчанию и означает, что модель может выбирать между созданием сообщения или вызовом средства.
Указание определенного инструмента, например {"type": "file_search"} или {"type": "function", "function": {"name": "my_function"}} принудительное вызов модели.
нет
инструменты массив Переопределите средства, которые помощник может использовать для этого запуска. Это полезно для изменения поведения на основе каждого запуска. нет
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1
стратегия усечения усечениеObject Определяет, как поток будет усечен до выполнения. Используйте это для управления начальным окном контекста выполнения. нет

listRunsResponse

Имя Тип Описание Обязательно По умолчанию
данные массив Да
первый_идентификатор струна Да
есть_еще булевый Да
last_id струна Да
объект струна Да

изменитьЗапросВыполнения

Имя Тип Описание Обязательно По умолчанию
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет

отправитьЗапросНаЗапускВыходныхДанныхИнструмента

Имя Тип Описание Обязательно По умолчанию
поток булевый Если trueвозвращает поток событий, которые происходят во время событий запуска от имени сервера, завершая выполнение в состоянии терминала с сообщением data: [DONE] .
нет
выходные данные инструмента массив Список инструментов, для которых отправляются выходные данные. Да

Вызов объекта runTool

Объекты вызова средства

Имя Тип Описание Обязательно По умолчанию
функция объект Определение функции. Да
└─ аргументы струна Аргументы, которые модель ожидает передачи функции. нет
└️ имя струна Имя функции. нет
идентификатор струна Идентификатор вызова средства. Этот идентификатор должен ссылаться при отправке выходных данных средства с помощью выходных данных средства отправки для запуска endpointendpoint. Да
тип струна Для вызова выходных данных требуется тип средства. На данный момент это всегда function. Да

тип Enum: RunToolCallObjectType

Ценность Описание
функция

создать поток и выполнить запрос

Имя Тип Описание Обязательно По умолчанию
идентификатор ассистента струна Идентификатор помощника, используемого для выполнения этого выполнения. Да
инструкции струна Переопределите системное сообщение помощника по умолчанию. Это полезно для изменения поведения на основе каждого запуска. нет
max_completion_tokens (максимальное количество токенов завершения) целое число Максимальное количество маркеров завершения, которые могут использоваться в ходе выполнения. Выполнение сделает все возможное, чтобы использовать только количество маркеров завершения, указанных в нескольких поворотах выполнения. Если выполнение превышает указанное число маркеров завершения, выполнение завершится состоянием incomplete. Дополнительные сведения см. в incomplete_details.
нет
максимальное количество токенов запроса целое число Максимальное количество маркеров запроса, которые могут использоваться в ходе выполнения. Выполнение сделает все возможное, чтобы использовать только количество маркеров запроса, указанных в нескольких поворотах выполнения. Если выполнение превышает указанное число маркеров запроса, выполнение завершится состоянием incomplete. Дополнительные сведения см. в incomplete_details.
нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
модель струна Идентификатор моделей, используемых для выполнения этого выполнения. Если здесь указано значение, оно переопределит модель, связанную с помощником. В противном случае будет использоваться модель, связанная с помощником. нет
вызовы инструмента в параллельном режиме ParallelToolCalls Следует ли включить параллельные вызовы функций во время использования средства. нет Верно
формат_ответа assistantsApiResponseFormatOption Указывает формат, который модель должна выводить. Совместим с GPT-4o, GPT-4 Turbo и всеми моделями GPT-3.5 Turbo с тех пор gpt-3.5-turbo-1106.

Настройка { "type": "json_schema", "json_schema": {...} } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON. Дополнительные сведения см. в руководстве по структурированным выходным данным.

Параметр включения { "type": "json_object" } режима JSON, который гарантирует, что модель создает сообщение является допустимым JSON.

Важно: при использовании режима JSON необходимо также указать модели создавать JSON самостоятельно с помощью системного или пользовательского сообщения. Без этого модель может создать неуправляемый поток пробелов до тех пор, пока поколение не достигнет предела маркера, в результате чего длительный и, казалось бы, "застрявший" запрос. Кроме того, обратите внимание, что содержимое сообщения может быть частично отрезано, если finish_reason="length", что указывает на превышение поколения max_tokens или беседа превысила максимальную длину контекста.
нет
поток булевый Если trueвозвращает поток событий, которые происходят во время событий запуска от имени сервера, завершая выполнение в состоянии терминала с сообщением data: [DONE] .
нет
параметры_потока chatCompletionStreamOptions Параметры потокового ответа. Этот параметр устанавливается только при установке stream: true.
нет Отсутствует
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
нет 1
нить createThreadRequest нет
выбор инструмента assistantsApiToolChoiceOption Определяет, какое средство (если таковое) вызывается моделью.
none означает, что модель не будет вызывать средства и вместо этого создает сообщение.
auto является значением по умолчанию и означает, что модель может выбирать между созданием сообщения или вызовом средства.
Указание определенного инструмента, например {"type": "file_search"} или {"type": "function", "function": {"name": "my_function"}} принудительное вызов модели.
нет
ресурсы инструментов объект Набор ресурсов, используемых средствами помощника. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Идентификатор хранилища векторов, присоединенного к этому помощнику. К помощнику может быть подключено не более 1 векторного хранилища.
нет
инструменты массив Переопределите средства, которые помощник может использовать для этого запуска. Это полезно для изменения поведения на основе каждого запуска. нет
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить либо это значение, либо температуру, но не оба.
нет 1
стратегия усечения усечениеObject Определяет, как поток будет усечен до выполнения. Используйте это для управления начальным окном контекста выполнения. нет

threadObject

Представляет поток, содержащий сообщения.

Имя Тип Описание Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) для момента создания потока. Да
идентификатор струна Идентификатор, на который можно ссылаться в конечных точках API. Да
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
Да
объект струна Тип объекта, который всегда threadявляется . Да
ресурсы инструментов объект Набор ресурсов, доступных средствам помощника в этом потоке. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
Да
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Хранилище векторов, присоединенное к этому потоку. К потоку может быть подключено не более 1 векторного хранилища.
нет

объект Enum: ThreadObjectType

Ценность Описание
нить Тип объекта потока, который всегда является thread

createThreadRequest

Имя Тип Описание Обязательно По умолчанию
сообщения массив Список сообщений для запуска потока. нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
ресурсы инструментов объект Набор ресурсов, доступных средствам помощника в этом потоке. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Хранилище векторов, присоединенное к этому потоку. К потоку может быть подключено не более 1 векторного хранилища.
нет
└─ хранилища_векторов массив Вспомогательный объект для создания хранилища векторов с file_ids и присоединения его к этому потоку. К потоку может быть подключено не более 1 векторного хранилища.
нет

запрос на изменение темы

Имя Тип Описание Обязательно По умолчанию
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
ресурсы инструментов объект Набор ресурсов, доступных средствам помощника в этом потоке. Ресурсы относятся к типу инструмента. Например, для code_interpreter средства требуется список идентификаторов файлов, а для file_search этого средства требуется список идентификаторов векторного хранилища.
нет
└─ code_interpreter объект нет
└ file_ids массив Список идентификаторов файлов, доступных средству code_interpreter . С инструментом может быть не более 20 файлов.
нет []
└file_search объект нет
└️ vector_store_ids массив Хранилище векторов, присоединенное к этому потоку. К потоку может быть подключено не более 1 векторного хранилища.
нет

УдалитьОтветНаТему

Имя Тип Описание Обязательно По умолчанию
удалено булевый Да
идентификатор струна Да
объект струна Да

объект Enum: DeleteThreadResponseObjectState

Ценность Описание
поток.удален Состояние объекта ответа на поток удаления, которое является thread.deleted

listThreadsResponse

Имя Тип Описание Обязательно По умолчанию
данные массив Да
первый_идентификатор струна Да
есть_еще булевый Да
last_id струна Да
объект струна Да

объект сообщения

Представляет сообщение в потоке.

Имя Тип Описание Обязательно По умолчанию
идентификатор ассистента струна Если применимо, идентификатор помощника, создающего это сообщение. Да
Вложения массив Список файлов, присоединенных к сообщению, и инструменты, к которому они были добавлены. Да
завершено_в целое число Метка времени Unix (в секундах) для завершения сообщения. Да
содержимое массив Содержимое сообщения в массиве текста и(или) изображений. Да
создано_в целое число Метка времени Unix (в секундах) для момента создания сообщения. Да
идентификатор струна Идентификатор, на который можно ссылаться в конечных точках API. Да
незавершено_в целое число Метка времени Unix (в секундах) для момента, когда сообщение было отмечено как неполное. Да
неполные_данные объект В неполном сообщении сведения о том, почему сообщение является неполным. Да
└─ Причина струна Причина, по которой сообщение является неполным. нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
Да
объект струна Тип объекта, который всегда thread.messageявляется . Да
роль струна Сущность, создающая сообщение. Один из user или assistant. Да
идентификатор_запуска струна Если применимо, идентификатор выполнения, связанный с автором этого сообщения. Да
статус струна Состояние сообщения, которое может быть либо in_progress, incompleteлибо completed. Да
thread_id струна Идентификатор потока, к которому принадлежит это сообщение. Да

объект Enum: MessageObjectType

Ценность Описание
сообщение в теме Тип объекта сообщения, который является thread.message

Состояние перечисления: MessageObjectStatus

Ценность Описание
в процессе
неполный
завершено

перечисление роли: MessageObjectRole

Ценность Описание
Пользователь
помощник

messageDeltaObject

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

Имя Тип Описание Обязательно По умолчанию
дельта объект Разностное значение, содержащее поля, измененные в сообщении. Да
└─ Содержимое массив Содержимое сообщения в массиве текста и(или) изображений. нет
Роль струна Сущность, создающая сообщение. Один из user или assistant. нет
идентификатор струна Идентификатор сообщения, на которое можно ссылаться в конечных точках API. Да
объект струна Тип объекта, который всегда thread.message.deltaявляется . Да

объект Enum: MessageDeltaObjectType

Ценность Описание
поток.сообщение.дельта

создатьЗапросСообщения

Имя Тип Описание Обязательно По умолчанию
Вложения массив Список файлов, присоединенных к сообщению, и инструменты, к которому они должны быть добавлены. нет
содержимое струна Содержимое сообщения. Да
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
роль струна Роль сущности, создающей сообщение. Допустимые значения:
- user: указывает, что сообщение отправляется фактическим пользователем и должно использоваться в большинстве случаев для представления сообщений, созданных пользователем.
- assistant: указывает, что сообщение создается помощником. Используйте это значение для вставки сообщений от помощника в беседу.
Да

role Enum: CreateMessageRequestRole

Ценность Описание
Пользователь
помощник

запросНаИзменениеСообщения

Имя Тип Описание Обязательно По умолчанию
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет

ответ на удаление сообщения

Имя Тип Описание Обязательно По умолчанию
удалено булевый Да
идентификатор струна Да
объект струна Да

объект Enum: DeleteMessageResponseObject

Ценность Описание
сообщение.в.теме.удалено Состояние объекта ответа на удаление сообщения

Ответ на список сообщений

Имя Тип Описание Обязательно По умолчанию
данные массив Да
первый_идентификатор струна Да
есть_еще булевый Да
last_id струна Да
объект струна Да

ОбъектФайлаИзображенияСодержимогоСообщения

Ссылается на файл изображения в содержимом сообщения.

Имя Тип Описание Обязательно По умолчанию
изображение_файл объект Да
└ file_id струна Идентификатор файла изображения в содержимом сообщения. нет
тип струна Всегда image_file. Да

Тип Enum: MessageContentImageFileObjectType

Ценность Описание
изображение_файл Тип файла изображения содержимого сообщения

объект текстового содержимого сообщения

Текстовое содержимое, которое входит в сообщение.

Имя Тип Описание Обязательно По умолчанию
текст объект Да
└─ Заметки массив нет
└─ значение струна Данные, составляющие текст. нет
тип струна Всегда text. Да

тип Enum: messageContentTextObjectType

Ценность Описание
текст Тип текстового объекта содержимого сообщения

ОбъектЦитированияФайлаАннотацииСодержимогоСообщения

Ссылка в сообщении, указывающая на определенную цитату из определенного файла, связанного с помощником или сообщением. Создается, когда помощник использует средство "извлечения" для поиска файлов.

Имя Тип Описание Обязательно По умолчанию
конечный индекс целое число Да
ссылка_на_файл объект Да
└ file_id струна Идентификатор конкретного файла, из из который находится ссылка. нет
начальный_индекс целое число Да
текст струна Текст в содержимом сообщения, который необходимо заменить. Да
тип струна Всегда file_citation. Да

Type Enum: FileCitationObjectType

Ценность Описание
ссылка_на_файл Тип объекта ссылки на файл

ОбъектПутиФайлаТекстовыхАннотацийСодержимогоСообщения

URL-адрес файла, созданного при создании файла помощником, который использовал code_interpreter средство для создания файла.

Имя Тип Описание Обязательно По умолчанию
конечный индекс целое число Да
путь_к_файлу объект Да
└ file_id струна Идентификатор созданного файла. нет
начальный_индекс целое число Да
текст струна Текст в содержимом сообщения, который необходимо заменить. Да
тип струна Всегда file_path. Да

тип Enum: FilePathObjectType

Ценность Описание
путь_к_файлу Тип объекта пути к файлу

СообщениеДельтаКонтентИзображениеФайлОбъект

Ссылается на файл изображения в содержимом сообщения.

Имя Тип Описание Обязательно По умолчанию
изображение_файл объект нет
└ file_id струна Идентификатор файла изображения в содержимом сообщения. нет
индекс целое число Индекс части содержимого в сообщении. Да
тип струна Всегда image_file. Да

Тип Enum: MessageDeltaContentImageFileObjectType

Ценность Описание
изображение_файл

messageDeltaContentTextObject

Текстовое содержимое, которое входит в сообщение.

Имя Тип Описание Обязательно По умолчанию
индекс целое число Индекс части содержимого в сообщении. Да
текст объект нет
└─ Заметки массив нет
└─ значение струна Данные, составляющие текст. нет
тип струна Всегда text. Да

тип Enum: MessageDeltaContentTextObjectType

Ценность Описание
текст

объект цитирования файла аннотаций текста messageDeltaContent

Ссылка в сообщении, указывающая на определенную цитату из определенного файла, связанного с помощником или сообщением. Создается, когда помощник использует средство "file_search" для поиска файлов.

Имя Тип Описание Обязательно По умолчанию
конечный индекс целое число нет
ссылка_на_файл объект нет
└ file_id струна Идентификатор конкретного файла, из из который находится ссылка. нет
└─ Цитата струна Конкретная цитата в файле. нет
индекс целое число Индекс заметки в части текстового содержимого. Да
начальный_индекс целое число нет
текст струна Текст в содержимом сообщения, который необходимо заменить. нет
тип струна Всегда file_citation. Да

тип Enum: MessageDeltaContentTextAnnotationsFileCitationObjectType

Ценность Описание
ссылка_на_файл

messageDeltaСодержаниеТекстАннотацииFilePathОбъект

URL-адрес файла, созданного при создании файла помощником, который использовал code_interpreter средство для создания файла.

Имя Тип Описание Обязательно По умолчанию
конечный индекс целое число нет
путь_к_файлу объект нет
└ file_id струна Идентификатор созданного файла. нет
индекс целое число Индекс заметки в части текстового содержимого. Да
начальный_индекс целое число нет
текст струна Текст в содержимом сообщения, который необходимо заменить. нет
тип струна Всегда file_path. Да

тип Enum: MessageDeltaContentTextAnnotationsFilePathObjectType

Ценность Описание
путь_к_файлу

runStepObject

Представляет шаг выполнения выполнения выполнения.

Имя Тип Описание Обязательно По умолчанию
идентификатор ассистента струна Идентификатор помощника, связанного с шагом выполнения. Да
отменено_в целое число Метка времени Unix (в секундах) для момента отмены шага выполнения. Да
завершено_в целое число Метка времени Unix (в секундах) для завершения шага выполнения. Да
создано_в целое число Метка времени Unix (в секундах) для момента создания шага выполнения. Да
истекло_в целое число Метка времени Unix (в секундах) для истечения срока действия выполнения. Шаг считается истекшим, если срок действия родительского запуска истек. Да
не удалось в целое число Метка времени Unix (в секундах) для момента сбоя шага выполнения. Да
идентификатор струна Идентификатор шага выполнения, на который можно ссылаться в конечных точках API. Да
последняя_ошибка объект Последняя ошибка, связанная с этим шагом выполнения. null Если ошибок нет. Да
└─ Код струна Один из server_error или rate_limit_exceeded. нет
Сообщение └️ струна Описание ошибки, доступной для чтения человеком. нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
Да
объект струна Тип объекта, который всегда assistant.run.stepявляется . Да
идентификатор_запуска струна Идентификатор выполнения, на который выполняется этот шаг, является частью. Да
статус струна Состояние выполнения, которое может быть либо in_progress, либо cancelledfailedcompletedexpired. Да
детали шага runStepDetailsMessageCreationObject или runStepDetailsToolCallsObject Сведения о шаге выполнения. Да
thread_id струна Идентификатор выполняемых потоков. Да
тип струна Тип шага выполнения, который может быть либо message_creationtool_calls. Да

объект Enum: RunStepObjectType

Ценность Описание
assistant.run.step Тип объекта, который всегда является assistant.run.step

Тип Enum: RunStepObjectType

Ценность Описание
создание сообщения Шаг выполнения message_creation
вызовы инструментов Шаг выполнения tool_calls

состояние Перечисления: RunStepObjectStatus

Ценность Описание
в процессе Состояние выполнения in_progress
отменено Состояние отмененного выполнения
ошибка Состояние отмененного выполнения
завершено Состояние отмененного выполнения
срок действия истек Состояние отмененного выполнения

runStepDeltaObject

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

Имя Тип Описание Обязательно По умолчанию
дельта объект Разностное значение, содержащее поля, измененные на шаге выполнения. Да
└─ детали_шага runStepDeltaStepDetailsMessageCreationObject или runStepDeltaStepDetailsToolCallsObject Сведения о шаге выполнения. нет
идентификатор струна Идентификатор шага выполнения, на который можно ссылаться в конечных точках API. Да
объект струна Тип объекта, который всегда thread.run.step.deltaявляется . Да

объект Enum: RunStepDeltaObjectType

Ценность Описание
thread.run.step.delta

listRunStepsResponse

Имя Тип Описание Обязательно По умолчанию
данные массив Да
первый_идентификатор струна Да
есть_еще булевый Да
last_id струна Да
объект струна Да

объектСозданияСообщенияДеталейШагаЗапуска

Сведения о создании сообщения на шаге выполнения.

Имя Тип Описание Обязательно По умолчанию
создание сообщения объект Да
└ message_id струна Идентификатор сообщения, созданного на этом шаге выполнения. нет
тип струна Всегда message_creation. Да

тип Enum: RunStepDetailsMessageCreationObjectType

Ценность Описание
создание сообщения

выполнениеШагаДеталиСозданияСообщенияОбъект

Сведения о создании сообщения на шаге выполнения.

Имя Тип Описание Обязательно По умолчанию
создание сообщения объект нет
└ message_id струна Идентификатор сообщения, созданного на этом шаге выполнения. нет
тип струна Всегда message_creation. Да

type Enum: ШагЗапускаСдвигаШагПодробностиСозданиеСообщенияТипОбъекта

Ценность Описание
создание сообщения

runStepDetailsToolCallsObject

Сведения о вызове средства.

Имя Тип Описание Обязательно По умолчанию
вызовы инструментов массив Массив инструментов вызывает этап выполнения. Они могут быть связаны с одним из трех типов инструментов: code_interpreterretrieval или function.
Да
тип струна Всегда tool_calls. Да

тип Enum: RunStepDetailsToolCallsObjectType

Ценность Описание
вызовы инструментов

запуск шага, изменения шага, детали инструмента, вызовы объекта

Сведения о вызове средства.

Имя Тип Описание Обязательно По умолчанию
вызовы инструментов массив Массив инструментов вызывает этап выполнения. Они могут быть связаны с одним из трех типов инструментов: code_interpreterfile_search или function.
нет
тип струна Всегда tool_calls. Да

тип Enum: RunStepDeltaStepDetailsToolCallsObjectType

Ценность Описание
вызовы инструментов

запускШагПодробностиИнструментВызовыКодОбъект

Сведения о средстве интерпретатора кода, в котором был задействован шаг выполнения.

Имя Тип Описание Обязательно По умолчанию
Интерпретатор кода объект Определение вызова средства интерпретатора кода. Да
└─ Входные данные струна Входные данные вызова средства интерпретатора кода. нет
└─ Выходные данные массив Выходные данные вызова средства интерпретатора кода. Интерпретатор кода может выводить один или несколько элементов, включая текст (logs) или изображения (image). Каждая из них представлена различным типом объекта. нет
идентификатор струна Идентификатор вызова средства. Да
тип струна Тип вызова средства. Это всегда будет для code_interpreter этого типа вызова средства. Да

тип Enum: RunStepDetailsToolCallsCodeObjectType

Ценность Описание
Интерпретатор кода

ЗапускШагаДеталиШагИнструментВызываетКодОбъект

Сведения о средстве интерпретатора кода, в котором был задействован шаг выполнения.

Имя Тип Описание Обязательно По умолчанию
Интерпретатор кода объект Определение вызова средства интерпретатора кода. нет
└─ Входные данные струна Входные данные вызова средства интерпретатора кода. нет
└─ Выходные данные массив Выходные данные вызова средства интерпретатора кода. Интерпретатор кода может выводить один или несколько элементов, включая текст (logs) или изображения (image). Каждая из них представлена различным типом объекта. нет
идентификатор струна Идентификатор вызова средства. нет
индекс целое число Индекс вызова средства в массиве вызовов средства. Да
тип струна Тип вызова средства. Это всегда будет для code_interpreter этого типа вызова средства. Да

тип Enum: RunStepDeltaStepDetailsToolCallsCodeObjectType

Ценность Описание
Интерпретатор кода

ЗапускДеталиШагаВызовыИнструментаКодВыводЛогиОбъект

Текстовые выходные данные из вызова средства интерпретатора кода в рамках шага выполнения.

Имя Тип Описание Обязательно По умолчанию
журналы струна Вывод текста из вызова средства интерпретатора кода. Да
тип струна Всегда logs. Да

Тип Enum: Объект RunStepDetailsToolCallsCodeOutputLogsObjectType

Ценность Описание
журналы

запуститьШагДельтаШагДеталиВызовыИнструментаКодВыводЛогиОбъект

Текстовые выходные данные из вызова средства интерпретатора кода в рамках шага выполнения.

Имя Тип Описание Обязательно По умолчанию
индекс целое число Индекс выходных данных в массиве выходных данных. Да
журналы струна Вывод текста из вызова средства интерпретатора кода. нет
тип струна Всегда logs. Да

type Enum: ЗапускШагДельтаШагДеталиВызовыИнструментовКодВыводЛогиТипОбъекта

Ценность Описание
журналы

ЗапуститьШагДеталиИнструментаВызовыКодаВыводИзображенияОбъект

Имя Тип Описание Обязательно По умолчанию
образ объект Да
└ file_id струна Идентификатор файла изображения. нет
тип струна Всегда image. Да

тип Enum: RunStepDetailsToolCallsCodeOutputImageObjectType

Ценность Описание
образ

ВыполнитьШагДельтаШагДеталиИнструментВызовыКодРезультатИзображениеОбъект

Имя Тип Описание Обязательно По умолчанию
образ объект нет
└ file_id струна Идентификатор файла изображения. нет
индекс целое число Индекс выходных данных в массиве выходных данных. Да
тип струна Всегда image. Да

тип Enum: RunStepDeltaStepDetailsToolCallsCodeOutputImageObject

Ценность Описание
образ

runStepDetailsToolCallsFileSearchObject

Имя Тип Описание Обязательно По умолчанию
поиск файла объект В настоящее время это всегда будет пустым объектом. Да
└─ Результаты массив Результаты поиска файла. нет
идентификатор струна Идентификатор объекта вызова средства. Да
тип струна Тип вызова средства. Это всегда будет для file_search этого типа вызова средства. Да

Тип Enum: RunStepDetailsToolCallsFileSearchObjectType

Ценность Описание
поиск файла

ТекущийШагПодробностиИнструментаВызовыПоискаФайловРезультатОбъект

Результирующий экземпляр поиска файла.

Имя Тип Описание Обязательно По умолчанию
содержимое массив Содержимое найденного результата. Содержимое включается только в том случае, если он запрашивается с помощью параметра запроса include. нет
идентификатор_файла струна Идентификатор файла, в который был найден результат. Да
имя_файла струна Имя файла, в результате в который был найден результат. Да
счёт число/номер Оценка результата. Все значения должны быть числом с плавающей запятой от 0 до 1. Да

ШагВыполненияDeltaДеталиИнструментаВызовыПоискаФайлаОбъект

Имя Тип Описание Обязательно По умолчанию
поиск файла объект В настоящее время это всегда будет пустым объектом. Да
идентификатор струна Идентификатор объекта вызова средства. нет
индекс целое число Индекс вызова средства в массиве вызовов средства. Да
тип струна Тип вызова средства. Это всегда будет для retrieval этого типа вызова средства. Да

тип Enum: RunStepDeltaStepDetailsToolCallsFileSearchObjectType

Ценность Описание
поиск файла

Запуск шага деталей инструмента вызывает объект функции

Имя Тип Описание Обязательно По умолчанию
функция объект Определение вызываемой функции. Да
└─ аргументы струна Аргументы, переданные функции. нет
└️ имя струна Имя функции. нет
вывод └─ струна Выходные данные функции. Это будет, null если выходные данные еще не отправлены. нет
идентификатор струна Идентификатор объекта вызова средства. Да
тип струна Тип вызова средства. Это всегда будет для function этого типа вызова средства. Да

тип Enum: RunStepDetailsToolCallsFunctionObjectType

Ценность Описание
функция

выполнениеШагаDeltaШагДеталиИнструментаВызываетФункциональныйОбъект

Имя Тип Описание Обязательно По умолчанию
функция объект Определение вызываемой функции. нет
└─ аргументы струна Аргументы, переданные функции. нет
└️ имя струна Имя функции. нет
вывод └─ струна Выходные данные функции. Это будет, null если выходные данные еще не отправлены. нет
идентификатор струна Идентификатор объекта вызова средства. нет
индекс целое число Индекс вызова средства в массиве вызовов средства. Да
тип струна Тип вызова средства. Это всегда будет для function этого типа вызова средства. Да

тип Enum: RunStepDetailsToolCallsFunctionObjectType

Ценность Описание
функция

срок_истечения_после_хранения_в_векторе

Политика истечения срока действия для хранилища векторов.

Имя Тип Описание Обязательно По умолчанию
привязка струна Метка времени привязки, после которой применяется политика истечения срока действия. Поддерживаемые привязки: last_active_at. Да
Дни целое число Количество дней после истечения срока действия привязки хранилища векторов. Да

перечисление привязки: VectorStoreExpirationAfterAnchor

Ценность Описание
последнее время активности Метка времени привязки, после которой применяется политика истечения срока действия.

vectorStoreObject

Векторное хранилище — это коллекция обработанных файлов, которые можно использовать file_search средством.

Имя Тип Описание Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) для создания векторного хранилища. Да
истекает через vectorStoreExpirationAfter Политика истечения срока действия для хранилища векторов. нет
срок_действия_до целое число Метка времени Unix (в секундах) для истечения срока действия хранилища векторов. нет
количество_файлов объект Да
└️ отменено целое число Количество отмененных файлов. нет
└️ завершено целое число Количество успешно обработанных файлов. нет
└─ Ошибка целое число Количество файлов, которые не удалось обработать. нет
└─ в процессе целое число Количество обрабатываемых файлов. нет
└─ всего целое число Общее количество файлов. нет
идентификатор струна Идентификатор, на который можно ссылаться в конечных точках API. Да
последнее время активности целое число Метка времени Unix (в секундах) для последнего активного хранилища векторов. Да
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
Да
имя струна Имя векторного хранилища. Да
объект перечисление Тип объекта, который всегда vector_storeявляется .
Возможные значения: vector_store
Да
статус струна Состояние векторного хранилища, которое может быть либо expired, in_progressлибо completed. Состояние указывает, что хранилище векторов completed готово для использования. Да
использование_байты целое число Общее количество байтов, используемых файлами в хранилище векторов. Да

Перечисление состояния: VectorStoreObjectStatus

Ценность Описание
срок действия истек
в процессе
завершено

Запрос на создание хранилища векторов

Имя Тип Описание Обязательно По умолчанию
стратегия разбивки на части autoChunkingStrategyRequestParam или staticChunkingStrategyRequestParam Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . Применимо только в том случае, если file_ids не пуст. нет
истекает через vectorStoreExpirationAfter Политика истечения срока действия для хранилища векторов. нет
идентификаторы_файлов массив Список идентификаторов файлов, которые следует использовать векторным хранилищем. Полезно для таких средств, как file_search доступ к файлам. нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
имя струна Имя векторного хранилища. нет

запрос на обновление хранилища векторов

Имя Тип Описание Обязательно По умолчанию
истекает через vectorStoreExpirationAfter Политика истечения срока действия для хранилища векторов. нет
метаданные объект Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате. Ключи могут содержать не более 64 символов, а значения могут содержать не более 512 символов.
нет
имя струна Имя векторного хранилища. нет

Ответ на запрос списка хранилищ векторов

Имя Тип Описание Обязательно По умолчанию
данные массив Да
первый_идентификатор струна Да
есть_еще булевый Да
last_id струна Да
объект струна Да

deleteVectorStoreResponse

Имя Тип Описание Обязательно По умолчанию
удалено булевый Да
идентификатор струна Да
объект струна Да

объект Enum: DeleteVectorStoreResponseObject

Ценность Описание
хранилище_векторов.удалено Состояние объекта ответа хранилища векторов удаления

объект файла хранилища векторов

Список файлов, подключенных к хранилищу векторов.

Имя Тип Описание Обязательно По умолчанию
стратегия разбивки на части autoChunkingStrategyRequestParam или staticChunkingStrategyRequestParam Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . Применимо только в том случае, если file_ids не пуст. нет
создано_в целое число Метка времени Unix (в секундах) для момента создания файла векторного хранилища. Да
идентификатор струна Идентификатор, на который можно ссылаться в конечных точках API. Да
последняя_ошибка объект Последняя ошибка, связанная с этим файлом хранилища векторов. null Если ошибок нет. Да
└─ Код струна Одно или server_errorinvalid_file или unsupported_file. нет
Сообщение └️ струна Описание ошибки, доступной для чтения человеком. нет
объект струна Тип объекта, который всегда vector_store.fileявляется . Да
статус струна Состояние файла векторного хранилища, который может быть либо in_progress, completedcancelledлибо failed. completed Состояние указывает, что файл векторного хранилища готов к использованию. Да
использование_байты целое число Общее использование векторного хранилища в байтах. Обратите внимание, что это может отличаться от исходного размера файла. Да
идентификатор_хранилища_векторов струна Идентификатор векторного хранилища, к которому подключен файл. Да

объект Enum: VectorStoreFileObjectType

Ценность Описание
векторное_хранилище.файл

Состояние перечисления: VectorStoreFileObjectStatus

Ценность Описание
в процессе
завершено
отменено
ошибка

другой параметр ответа стратегии разбиения

Это возвращается, когда стратегия блокирования неизвестна. Как правило, это связано с тем, что файл был индексирован до chunking_strategy появления концепции в API.

Имя Тип Описание Обязательно По умолчанию
тип струна Всегда other. Да

тип Enum: OtherChunkingStrategyResponseParamType

Ценность Описание
иное

Параметр ответа стратегии статического разбиения на части

Имя Тип Описание Обязательно По умолчанию
статичный staticChunkingStrategy Да
тип струна Всегда static. Да

тип Enum: StaticChunkingStrategyResponseParamType

Ценность Описание
статичный

staticChunkingStrategy

Имя Тип Описание Обязательно По умолчанию
Параметр_перекрытия_токенов целое число Количество маркеров, перекрывающихся между блоками. Значение по умолчанию — 400.

Обратите внимание, что перекрытие не должно превышать половину max_chunk_size_tokens.
Да
максимальный размер чанка в токенах целое число Максимальное количество токенов в каждом блоке. Значение по умолчанию — 800. Минимальное значение равно 100 , а максимальное — 4096. Да

Параметр запроса стратегии автоматического разбиения на части

Стратегия по умолчанию. В настоящее время эта стратегия использует и max_chunk_size_tokens имеет значение 800chunk_overlap_tokens .400

Имя Тип Описание Обязательно По умолчанию
тип перечисление Всегда auto.
Возможные значения: auto
Да

staticChunkingStrategyRequestParam (Параметр запроса статической стратегии разбиения)

Имя Тип Описание Обязательно По умолчанию
статичный staticChunkingStrategy Да
тип перечисление Всегда static.
Возможные значения: static
Да

Параметр запроса стратегии разбиения на части

Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto .

Этот компонент может быть одним из следующих компонентов:

createVectorStoreFileRequest

Имя Тип Описание Обязательно По умолчанию
стратегия разбивки на части chunkingStrategyRequestParam Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . нет
идентификатор_файла струна Идентификатор файла, который должен использовать хранилище векторов. Полезно для таких средств, как file_search доступ к файлам. Да

списокФайловВекторногоХранилищаОтвет

Имя Тип Описание Обязательно По умолчанию
данные массив Да
первый_идентификатор струна Да
есть_еще булевый Да
last_id струна Да
объект струна Да

Ответ на удаление файла хранилища векторных данных

Имя Тип Описание Обязательно По умолчанию
удалено булевый Да
идентификатор струна Да
объект струна Да

объект Enum: DeleteVectorStoreFileResponseObject

Ценность Описание
хранилище_векторов.файл.удален

vectorStoreFileBatchObject

Пакет файлов, присоединенных к хранилищу векторов.

Имя Тип Описание Обязательно По умолчанию
создано_в целое число Метка времени Unix (в секундах) для создания пакета файлов векторного хранилища. Да
количество_файлов объект Да
└️ отменено целое число Количество отмененных файлов. нет
└️ завершено целое число Количество обработанных файлов. нет
└─ Ошибка целое число Количество файлов, которые не удалось обработать. нет
└─ в процессе целое число Количество обрабатываемых файлов. нет
└─ всего целое число Общее количество файлов. нет
идентификатор струна Идентификатор, на который можно ссылаться в конечных точках API. Да
объект струна Тип объекта, который всегда vector_store.file_batchявляется . Да
статус струна Состояние пакета векторного хранилища файлов, которые могут быть либо in_progress, completedcancelled либо failed. Да
идентификатор_хранилища_векторов струна Идентификатор векторного хранилища, к которому подключен файл. Да

объект Enum: VectorStoreFileBatchObjectType

Ценность Описание
vector_store.файлы_пакет

состояние перечисления: VectorStoreFileBatchObjectStatus

Ценность Описание
в процессе
завершено
отменено
ошибка

createVectorStoreFileBatchRequest

Имя Тип Описание Обязательно По умолчанию
стратегия разбивки на части chunkingStrategyRequestParam Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . нет
идентификаторы_файлов массив Список идентификаторов файлов, которые следует использовать векторном хранилище. Полезно для таких средств, как file_search доступ к файлам. Да

assistantStreamEvent

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

Каждое событие в потоке событий, отправляемых сервером event , имеет и data свойство:

event: thread.created
data: {"id": "thread_123", "object": "thread", ...}

Мы генерируем события при создании нового объекта, переходе к новому состоянию или потоковой передаче в части (разностные). Например, при создании thread.run.created нового запуска, thread.run.completed при завершении выполнения и т. д. Когда помощник выбирает создание сообщения во время выполнения, мы создадим thread.message.created eventсобытие, thread.message.in_progress много thread.message.delta событий и, наконец thread.message.completed , событие.

С течением времени мы можем добавлять дополнительные события, поэтому мы рекомендуем правильно обрабатывать неизвестные события в коде.

Этот компонент может быть одним из следующих компонентов:

threadStreamEvent

Этот компонент может быть одним из следующих компонентов:

поток.создан

Происходит при создании нового потока.

Имя Тип Описание Обязательно По умолчанию
данные threadObject Представляет поток, содержащий сообщения. Да
событие струна Да

Данные: threadObject

Перечисление событий: ThreadStreamEventEnum

Ценность Описание
поток.создан Событие создания потока

runStreamEvent

Этот компонент может быть одним из следующих компонентов:

thread.run.created

Возникает при создании нового запуска.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление событий: RunStreamEventCreated

Ценность Описание
thread.run.created

thread.run.queued

Происходит при перемещении queued выполнения в состояние.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление событий: RunStreamEventQueued

Ценность Описание
thread.run.queued

поток.выполняется.в_процессе

Происходит при перемещении in_progress выполнения в состояние.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление событий: RunStreamEventInProgress

Ценность Описание
поток.выполняется.в_процессе

поток.запуск.требуется_действие

Происходит при перемещении requires_action выполнения в состояние.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление события: RunStreamEventRequiresAction

Ценность Описание
поток.запуск.требуется_действие

поток.выполнение.завершено

Происходит при завершении выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление события: RunStreamEventCompleted

Ценность Описание
поток.выполнение.завершено

thread.run.failed

Происходит при сбое выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление событий: RunStreamEventFailed

Ценность Описание
thread.run.failed

поток.запуск.отмена

Происходит при перемещении cancelling выполнения в состояние.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление события: RunStreamEventCancelling

Ценность Описание
поток.запуск.отмена

thread.run.отменено

Происходит при отмене выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление событий: RunStreamEventCancelled

Ценность Описание
thread.run.cancelled

выполнение потока завершено

Происходит при истечении срока действия выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runObject Представляет выполнение процесса на потоке. Да
событие струна Да

Данные: runObject

Перечисление событий: RunStreamEventExpired

Ценность Описание
выполнение потока завершено

runStepStreamEvent

Этот компонент может быть одним из следующих компонентов:

thread.run.step.created

Происходит при создании шага выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runStepObject Представляет шаг выполнения выполнения выполнения.
Да
событие струна Да

Данные: runStepObject

Перечисление событий: RunStepStreamEventCreated

Ценность Описание
thread.run.step.created

шаг выполнения потока в процессе

Происходит при переходе in_progress шага выполнения в состояние.

Имя Тип Описание Обязательно По умолчанию
данные runStepObject Представляет шаг выполнения выполнения выполнения.
Да
событие струна Да

Данные: runStepObject

Перечисление событий: RunStepStreamEventInProgress

Ценность Описание
шаг выполнения потока в процессе

thread.run.step.delta

Происходит при потоковой передаче частей шага выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runStepDeltaObject Представляет разностную смену шага выполнения, т. е. любые измененные поля на шаге выполнения во время потоковой передачи.
Да
событие струна Да

Данные: runStepDeltaObject

Перечисление события: RunStepStreamEventDelta

Ценность Описание
thread.run.step.delta

поток.выполнение.шаг.завершен

Происходит при завершении шага выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runStepObject Представляет шаг выполнения выполнения выполнения.
Да
событие струна Да

Данные: runStepObject

Перечисление событий: RunStepStreamEventCompleted

Ценность Описание
поток.выполнение.шаг.завершен

ошибка выполнения шага в потоке

Происходит при сбое шага выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runStepObject Представляет шаг выполнения выполнения выполнения.
Да
событие струна Да

Данные: runStepObject

Перечисление событий: RunStepStreamEventFailed

Ценность Описание
ошибка выполнения шага в потоке

поток.выполнить.шаг.отменён

Происходит при отмене шага выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runStepObject Представляет шаг выполнения выполнения выполнения.
Да
событие струна Да

Данные: runStepObject

Перечисление событий: RunStepStreamEventCancelled

Ценность Описание
поток.выполнить.шаг.отменён

Поток.запуск.шаг.истёк

Происходит при истечении срока действия выполнения.

Имя Тип Описание Обязательно По умолчанию
данные runStepObject Представляет шаг выполнения выполнения выполнения.
Да
событие струна Да

Данные: runStepObject

Перечисление событий: RunStepStreamEventExpired

Ценность Описание
Поток.запуск.шаг.истёк

событиеПотокаСообщений

Этот компонент может быть одним из следующих компонентов:

сообщение.создано.в_теме

Происходит при создании сообщения.

Имя Тип Описание Обязательно По умолчанию
данные messageObject Представляет сообщение в потоке. Да
событие струна Да

Данные: messageObject

Перечисление событий: MessageStreamEventCreated

Ценность Описание
сообщение.создано.в_теме

сообщение потока в процессе выполнения

Происходит при перемещении in_progress сообщения в состояние.

Имя Тип Описание Обязательно По умолчанию
данные messageObject Представляет сообщение в потоке. Да
событие струна Да

Данные: messageObject

Перечисление события: MessageStreamEventInProgress

Ценность Описание
сообщение потока в процессе выполнения

поток.сообщение.дельта

Происходит при потоковой передаче частей сообщения.

Имя Тип Описание Обязательно По умолчанию
данные messageDeltaObject Представляет разностную передачу сообщения, т. е. любые измененные поля в сообщении во время потоковой передачи.
Да
событие струна Да

Данные: messageDeltaObject

Перечисление события: MessageStreamEventDelta

Ценность Описание
поток.сообщение.дельта

цепочка.сообщение.завершено

Происходит при завершении сообщения.

Имя Тип Описание Обязательно По умолчанию
данные messageObject Представляет сообщение в потоке. Да
событие струна Да

Данные: messageObject

Перечисление событий: MessageStreamEventCompleted

Ценность Описание
цепочка.сообщение.завершено

поток.сообщение.неполное

Происходит, когда сообщение заканчивается до завершения.

Имя Тип Описание Обязательно По умолчанию
данные messageObject Представляет сообщение в потоке. Да
событие струна Да

Данные: messageObject

Перечисление событий: MessageStreamEventIncomplete

Ценность Описание
поток.сообщение.неполное

Аннотация

Этот компонент может быть одним из следующих компонентов:

Щелкните

Действие щелчка.

Имя Тип Описание Обязательно По умолчанию
кнопка перечисление Указывает, какая кнопка мыши была нажата во время нажатия кнопки. Одно из значений left, right, wheel, back или forward.

Возможные значения: left, right, wheel, back, forward
Да
тип перечисление Указывает тип события. Для действия щелчка это свойство всегда имеет значение click.

Возможные значения: click
Да
x целое число Координата x, в которой произошло нажатие.
Да
и целое число Координата y, в которой произошло нажатие.
Да

ВыходнойФайлИнтерпретатораКода

Выходные данные вызова средства интерпретатора кода, представляющие собой файл.

Имя Тип Описание Обязательно По умолчанию
Файлы массив Да
тип перечисление Тип выходных данных файла интерпретатора кода. Всегда files.

Возможные значения: files
Да

Кодовый Интерпретатор: Текстовый Вывод

Выходные данные вызова средства интерпретатора кода, который является текстом.

Имя Тип Описание Обязательно По умолчанию
журналы струна Журналы вызова средства интерпретатора кода.
Да
тип перечисление Тип вывода текста интерпретатора кода. Всегда logs.

Возможные значения: logs
Да

CodeInterpreterTool

Средство, выполняющее код.

Имя Тип Описание Обязательно По умолчанию
идентификаторы_файлов массив Идентификаторы файлов для запуска кода.
Да
тип перечисление Тип средства интерпретатора кода. Всегда code_interpreter.

Возможные значения: code_interpreter
Да

ВызовИнструментаИнтерпретатораКода

Вызов инструмента для выполнения кода.

Имя Тип Описание Обязательно По умолчанию
код струна Код для выполнения.
Да
идентификатор струна Уникальный идентификатор вызова средства интерпретатора кода.
Да
Результаты массив Результаты вызова средства интерпретатора кода.
Да
статус перечисление Состояние вызова средства интерпретатора кода.

Возможные значения: in_progress, interpretingcompleted
Да
тип перечисление Тип вызова средства интерпретатора кода. Всегда code_interpreter_call.

Возможные значения: code_interpreter_call
Да

РезультатыИнструментаИнтерпретатораКода

Этот компонент может быть одним из следующих компонентов:

ФильтрСравнения

Фильтр, используемый для сравнения указанного ключа атрибута с заданным значением с помощью определенной операции сравнения.

Имя Тип Описание Обязательно По умолчанию
ключ струна Ключ для сопоставления со значением. Да
тип перечисление Указывает оператор сравнения: eq, ne, gt, gte, lt. lte
- eq: Равно
- ne: не равно
- gt: больше чем
- gte: больше или равно
- lt:Менее
- lte: меньше или равно

Возможные значения: eq, ne, gt, gte, lt, lte
Да
ценность строка или число или логическое значение Значение для сравнения с ключом атрибута; поддерживает типы строк, чисел или логических типов. Да

Составной фильтр

Объединение нескольких фильтров с помощью and или or.

Имя Тип Описание Обязательно По умолчанию
фильтры массив Массив фильтров для объединения. Элементы могут быть ComparisonFilter или CompoundFilter. Да
тип перечисление Тип операции: and или or.
Возможные значения: and, or
Да

ComputerAction

Этот компонент может быть одним из следующих компонентов:

ИзображениеЭкранаКомпьютера

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

Имя Тип Описание Обязательно По умолчанию
идентификатор_файла струна Идентификатор отправленного файла, содержащего снимок экрана. нет
ссылка_на_изображение струна URL-адрес изображения снимка экрана. нет
тип перечисление Указывает тип события. Для снимка экрана компьютера это свойство всегда имеет значение computer_screenshot.

Возможные значения: computer_screenshot
Да

ComputerTool

Средство управления виртуальным компьютером.

Имя Тип Описание Обязательно По умолчанию
высота дисплея число/номер Высота дисплея компьютера.
Да
ширина дисплея число/номер Ширина дисплея компьютера.
Да
окружающая среда перечисление Тип управляемой компьютерной среды.

Возможные значения: mac, , windowsubuntubrowser
Да
тип перечисление Тип средства использования компьютера. Всегда computer_use_preview.

Возможные значения: computer-use-preview
Да

ComputerToolCall

Вызов инструмента для работы с компьютером.

Имя Тип Описание Обязательно По умолчанию
действие ComputerAction Да
идентификатор вызова струна Идентификатор, используемый при реагировании на вызов инструмента с выходными данными.
Да
идентификатор струна Уникальный идентификатор вызова компьютера. Да
ожидающие проверки безопасности массив Ожидающие проверки безопасности для компьютеризированного процесса.
Да
статус перечисление Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.

Возможные значения: in_progress, completedincomplete
Да
тип перечисление Тип компьютерного вызова. Всегда computer_call.
Возможные значения: computer_call
Да

ComputerToolCallOutput

Выходные данные запуска компьютерного инструмента.

Имя Тип Описание Обязательно По умолчанию
принятые_меры_безопасности массив API сообщила о проверках безопасности, которые были подтверждены разработчиком.
нет
идентификатор вызова струна Идентификатор вызова средства компьютера, создающего выходные данные.
Да
идентификатор струна Идентификатор данных, полученных в результате вызова компьютерного инструмента.
нет
результат ComputerScreenshotImage Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера.
Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completed, или incomplete. Заполняется при возврате входных элементов через API.

Возможные значения: in_progress, completedincomplete
нет
тип перечисление Тип выходных данных компьютерного средства вызова. Всегда computer_call_output.

Возможные значения: computer_call_output
Да

КомпьютерныйИнструментВызоваВыходныхРесурсов

Имя Тип Описание Обязательно По умолчанию
принятые_меры_безопасности массив API сообщила о проверках безопасности, которые были подтверждены разработчиком.
нет
идентификатор вызова струна Идентификатор вызова средства компьютера, создающего выходные данные.
Да
идентификатор струна Уникальный идентификатор выходных данных средства вызова компьютера.
Да
результат ComputerScreenshotImage Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера.
Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completed, или incomplete. Заполняется при возврате входных элементов через API.

Возможные значения: in_progress, completedincomplete
нет
тип перечисление Тип выходных данных компьютерного средства вызова. Всегда computer_call_output.

Возможные значения: computer_call_output
Да

ПроверкаБезопасностиВызоваКомпьютерногоИнструмента

Ожидается проверка безопасности для компьютерного вызова.

Имя Тип Описание Обязательно По умолчанию
код струна Тип ожидающей проверки безопасности. Да
идентификатор струна Идентификатор ожидающей проверки безопасности. Да
сообщение струна Сведения об этой ожидающейся проверке безопасности. Да

Содержимое

Много модальное содержимое входных и выходных данных.

Этот компонент может быть одним из следующих компонентов:

Координата

Пара координат x/y, например { x: 100, y: 200 }.

Имя Тип Описание Обязательно По умолчанию
x целое число Координата x.
Да
и целое число Координата y.
Да

CreateModelResponseProperties

Имя Тип Описание Обязательно По умолчанию
метаданные Метаданные Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет
модель струна Модель, используемая для создания ответов. нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
Как правило, мы рекомендуем изменить это или top_p не оба.
нет 1
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить это или temperature не оба.
нет 1
Пользователь струна Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. .
нет

createResponse

Имя Тип Описание Обязательно По умолчанию
включать массив {"$ref": "#/components/schemas/includable/description"} нет
ввод строка или массив Входные данные, такие как текст, изображения или файлы, в модель, используемые для генерации ответа. Да
инструкции струна Вставляет сообщение системы (или разработчика) в качестве первого элемента в контексте модели.

При использовании вместе с previous_response_idэтим инструкции из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах.
нет
максимальное_число_токенов целое число Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин.
нет
вызовы инструмента в параллельном режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно.
нет Верно
предыдущий_идентификатор_ответа струна Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. нет
рассуждение Рассуждение Только модели o-серии

Параметры конфигурации для моделей рассуждений.
нет
магазин булевый Следует ли хранить созданный ответ модели для последующего получения через API.
нет Верно
поток булевый Если задано значение true, данные ответа модели будут передаваться клиенту по мере его создания с помощью событий, отправляемых сервером. нет Неправда
текст объект Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. Подробнее:
— текстовые входные и выходные данные
— структурированные выходные данные
нет
└─ Формат TextResponseFormatConfiguration Объект, указывающий формат, который должен выводить модель.

Настройка { "type": "json_schema" } включает структурированные выходные данные, что гарантирует, что модель будет соответствовать предоставленной схеме JSON. Формат по умолчанию — это { "type": "text" } без дополнительных параметров.

Не рекомендуется использовать для gpt-4o и более новых моделей:

Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его.
нет
выбор инструмента ToolChoiceOptions или ToolChoiceTypes или ToolChoiceFunction Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать.
нет
инструменты массив Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.

Ниже приведены две категории инструментов, которые можно предоставить модели:

- Встроенные средства
нет
усечение перечисление Стратегия усечения, которую следует использовать для генерирования ответа модели.
- auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет
ответ на соответствие окну контекста путем удаления входных элементов в середине беседы.
- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.

Возможные значения: auto, disabled
нет

DoubleClick

Действие двойного щелчка.

Имя Тип Описание Обязательно По умолчанию
тип перечисление Указывает тип события. Для действия двойного щелчка это свойство всегда имеет значение double_click.

Возможные значения: double_click
Да
x целое число Координата x, в которой произошло двойное щелчко.
Да
и целое число Координата y, в которой произошло двойное щелчко.
Да

Перетаскивание

Действие перетаскивания.

Имя Тип Описание Обязательно По умолчанию
путь массив Массив координат, представляющий путь действия перетаскивания. Координаты будут отображаться в виде массива объектов, например[{ x: 100, y: 200 }, { x: 200, y: 300 }] Да
тип перечисление Указывает тип события. Для действия перетаскивания это свойство всегда имеет значение drag.

Возможные значения: drag
Да

ПростоеСообщениеВвода

Входное сообщение модели с ролью, указывающей на следование иерархии инструкций. Инструкции с ролью developer или system имеют приоритет над инструкциями с ролью user. Предполагается, что сообщения с assistant ролью были созданы моделью в предыдущих взаимодействиях.

Имя Тип Описание Обязательно По умолчанию
содержимое string или InputMessageContentList Текст, изображение или звуковой вход в модель, используемый для создания ответа.
Также может содержать предыдущие ответы помощника.
Да
роль перечисление Роль входных данных сообщения. Один из user, assistantsystemили developer.

Возможные значения: user, , assistantsystemdeveloper
Да
тип перечисление Тип входных данных сообщения. Всегда message.

Возможные значения: message
нет

СсылкаНаФайл

Ссылка на файл.

Имя Тип Описание Обязательно По умолчанию
идентификатор_файла струна Идентификатор файла.
Да
индекс целое число Индекс файла в списке файлов.
Да
тип перечисление Тип ссылки на файл. Всегда file_citation.

Возможные значения: file_citation
Да

FilePath

Путь к файлу.

Имя Тип Описание Обязательно По умолчанию
идентификатор_файла струна Идентификатор файла.
Да
индекс целое число Индекс файла в списке файлов.
Да
тип перечисление Тип пути к файлу. Всегда file_path.

Возможные значения: file_path
Да

FileSearchRanker

Рангер, используемый для поиска файлов. Если не указано иное, будет использоваться ранжировщик auto.

Недвижимость Ценность
Описание Рангер, используемый для поиска файлов. Если не указано иное, будет использоваться ранжировщик auto.
Тип струна
Значения auto
default_2024_08_21

Инструмент Поиска Файлов (FileSearchTool)

Средство, которое ищет соответствующее содержимое из отправленных файлов.

Имя Тип Описание Обязательно По умолчанию
фильтры ComparisonFilter или CompoundFilter Фильтр для применения на основе атрибутов файла. нет
максимальное_количество_результатов целое число Максимальное количество отображаемых результатов. Это число должно быть от 1 до 50 включительно.
нет
опции рейтинга объект Параметры ранжирования для поиска. нет
Рангер └️ перечисление Рангер, используемый для поиска файлов.
Возможные значения: auto, default-2024-11-15
нет
└─ порог оценки число/номер Пороговое значение оценки для поиска файлов — от 0 до 1.
Числа ближе к 1 будут пытаться вернуть только наиболее релевантные результаты, но могут возвращать меньше результатов.
нет 0
тип перечисление Тип средства поиска файлов. Всегда file_search.

Возможные значения: file_search
Да
vector_store_ids массив Идентификаторы векторных хранилищ для поиска.
Да

Вызов инструмента поиска файлов

Результаты вызова средства поиска файлов.

Имя Тип Описание Обязательно По умолчанию
идентификатор струна Уникальный идентификатор вызова средства поиска файлов.
Да
запросы массив Запросы, используемые для поиска файлов.
Да
Результаты массив Результаты вызова средства поиска файлов.
нет
статус перечисление Состояние вызова средства поиска файлов. Один из in_progress, searchingincomplete или failed,

Возможные значения: in_progress, searching, completed, incomplete, failed
Да
тип перечисление Тип вызова средства поиска файлов. Всегда file_search_call.

Возможные значения: file_search_call
Да

FunctionTool

Определяет функцию в собственном коде, которую модель может вызвать.

Имя Тип Описание Обязательно По умолчанию
описание струна Описание функции. Используется моделью для определения того, следует ли вызывать функцию.
нет
имя струна Имя вызываемой функции.
Да
Параметры объект Объект схемы JSON, описывающий параметры функции.
Да
строгий булевый Следует ли применять строгую проверку параметров. trueпо умолчанию.
Да
тип перечисление Тип средства функции. Всегда function.

Возможные значения: function
Да

FunctionToolCall

Вызов средства для запуска функции.

Имя Тип Описание Обязательно По умолчанию
аргументы струна Строка JSON аргументов для передачи функции.
Да
идентификатор вызова струна Уникальный идентификатор вызова функции, созданного моделью.
Да
идентификатор струна Уникальный идентификатор вызова средства функции.
Да
имя струна Имя выполняемой функции.
Да
статус перечисление Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.

Возможные значения: in_progress, completedincomplete
нет
тип перечисление Тип вызова инструмента функции. Всегда function_call.

Возможные значения: function_call
Да

FunctionToolCallOutput

Выходные данные вызова инструмента функции.

Имя Тип Описание Обязательно По умолчанию
идентификатор вызова струна Уникальный идентификатор вызова функции, созданного моделью.
Да
идентификатор струна Уникальный идентификатор выходных данных вызова средства функции. Заполняется, когда этот элемент возвращается через API.
нет
результат струна Строка JSON данных, полученных в результате вызова инструмента функции.
Да
статус перечисление Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.

Возможные значения: in_progress, completedincomplete
нет
тип перечисление Тип выходных данных вызова функции. Всегда function_call_output.

Возможные значения: function_call_output
Да

FunctionToolCallOutputResource

Имя Тип Описание Обязательно По умолчанию
идентификатор вызова струна Уникальный идентификатор вызова функции, созданного моделью.
Да
идентификатор струна Уникальный идентификатор результата инструмента вызова функции.
Да
результат струна Строка JSON данных, полученных в результате вызова инструмента функции.
Да
статус перечисление Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.

Возможные значения: in_progress, completedincomplete
нет
тип перечисление Тип выходных данных вызова функции. Всегда function_call_output.

Возможные значения: function_call_output
Да

включаемый

Укажите дополнительные выходные данные для включения в ответ модели. В настоящее время поддерживаются следующие значения:

  • file_search_call.results: включите результаты поиска запроса средства поиска файлов.
  • message.input_image.image_url: включите URL-адреса изображения из входного сообщения.
  • computer_call_output.output.image_url: добавьте URL-адреса изображения из результата выполнения команды на компьютере.
Недвижимость Ценность
Описание Укажите дополнительные выходные данные для включения в ответ модели. В настоящее время поддерживаются следующие значения:
- file_search_call.results: включите результаты поиска вызова средства поиска файлов.
- message.input_image.image_url: включите URL-адреса изображения из входного сообщения.
- computer_call_output.output.image_url: добавьте URL-адреса изображений из выходных данных компьютерного вызова.
Тип струна
Значения file_search_call.results
message.input_image.image_url
computer_call_output.output.image_url

Входное аудио

Аудиовход для модели.

Имя Тип Описание Обязательно По умолчанию
данные струна Звуковые данные в кодировке Base64.
Да
формат перечисление Формат звуковых данных. В настоящее время поддерживаются mp3 форматы и wav.

Возможные значения: mp3, wav
Да
тип перечисление Тип входного элемента. Всегда input_audio.

Возможные значения: input_audio
Да

Входное содержимое

Этот компонент может быть одним из следующих компонентов:

Входной файл

Файл в качестве входных данных для модели.

Имя Тип Описание Обязательно По умолчанию
данные_файла струна Содержимое файла, отправляемого в модель.
нет
идентификатор_файла струна Идентификатор файла, отправляемого в модель.
нет
имя файла струна Имя файла, отправляемого в модель.
нет
тип перечисление Тип входного элемента. Всегда input_file.

Возможные значения: input_file
Да

Входное изображение

Изображение в качестве входных данных для модели.

Имя Тип Описание Обязательно По умолчанию
подробность перечисление Уровень детализации изображения, отправляемого в модель. Один из high, low, или auto. По умолчанию — auto.

Возможные значения: high, lowauto
Да
идентификатор_файла струна Идентификатор файла, отправляемого в модель.
нет
ссылка_на_изображение струна URL-адрес изображения, отправляемого в модель. Полностью квалифицированный URL-адрес или изображение, закодированное в формате Base64 в URL-адресе данных.
нет
тип перечисление Тип входного элемента. Всегда input_image.

Возможные значения: input_image
Да

Элемент ввода

Этот компонент может быть одним из следующих компонентов:

ВходящееСообщение

Входное сообщение модели с ролью, указывающей на следование иерархии инструкций. Инструкции с ролью developer или system имеют приоритет над инструкциями с ролью user.

Имя Тип Описание Обязательно По умолчанию
содержимое InputMessageContentList Список одного или нескольких входных элементов модели, содержащий другое содержимое.
Типы.
Да
роль перечисление Роль входных данных сообщения. Один из user, system, или developer.

Возможные значения: user, systemdeveloper
Да
статус перечисление Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.

Возможные значения: in_progress, completedincomplete
нет
тип перечисление Тип входных данных сообщения. Всегда задано значение message.

Возможные значения: message
нет

СписокКонтентаВходящегоСообщения

Список одного или нескольких входных элементов модели, содержащий различные типы контента.

Для этого компонента не определены свойства.

РесурсСообщенияВвода

Имя Тип Описание Обязательно По умолчанию
содержимое InputMessageContentList Список одного или нескольких входных элементов модели, содержащий другое содержимое.
Типы.
Да
идентификатор струна Уникальный идентификатор входных данных сообщения.
Да
роль перечисление Роль входных данных сообщения. Один из user, system, или developer.

Возможные значения: user, systemdeveloper
Да
статус перечисление Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.

Возможные значения: in_progress, completedincomplete
нет
тип перечисление Тип входных данных сообщения. Всегда задано значение message.

Возможные значения: message
нет

Входной текст

Текстовые входные данные модели.

Имя Тип Описание Обязательно По умолчанию
текст струна Текстовые входные данные модели.
Да
тип перечисление Тип входного элемента. Всегда input_text.

Возможные значения: input_text
Да

Товар

Элемент содержимого, используемый для создания ответа.

Этот компонент может быть одним из следующих компонентов:

Ссылка на элемент

Внутренний идентификатор для ссылки на элемент.

Имя Тип Описание Обязательно По умолчанию
идентификатор струна Идентификатор элемента для ссылки.
Да
тип перечисление Тип элемента для ссылки. Всегда item_reference.

Возможные значения: item_reference
Да

РесурсПредмета

Элемент содержимого, используемый для создания ответа.

Этот компонент может быть одним из следующих компонентов:

KeyPress

Коллекция нажатий клавиш, которые модель хотела бы выполнить.

Имя Тип Описание Обязательно По умолчанию
ключи массив Сочетание клавиш, которые модель просит нажать. Это массив строк, каждый из которых представляет ключ.
Да
тип перечисление Указывает тип события. Для действия keypress это свойство всегда имеет значение keypress.

Возможные значения: keypress
Да

Метаданные

Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.

Для этого компонента не определены свойства.

Свойства ответа модели

Имя Тип Описание Обязательно По умолчанию
метаданные Метаданные Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
нет
модель струна Модель, используемая для создания ответов. нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
Как правило, мы рекомендуем изменить это или top_p не оба.
нет 1
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить это или temperature не оба.
нет 1
Пользователь струна Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. .
нет

Двигаться

Операция перемещения мыши.

Имя Тип Описание Обязательно По умолчанию
тип перечисление Указывает тип события. Для действия перемещения это свойство всегда имеет значение move.

Возможные значения: move
Да
x целое число Координата x, к которой происходит движение.
Да
и целое число Координата y, куда необходимо переместиться.
Да

Выходное аудио

Выходные данные звука из модели.

Имя Тип Описание Обязательно По умолчанию
данные струна Звуковые данные в кодировке Base64 из модели.
Да
расшифровка струна Расшифровка звуковых данных из модели.
Да
тип перечисление Тип выходного звука. Всегда output_audio.

Возможные значения: output_audio
Да

ВыходноеСодержимое

Этот компонент может быть одним из следующих компонентов:

Выходной элемент

Имя Тип Описание Обязательно По умолчанию
действие ComputerAction Да
аргументы струна Строка JSON аргументов для передачи функции.
Да
идентификатор вызова струна Идентификатор, используемый при реагировании на вызов инструмента с выходными данными.
Да
содержимое массив Обоснование содержимого текста.
Да
идентификатор струна Уникальный идентификатор контента рассуждений.
Да
имя струна Имя выполняемой функции.
Да
ожидающие проверки безопасности массив Ожидающие проверки безопасности для компьютеризированного процесса.
Да
запросы массив Запросы, используемые для поиска файлов.
Да
Результаты массив Результаты вызова средства поиска файлов.
нет
роль перечисление Роль выходного сообщения. Всегда assistant.

Возможные значения: assistant
Да
статус перечисление Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.

Возможные значения: in_progress, completedincomplete
Да
тип перечисление Тип объекта . Всегда reasoning.

Возможные значения: reasoning
Да

ВыходноеСообщение

Выходное сообщение из модели.

Имя Тип Описание Обязательно По умолчанию
содержимое массив Содержимое выходного сообщения.
Да
идентификатор струна Уникальный идентификатор выходного сообщения.
Да
роль перечисление Роль выходного сообщения. Всегда assistant.

Возможные значения: assistant
Да
статус перечисление Состояние входных данных сообщения. Один из in_progress, completed, или incomplete. Заполняется при возврате входных элементов через API.

Возможные значения: in_progress, completedincomplete
Да
тип перечисление Тип выходного сообщения. Всегда message.

Возможные значения: message
Да

Выходной текст

Текстовые выходные данные модели.

Имя Тип Описание Обязательно По умолчанию
аннотации массив Заметки к выходным данным текста.
Да
текст струна Текстовые выходные данные модели.
Да
тип перечисление Тип выходного текста. Всегда output_text.

Возможные значения: output_text
Да

Запрос на создание сеанса в реальном времени

Конфигурация объекта сеанса в режиме реального времени.

Имя Тип Описание Обязательно По умолчанию
формат_входного_аудио перечисление Формат входного звука. Параметры: pcm16, g711_ulawили g711_alaw.
Для pcm16 входной звук должен быть 16-разрядным PCM с частотой выборки 24 кГц, одним каналом (моно) и младшим порядком байтов.

Возможные значения: pcm16, g711_ulawg711_alaw
нет
подавление шума входного аудиосигнала объект Настройка для уменьшения шума входного звука. Чтобы отключить, это можно установить на null.
Фильтры для уменьшения шума обрабатывают звук, добавленный во входной звуковой буфер перед отправкой в VAD и модель.
Фильтрация звука может повысить точность обнаружения VAD и поворота (уменьшая ложные срабатывания) и производительность модели, повышая восприятие входного звука.
нет
└─ Тип перечисление Тип уменьшения шума. near_field предназначен для микрофонов близкого разговора, таких как наушники, far_field предназначен для микрофонов с дальним полем, таких как ноутбук или микрофоны конференц-зала.

Возможные значения: near_field, far_field
нет
ввод стенограммы аудио объект Настройка транскрибирования входного аудио, по умолчанию отключена и может быть установлена на null, чтобы отключить аудиотранскрибирование после включения. Транскрибирование входного звука не является собственным для модели, так как модель использует звук напрямую. Транскрибирование выполняется асинхронно через конечную точку транскрибирования и должно рассматриваться как руководство по входным звуковым содержимым, а не точно то, что слышала модель. Клиент может при необходимости задать язык и запрашивать транскрибирование, они предлагают дополнительные рекомендации для службы транскрибирования.
нет
└─ язык струна Язык входного звука. Предоставление языка ввода в формате ISO-639-1 (например en, ) повышает точность и задержку.
нет
└─ Модель струна Модель, используемая для транскрибирования, текущие параметры: gpt-4o-transcribeи gpt-4o-mini-transcribewhisper-1.
нет
└─ Запрос струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука.
Для whisper-1этого запрос — это список ключевых слов.
Для gpt-4o-transcribe моделей запрос — это произвольная текстовая строка (например, "ожидайте слова, связанные с технологией").
нет
инструкции струна Системные инструкции по умолчанию (т. е. системное сообщение) предопределены для вызовов модели. Это поле позволяет клиенту управлять моделью по нужным ответам. Модель может быть настроена по формату и содержанию ответа (например, "быть чрезвычайно кратким", "вести себя дружелюбно", "вот примеры хороших ответов") и на звуковое поведение (например, "говорить быстро", "вносить в голос эмоции", "смеяться часто"). Нет гарантии, что модель будет следовать инструкциям, но они служат для нее руководством по желаемому поведению.

Обратите внимание, что сервер задает инструкции по умолчанию, которые будут использоваться, если это поле не задано, и которые видны в событии session.created в начале сеанса.
нет
максимальное_количество_токенов_вывода_ответа целое число или строка Максимальное количество выходных маркеров для одного ответа помощника, включающее вызовы инструментов. Укажите целое число от 1 до 4096, чтобы ограничить выходные маркеры или inf максимальные доступные маркеры для данной модели. По умолчанию — inf.
нет
Условия Набор модальностей, с которыми может реагировать модель. Чтобы отключить звук, установите для этого значение ["text"].
нет
модель струна Имя развертывания, используемого для этого сеанса.
нет
формат_выходного_аудио перечисление Формат выходного звука. Параметры: pcm16, g711_ulawили g711_alaw.
Для pcm16 выходного аудио частота дискретизации составляет 24 кГц.

Возможные значения: pcm16, g711_ulawg711_alaw
нет
Температура число/номер Температура выборки для модели ограничена [0.6, 1.2]. Для звуковых моделей температура 0,8 настоятельно рекомендуется для оптимальной производительности.
нет 0,8
выбор инструмента струна Как модель выбирает инструменты. Параметры: auto, nonerequiredили укажите функцию.
нет авто
инструменты массив Средства (функции), доступные для модели. нет
обнаружение поворотов объект Конфигурация для обнаружения поворота, VAD или семантического VAD сервера эфира. Это можно установить в null для отключения, в этом случае клиент должен вручную активировать реакцию модели.
VAD на сервере означает, что модель будет обнаруживать начало и конец речи на основе громкости звука и отвечать в конце речи пользователя.
Семантическая VAD более совершенная и использует модель обнаружения смены реплик (в сочетании с VAD), чтобы семантически оценить, закончил ли пользователь говорить, а затем динамически устанавливает тайм-аут на основе этой вероятности. Например, если пользователь отключает аудиозапись, uhhmмодель будет оценить низкую вероятность завершения и ждать больше времени, пока пользователь продолжит говорить. Это может быть полезно для более естественных бесед, но может иметь более высокую задержку.
нет
└─create_response булевый Следует ли автоматически создавать ответ при возникновении события остановки VAD.
нет Верно
└─ рвение перечисление Только для режима semantic_vad используется. Стремление модели реагировать. low будет ждать, пока пользователь продолжит говорить, high будет реагировать быстрее. auto значение по умолчанию и эквивалентно medium.

Возможные значения: low, , mediumhighauto
нет
└interrupt_response булевый Следует ли автоматически прерывать любой текущий ответ с выходными данными беседы по умолчанию (т. е. conversationautoпри возникновении события запуска VAD).
нет Верно
└prefix_padding_ms целое число Только для режима server_vad используется. Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). Значение по умолчанию — 300 мс.
нет
└️ silence_duration_ms целое число Только для режима server_vad используется. Длительность молчания для обнаружения остановки речи (в миллисекундах). Значение по умолчанию — 500 мс. С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя.
нет
Пороговое значение └️ число/номер Только для режима server_vad используется. Порог активации для VAD (0.0 до 1.0), по умолчанию используется значение 0.5. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах.
нет
└─ Тип перечисление Тип обнаружения поворота.

Возможные значения: server_vad, semantic_vad
нет
голос VoiceIdsShared нет

RealtimeSessionCreateResponse

Новая конфигурация сеанса Realtime с временным ключом. Срок жизни по умолчанию для ключей составляет одну минуту.

Имя Тип Описание Обязательно По умолчанию
секрет_клиента объект Временный ключ, возвращаемый API. Да
└ истекает_в целое число Метка времени окончания срока действия токена. В настоящее время срок действия всех токенов истекает через одну минуту.
нет
└─ значение струна Временный ключ, доступный в клиентских средах для проверки подлинности подключений к API Realtime. Используйте это в клиентских средах, а не стандартный маркер API, который следует использовать только на стороне сервера.
нет
формат_входного_аудио струна Формат входного звука. Параметры: pcm16, g711_ulawили g711_alaw.
нет
ввод стенограммы аудио объект Настройка транскрибирования входного аудио, по умолчанию отключена и может быть установлена на null, чтобы отключить аудиотранскрибирование после включения. Транскрибирование входного звука не является собственным для модели, так как модель использует звук напрямую. Транскрибирование выполняется асинхронно через Whisper и должно рассматриваться как грубое руководство, а не представление, понятное моделью.
нет
└─ Модель струна Модель, используемая для транскрибирования, whisper-1 является единственной поддерживаемой в настоящее время моделью.
нет
инструкции струна Системные инструкции по умолчанию (т. е. системное сообщение) предопределены для вызовов модели. Это поле позволяет клиенту управлять моделью по нужным ответам. Модель можно настроить по содержанию и формату ответов (например, "быть чрезвычайно кратким", "вести себя дружелюбно", "вот примеры хороших ответов"), а также по поведению в аудио (например, "говорить быстро", "вводить эмоции в свой голос", "часто смеяться"). Нет гарантии, что модель будет следовать инструкциям, но они служат для нее руководством по желаемому поведению.
Обратите внимание, что сервер задает инструкции по умолчанию, которые будут использоваться, если это поле не задано, и которые видны в событии session.created в начале сеанса.
нет
максимальное_количество_токенов_вывода_ответа целое число или строка Максимальное количество выходных маркеров для одного ответа помощника, включающее вызовы инструментов. Укажите целое число от 1 до 4096, чтобы ограничить выходные маркеры или inf максимальные доступные маркеры для данной модели. По умолчанию — inf.
нет
Условия Набор модальностей, с которыми может реагировать модель. Чтобы отключить звук, установите для этого значение ["text"].
нет
формат_выходного_аудио струна Формат выходного звука. Параметры: pcm16, g711_ulawили g711_alaw.
нет
Температура число/номер Температура выборки для модели ограничена [0.6, 1.2]. По умолчанию используется значение 0.8.
нет
выбор инструмента струна Как модель выбирает инструменты. Параметры: auto, nonerequiredили укажите функцию.
нет
инструменты массив Средства (функции), доступные для модели. нет
обнаружение поворотов объект Конфигурация для обнаружения поворотов. Можно установить значение null, чтобы отключить. VAD на сервере означает, что модель будет обнаруживать начало и конец речи на основе громкости звука и отвечать в конце речи пользователя.
нет
└prefix_padding_ms целое число Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). Значение по умолчанию — 300 мс.
нет
└️ silence_duration_ms целое число Длительность молчания для обнаружения остановки речи (в миллисекундах). Значение по умолчанию — 500 мс. С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя.
нет
Пороговое значение └️ число/номер Порог активации для VAD (0.0 до 1.0), по умолчанию используется значение 0.5. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах.
нет
└─ Тип струна В настоящий момент поддерживается только тип обнаружения поворота server_vad.
нет
голос VoiceIdsShared нет

ЗапросНаСозданиеСеансаТранскрипцииВРеальномВремени

Конфигурация объекта сеанса транскрибирования в реальном времени.

Имя Тип Описание Обязательно По умолчанию
включать массив Набор элементов для включения в транскрибирование. Текущие доступные элементы:
- item.input_audio_transcription.logprobs
нет
формат_входного_аудио перечисление Формат входного звука. Параметры: pcm16, g711_ulawили g711_alaw.
Для pcm16 входной звук должен быть 16-разрядным PCM с частотой выборки 24 кГц, одним каналом (моно) и младшим порядком байтов.

Возможные значения: pcm16, g711_ulawg711_alaw
нет
подавление шума входного аудиосигнала объект Настройка для уменьшения шума входного звука. Чтобы отключить, это можно установить на null.
Фильтры для уменьшения шума обрабатывают звук, добавленный во входной звуковой буфер перед отправкой в VAD и модель.
Фильтрация звука может повысить точность обнаружения VAD и поворота (уменьшая ложные срабатывания) и производительность модели, повышая восприятие входного звука.
нет
└─ Тип перечисление Тип уменьшения шума. near_field предназначен для микрофонов близкого разговора, таких как наушники, far_field предназначен для микрофонов с дальним полем, таких как ноутбук или микрофоны конференц-зала.

Возможные значения: near_field, far_field
нет
ввод стенограммы аудио объект Конфигурация входного транскрибирования звука. Клиент может при необходимости задать язык и запрашивать транскрибирование, они предлагают дополнительные рекомендации для службы транскрибирования.
нет
└─ язык струна Язык входного звука. Предоставление языка ввода в формате ISO-639-1 (например en, ) повышает точность и задержку.
нет
└─ Модель перечисление Модель, используемая для транскрибирования, текущие параметры: gpt-4o-transcribeи gpt-4o-mini-transcribewhisper-1.

Возможные значения: gpt-4o-transcribe, gpt-4o-mini-transcribewhisper-1
нет
└─ Запрос струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука.
Для whisper-1этого запрос — это список ключевых слов.
Для gpt-4o-transcribe моделей запрос — это произвольная текстовая строка (например, "ожидайте слова, связанные с технологией").
нет
Условия Набор модальностей, с которыми может реагировать модель. Чтобы отключить звук, установите для этого значение ["text"].
нет
обнаружение поворотов объект Конфигурация для обнаружения поворота, VAD или семантического VAD сервера эфира. Это можно установить в null для отключения, в этом случае клиент должен вручную активировать реакцию модели.
VAD на сервере означает, что модель будет обнаруживать начало и конец речи на основе громкости звука и отвечать в конце речи пользователя.
Семантическая VAD более совершенная и использует модель обнаружения смены реплик (в сочетании с VAD), чтобы семантически оценить, закончил ли пользователь говорить, а затем динамически устанавливает тайм-аут на основе этой вероятности. Например, если пользователь отключает аудиозапись, uhhmмодель будет оценить низкую вероятность завершения и ждать больше времени, пока пользователь продолжит говорить. Это может быть полезно для более естественных бесед, но может иметь более высокую задержку.
нет
└─create_response булевый Следует ли автоматически создавать ответ при возникновении события остановки VAD. Недоступно для сеансов транскрибирования.
нет Верно
└─ рвение перечисление Только для режима semantic_vad используется. Стремление модели реагировать. low будет ждать, пока пользователь продолжит говорить, high будет реагировать быстрее. auto значение по умолчанию и эквивалентно medium.

Возможные значения: low, , mediumhighauto
нет
└interrupt_response булевый Следует ли автоматически прерывать любой текущий ответ с выходными данными беседы по умолчанию (т. е. conversationautoпри возникновении события запуска VAD). Недоступно для сеансов транскрибирования.
нет Верно
└prefix_padding_ms целое число Только для режима server_vad используется. Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). Значение по умолчанию — 300 мс.
нет
└️ silence_duration_ms целое число Только для режима server_vad используется. Длительность молчания для обнаружения остановки речи (в миллисекундах). Значение по умолчанию — 500 мс. С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя.
нет
Пороговое значение └️ число/номер Только для режима server_vad используется. Порог активации для VAD (0.0 до 1.0), по умолчанию используется значение 0.5. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах.
нет
└─ Тип перечисление Тип обнаружения поворота.

Возможные значения: server_vad, semantic_vad
нет

RealtimeTranscriptionSessionCreateResponse

Новая конфигурация сеанса транскрибирования в реальном времени.

При создании сеанса на сервере с помощью REST API объект сеанса также содержит временный ключ. Срок жизни по умолчанию для ключей составляет одну минуту. Это свойство отсутствует при обновлении сеанса через API WebSocket.

Имя Тип Описание Обязательно По умолчанию
секрет_клиента объект Временный ключ, возвращаемый API. Присутствует только при создании сеанса на сервере с помощью REST API.
Да
└ истекает_в целое число Метка времени окончания срока действия токена. В настоящее время срок действия всех токенов истекает через одну минуту.
нет
└─ значение струна Временный ключ, доступный в клиентских средах для проверки подлинности подключений к API Realtime. Используйте это в клиентских средах, а не стандартный маркер API, который следует использовать только на стороне сервера.
нет
формат_входного_аудио струна Формат входного звука. Параметры: pcm16, g711_ulawили g711_alaw.
нет
ввод стенограммы аудио объект Настройка модели транскрибирования.
нет
└─ язык струна Язык входного звука. Предоставление языка ввода в формате ISO-639-1 (например en, ) повышает точность и задержку.
нет
└─ Модель перечисление Модель, используемая для транскрибирования. Возможные значения: gpt-4o-transcribe, gpt-4o-mini-transcribe или whisper-1.

Возможные значения: gpt-4o-transcribe, gpt-4o-mini-transcribewhisper-1
нет
└─ Запрос струна Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен соответствовать языку звука.
нет
Условия Набор модальностей, с которыми может реагировать модель. Чтобы отключить звук, установите для этого значение ["text"].
нет
обнаружение поворотов объект Конфигурация для обнаружения поворотов. Можно установить значение null, чтобы отключить. VAD на сервере означает, что модель будет обнаруживать начало и конец речи на основе громкости звука и отвечать в конце речи пользователя.
нет
└prefix_padding_ms целое число Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). Значение по умолчанию — 300 мс.
нет
└️ silence_duration_ms целое число Длительность молчания для обнаружения остановки речи (в миллисекундах). Значение по умолчанию — 500 мс. С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя.
нет
Пороговое значение └️ число/номер Порог активации для VAD (0.0 до 1.0), по умолчанию используется значение 0.5. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах.
нет
└─ Тип струна В настоящий момент поддерживается только тип обнаружения поворота server_vad.
нет

Рассуждение

Только модели o-серии

Параметры конфигурации для моделей рассуждений.

Имя Тип Описание Обязательно По умолчанию
усилие Усилия на размышления Только модели o-серии

Ограничивает усилия по рассуждениям моделей.
В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе.
Да Средний
сводка перечисление Только модели o-серии

Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели.
Один из concise или detailed.

Возможные значения: concise, detailed
нет

Элемент рассуждения

Описание цепочки мысли, используемой моделью причин при создании ответа.

Имя Тип Описание Обязательно По умолчанию
содержимое массив Обоснование содержимого текста.
Да
идентификатор струна Уникальный идентификатор контента рассуждений.
Да
статус перечисление Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.

Возможные значения: in_progress, completedincomplete
нет
тип перечисление Тип объекта . Всегда reasoning.

Возможные значения: reasoning
Да

Отказ

Отказ модели.

Имя Тип Описание Обязательно По умолчанию
отказ струна Объяснение отказа модели.
Да
тип перечисление Тип отказа. Всегда refusal.

Возможные значения: refusal
Да

ответ

Имя Тип Описание Обязательно По умолчанию
создано_в число/номер Метка времени в формате Unix (в секундах), когда был создан этот ответ.
Да
ошибка ResponseError Объект ошибки, возвращаемый, когда модель не сможет создать ответ.
Да
идентификатор струна Уникальный идентификатор для этого ответа.
Да
неполные_данные объект Сведения о том, почему ответ неполный.
Да
└─ Причина перечисление Причина, по которой ответ является неполным.
Возможные значения: max_output_tokens, content_filter
нет
инструкции струна Вставляет сообщение системы (или разработчика) в качестве первого элемента в контексте модели.

При использовании вместе с previous_response_idэтим инструкции из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах.
Да
максимальное_число_токенов целое число Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и состояние беседы.
нет
метаданные Метаданные Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга.

Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
Да
модель струна Модель, используемая для создания ответов. Да
объект перечисление Тип объекта этого ресурса — всегда установлено response.

Возможные значения: response
Да
результат массив Массив элементов контента, созданных моделью.

— длина и порядок элементов в массиве output зависит от ответа модели.
— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK.
Да
выходной_текст струна Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.
Поддерживается в пакетах SDK для Python и JavaScript.
нет
вызовы инструмента в параллельном режиме булевый Следует ли разрешить модели запускать вызовы инструментов параллельно.
Да Верно
предыдущий_идентификатор_ответа струна Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. нет
рассуждение Рассуждение Только модели o-серии

Параметры конфигурации для моделей рассуждений.
нет
статус перечисление Статус формирования ответа. Один из completed, failedin_progressили incomplete.

Возможные значения: completed, , failedin_progressincomplete
нет
Температура число/номер Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным.
Как правило, мы рекомендуем изменить это или top_p не оба.
Да 1
текст объект Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. Подробнее:
— текстовые входные и выходные данные
— структурированные выходные данные
нет
└─ Формат TextResponseFormatConfiguration Объект, указывающий формат, который должен выводить модель.

Настройка { "type": "json_schema" } включает структурированные выходные данные, что гарантирует, что модель будет соответствовать предоставленной схеме JSON. Формат по умолчанию — это { "type": "text" } без дополнительных параметров.

Не рекомендуется использовать для gpt-4o и более новых моделей:

Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его.
нет
выбор инструмента ToolChoiceOptions или ToolChoiceTypes или ToolChoiceFunction Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать.
Да
инструменты массив Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.

Ниже приведены две категории инструментов, которые можно предоставить модели:

- Встроенные средства
Да
top_p число/номер Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности.

Как правило, мы рекомендуем изменить это или temperature не оба.
Да 1
усечение перечисление Стратегия усечения, которую следует использовать для генерирования ответа модели.
- auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.
- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.

Возможные значения: auto, disabled
нет
использование ResponseUsage Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры.
нет
Пользователь струна Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. .
нет

ResponseAudioDeltaEvent

Выдается при наличии частичного аудиореспонса.

Имя Тип Описание Обязательно По умолчанию
дельта струна Блок аудиобайтов, закодированных в формате Base64.
Да
тип перечисление тип события; Всегда response.audio.delta.

Возможные значения: response.audio.delta
Да

СобытиеЗавершенияАудиоОтвета

Излучается при завершении аудиоответа.

Имя Тип Описание Обязательно По умолчанию
тип перечисление тип события; Всегда response.audio.done.

Возможные значения: response.audio.done
Да

ResponseAudioTranscriptDeltaEvent

Выдается при частичной расшифровке звука.

Имя Тип Описание Обязательно По умолчанию
дельта струна Частичная расшифровка аудиоответа.
Да
тип перечисление тип события; Всегда response.audio.transcript.delta.

Возможные значения: response.audio.transcript.delta
Да

СобытиеГотовностиТранскрипцииАудиоОтвета

Издается при завершении полной расшифровки аудио.

Имя Тип Описание Обязательно По умолчанию
тип перечисление тип события; Всегда response.audio.transcript.done.

Возможные значения: response.audio.transcript.done
Да

КодОтветаИнтерпретаторВызовКодДельтаСобытие

Создается при добавлении фрагмента частичного кода интерпретатором кода.

Имя Тип Описание Обязательно По умолчанию
дельта струна Фрагмент частичного кода, добавленный интерпретатором кода.
Да
выходной_индекс целое число Индекс выходного элемента, для которого вызов интерпретатора кода находится в процессе выполнения.
Да
тип перечисление тип события; Всегда response.code_interpreter_call.code.delta.

Возможные значения: response.code_interpreter_call.code.delta
Да

ИнтерпретаторКодовОтветовОбработалКодЗавершенияСобытия

Выдается при завершении результатов выполнения фрагмента кода интерпретатором кода.

Имя Тип Описание Обязательно По умолчанию
код струна Окончательный фрагмент кода выводится интерпретатором кода.
Да
выходной_индекс целое число Индекс выходного элемента, для которого вызов интерпретатора кода находится в процессе выполнения.
Да
тип перечисление тип события; Всегда response.code_interpreter_call.code.done.

Возможные значения: response.code_interpreter_call.code.done
Да

Событие завершения вызова интерпретатора кода отклика (ResponseCodeInterpreterCallCompletedEvent)

Эмитируется при завершении вызова интерпретатора кода.

Имя Тип Описание Обязательно По умолчанию
вызов_интерпретатора_кода CodeInterpreterToolCall Вызов инструмента для выполнения кода.
Да
выходной_индекс целое число Индекс выходного элемента, для которого вызов интерпретатора кода находится в процессе выполнения.
Да
тип перечисление тип события; Всегда response.code_interpreter_call.completed.

Возможные значения: response.code_interpreter_call.completed
Да

ResponseCodeInterpreterCallInProgressEvent

Срабатывает при выполнении вызова интерпретатора кода.

Имя Тип Описание Обязательно По умолчанию
вызов_интерпретатора_кода CodeInterpreterToolCall Вызов инструмента для выполнения кода.
Да
выходной_индекс целое число Индекс выходного элемента, для которого вызов интерпретатора кода находится в процессе выполнения.
Да
тип перечисление тип события; Всегда response.code_interpreter_call.in_progress.

Возможные значения: response.code_interpreter_call.in_progress
Да

ИнтерпретаторКодаОтвета_ЗвонокИнтерпретацииСобытия

Создается, когда интерпретатор кода активно интерпретирует фрагмент кода.

Имя Тип Описание Обязательно По умолчанию
вызов_интерпретатора_кода CodeInterpreterToolCall Вызов инструмента для выполнения кода.
Да
выходной_индекс целое число Индекс выходного элемента, для которого вызов интерпретатора кода находится в процессе выполнения.
Да
тип перечисление тип события; Всегда response.code_interpreter_call.interpreting.

Возможные значения: response.code_interpreter_call.interpreting
Да

СобытиеЗавершенияОтвета

Выдается при завершении ответа модели.

Имя Тип Описание Обязательно По умолчанию
ответ ответ Да
тип перечисление тип события; Всегда response.completed.

Возможные значения: response.completed
Да

СобытиеДобавленияЧастиСодержимогоОтвета

Вызывается при добавлении новой части содержимого.

Имя Тип Описание Обязательно По умолчанию
индекс_содержания целое число Индекс добавленной части содержимого.
Да
идентификатор_товара струна Идентификатор выходного элемента, к которому была добавлена часть содержимого.
Да
выходной_индекс целое число Индекс выходного элемента, к которому была добавлена часть содержимого.
Да
часть OutputContent Да
тип перечисление тип события; Всегда response.content_part.added.

Возможные значения: response.content_part.added
Да

СобытиеЗавершенияЧастиСодержимогоОтвета

Выдается при завершении части содержимого.

Имя Тип Описание Обязательно По умолчанию
индекс_содержания целое число Индекс завершенной части содержимого.
Да
идентификатор_товара струна Идентификатор выходного элемента, к которому была добавлена часть содержимого.
Да
выходной_индекс целое число Индекс выходного элемента, к которому была добавлена часть содержимого.
Да
часть OutputContent Да
тип перечисление тип события; Всегда response.content_part.done.

Возможные значения: response.content_part.done
Да

СобытиеСозданияОтвета

Событие, которое эмитируется при создании ответа.

Имя Тип Описание Обязательно По умолчанию
ответ ответ Да
тип перечисление тип события; Всегда response.created.

Возможные значения: response.created
Да

Ошибка ответа

Объект ошибки, возвращаемый, когда модель не сможет создать ответ.

Имя Тип Описание Обязательно По умолчанию
код ResponseErrorCode Код ошибки для ответа.
Да
сообщение струна Описание ошибки, доступной для чтения человеком.
Да

ResponseErrorCode

Код ошибки для ответа.

Недвижимость Ценность
Описание Код ошибки для ответа.
Тип струна
Значения server_error
rate_limit_exceeded
invalid_prompt
vector_store_timeout
invalid_image
invalid_image_format
invalid_base64_image
invalid_image_url
image_too_large
image_too_small
image_parse_error
image_content_policy_violation
invalid_image_mode
image_file_too_large
unsupported_image_media_type
empty_image_file
failed_to_download_image
image_file_not_found

ResponseErrorEvent

Эмитируется при возникновении ошибки.

Имя Тип Описание Обязательно По умолчанию
код струна Код ошибки.
Да
сообщение струна Сообщение об ошибке.
Да
параметр струна Параметр ошибки.
Да
тип перечисление тип события; Всегда error.

Возможные значения: error
Да

СобытиеНеудачногоОтклика

Событие, которое возникает при сбое ответа.

Имя Тип Описание Обязательно По умолчанию
ответ ответ Да
тип перечисление тип события; Всегда response.failed.

Возможные значения: response.failed
Да

СобытиеОкончанияВызоваПоискаФайлаОтвета

Создается при завершении вызова поиска файлов (найденные результаты).

Имя Тип Описание Обязательно По умолчанию
идентификатор_товара струна Идентификатор выходного элемента, инициируемого вызовом поиска файлов.
Да
выходной_индекс целое число Индекс выходного элемента, инициируемого вызовом поиска файлов.
Да
тип перечисление тип события; Всегда response.file_search_call.completed.

Возможные значения: response.file_search_call.completed
Да

ResponseFileSearchCallInProgressEvent

Срабатывает при инициализации вызова поиска файлов.

Имя Тип Описание Обязательно По умолчанию
идентификатор_товара струна Идентификатор выходного элемента, инициируемого вызовом поиска файлов.
Да
выходной_индекс целое число Индекс выходного элемента, инициируемого вызовом поиска файлов.
Да
тип перечисление тип события; Всегда response.file_search_call.in_progress.

Возможные значения: response.file_search_call.in_progress
Да

СобытиеПоискаФайлаОтветаВызовПоиск

Генерируется во время текущего поиска файла.

Имя Тип Описание Обязательно По умолчанию
идентификатор_товара струна Идентификатор выходного элемента, инициируемого вызовом поиска файлов.
Да
выходной_индекс целое число Индекс выходного элемента, вызываемого вызовом поиска файлов.
Да
тип перечисление тип события; Всегда response.file_search_call.searching.

Возможные значения: response.file_search_call.searching
Да

ResponseFunctionCallArgumentsDeltaEvent

Создается при наличии разностных аргументов вызова функции.

Имя Тип Описание Обязательно По умолчанию
дельта струна Добавлен аргумент вызова функции, представляющий дельту.
Да
идентификатор_товара струна Идентификатор выходного элемента, к которому добавляется дельта аргументов вызова функции.
Да
выходной_индекс целое число Индекс выходного элемента, к которому добавляется разность аргументов вызова функции.
Да
тип перечисление тип события; Всегда response.function_call_arguments.delta.

Возможные значения: response.function_call_arguments.delta
Да

СобытиеЗавершенияАргументовВызоваФункцииОтзыва

Вызывается, когда аргументы вызова функции завершены.

Имя Тип Описание Обязательно По умолчанию
аргументы струна Аргументы вызова функции. Да
идентификатор_товара струна Идентификатор элемента. Да
выходной_индекс целое число Индекс выходного элемента. Да
тип перечисление
Возможные значения: response.function_call_arguments.done
Да

ResponseInProgressEvent

Генерируется во время обработки ответа.

Имя Тип Описание Обязательно По умолчанию
ответ ответ Да
тип перечисление тип события; Всегда response.in_progress.

Возможные значения: response.in_progress
Да

СобытиеНеполногоОтвета

Событие, которое возникает, когда ответ завершается неполным.

Имя Тип Описание Обязательно По умолчанию
ответ ответ Да
тип перечисление тип события; Всегда response.incomplete.

Возможные значения: response.incomplete
Да

списокЭлементовОтвета

Список элементов ответа.

Имя Тип Описание Обязательно По умолчанию
данные массив Список элементов, используемых для создания этого ответа. Да
первый_идентификатор струна Идентификатор первого элемента в списке. Да
есть_еще булевый Доступны ли дополнительные элементы. Да
last_id струна Идентификатор последнего элемента в списке. Да
объект перечисление Тип возвращаемого объекта должен быть list.
Возможные значения: list
Да

Модальности Ответа

Типы выходных данных, которые вы хотите, чтобы модель генерировала. Большинство моделей могут создавать текст, который по умолчанию:

["text"]

Модель gpt-4o-audio-preview также может использоваться для создания звука. Чтобы запросить, что эта модель создает как текстовые, так и звуковые ответы, можно использовать:

["text", "audio"]

Для этого компонента не определены свойства.

ТолькоТекстовыеМодальностиОтвета

Типы выходных данных, которые вы хотите, чтобы модель генерировала. Большинство моделей могут создавать текст, который по умолчанию:

["text"]

Этот API скоро поддерживает другие выходные модальности, включая аудио и изображения.

Для этого компонента не определены свойства.

СобытиеДобавленияЭлементаОтвета

Создается при добавлении нового выходного элемента.

Имя Тип Описание Обязательно По умолчанию
элемент OutputItem Да
выходной_индекс целое число Индекс добавленного выходного элемента.
Да
тип перечисление тип события; Всегда response.output_item.added.

Возможные значения: response.output_item.added
Да

СобытиеОкончанияВыходногоЭлементаОтвета

Излучается, когда выходной элемент помечен как завершенный.

Имя Тип Описание Обязательно По умолчанию
элемент OutputItem Да
выходной_индекс целое число Индекс выходного элемента, помеченного как выполненный.
Да
тип перечисление тип события; Всегда response.output_item.done.

Возможные значения: response.output_item.done
Да

СвойстваОтвета

Имя Тип Описание Обязательно По умолчанию
инструкции струна Вставляет сообщение системы (или разработчика) в качестве первого элемента в контексте модели.

При использовании вместе с previous_response_idэтим инструкции из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах.
нет
максимальное_число_токенов целое число Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и состояние беседы.
нет
предыдущий_идентификатор_ответа струна Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. нет
рассуждение Рассуждение Только модели o-серии

Параметры конфигурации для моделей рассуждений.
нет
текст объект Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. Подробнее:
— текстовые входные и выходные данные
— структурированные выходные данные
нет
└─ Формат TextResponseFormatConfiguration Объект, указывающий формат, который должен выводить модель.

Настройка { "type": "json_schema" } включает структурированные выходные данные, что гарантирует, что модель будет соответствовать предоставленной схеме JSON. Формат по умолчанию — это { "type": "text" } без дополнительных параметров.

Не рекомендуется использовать для gpt-4o и более новых моделей:

Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его.
нет
выбор инструмента ToolChoiceOptions или ToolChoiceTypes или ToolChoiceFunction Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать.
нет
инструменты массив Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.

Ниже приведены две категории инструментов, которые можно предоставить модели:

- Встроенные средства
нет
усечение перечисление Стратегия усечения, которую следует использовать для генерирования ответа модели.
- auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.
- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.

Возможные значения: auto, disabled
нет

СобытиеИзмененияОтказа

Срабатывает при наличии частичного текста отказа.

Имя Тип Описание Обязательно По умолчанию
индекс_содержания целое число Индекс части содержимого, в которую добавляется текст отказа.
Да
дельта струна Добавлен текст отказа.
Да
идентификатор_товара струна Идентификатор выходного элемента, к которому добавляется текст отказа.
Да
выходной_индекс целое число Индекс выходного элемента, к которому добавляется текст отказа.
Да
тип перечисление тип события; Всегда response.refusal.delta.

Возможные значения: response.refusal.delta
Да

Событие завершения отказа в ответе

Воспроизводится, когда текст отказа окончательно сформирован.

Имя Тип Описание Обязательно По умолчанию
индекс_содержания целое число Индекс части содержимого, завершаемой текстом отказа.
Да
идентификатор_товара струна Идентификатор выходного элемента, имеющего окончательный текст отказа.
Да
выходной_индекс целое число Индекс выходного элемента, для которого текст отказа завершён.
Да
отказ струна Текст отказа, завершенный.
Да
тип перечисление тип события; Всегда response.refusal.done.

Возможные значения: response.refusal.done
Да

событие потока ответа

Имя Тип Описание Обязательно По умолчанию
аннотация Аннотация Да
индекс аннотации целое число Индекс добавленной заметки.
Да
аргументы струна Аргументы вызова функции. Да
код струна Код ошибки.
Да
вызов_интерпретатора_кода CodeInterpreterToolCall Вызов инструмента для выполнения кода.
Да
индекс_содержания целое число Индекс части содержимого, где завершается текстовое содержимое.
Да
дельта струна Добавлена разностная строка текста.
Да
элемент OutputItem Выходной элемент, помеченный как выполненный.
Да
идентификатор_товара струна Идентификатор выходного элемента, для которого завершается текстовое содержимое.
Да
сообщение струна Сообщение об ошибке.
Да
выходной_индекс целое число Индекс выходного элемента, в котором завершается текстовое содержимое.
Да
параметр струна Параметр ошибки.
Да
часть OutputContent Выполненная часть содержимого.
Да
отказ струна Текст отказа, завершенный.
Да
ответ ответ Неполный ответ.
Да
текст струна Текстовое содержимое, завершенное.
Да
тип перечисление тип события; Всегда response.output_text.done.

Возможные значения: response.output_text.done
Да

ResponseTextAnnotationDeltaEvent

Создается при добавлении текстовой заметки.

Имя Тип Описание Обязательно По умолчанию
аннотация Аннотация Да
индекс аннотации целое число Индекс добавленной заметки.
Да
индекс_содержания целое число Индекс части содержимого, в которую добавлена текстовая заметка.
Да
идентификатор_товара струна Идентификатор выходного элемента, к которому добавлена заметка текста.
Да
выходной_индекс целое число Индекс выходного элемента, в который добавлена текстовая аннотация.
Да
тип перечисление тип события; Всегда response.output_text.annotation.added.

Возможные значения: response.output_text.annotation.added
Да

ResponseTextDeltaEvent

Создается при наличии дополнительного разностного текста.

Имя Тип Описание Обязательно По умолчанию
индекс_содержания целое число Индекс части содержимого, в которую была добавлена текстовая дельта.
Да
дельта струна Добавлена разностная строка текста.
Да
идентификатор_товара струна Идентификатор выходного элемента, к которому была добавлена текстовая дельта.
Да
выходной_индекс целое число Индекс выходного элемента, к которому был добавлен разностный текст.
Да
тип перечисление тип события; Всегда response.output_text.delta.

Возможные значения: response.output_text.delta
Да

ОтветТекстГотовСобытие

Излучается при завершении работы с текстовым содержимым.

Имя Тип Описание Обязательно По умолчанию
индекс_содержания целое число Индекс части содержимого, где завершается текстовое содержимое.
Да
идентификатор_товара струна Идентификатор выходного элемента, для которого завершается текстовое содержимое.
Да
выходной_индекс целое число Индекс выходного элемента, в котором завершается текстовое содержимое.
Да
текст струна Текстовое содержимое, завершенное.
Да
тип перечисление тип события; Всегда response.output_text.done.

Возможные значения: response.output_text.done
Да

ИспользованиеОтвета

Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры.

Имя Тип Описание Обязательно По умолчанию
входные_токены целое число Количество входных токенов. Да
выходные токены целое число Количество выходных токенов. Да
детали_выходных_токенов объект Подробная разбивка выходных маркеров. Да
└️ reasoning_tokens целое число Количество токенов рассуждения. нет
общее количество токенов целое число Общее количество используемых токенов. Да

Снимок экрана

Действие с снимком экрана.

Имя Тип Описание Обязательно По умолчанию
тип перечисление Указывает тип события. Для действия с снимка экрана это свойство всегда имеет значение screenshot.

Возможные значения: screenshot
Да

Прокрутка

Действие прокрутки.

Имя Тип Описание Обязательно По умолчанию
скролл_x целое число Расстояние горизонтальной прокрутки.
Да
прокрутка_по_вертикали целое число Расстояние вертикальной прокрутки.
Да
тип перечисление Указывает тип события. Для действия прокрутки это свойство всегда имеет значение scroll.

Возможные значения: scroll
Да
x целое число Координата x, в которой произошла прокрутка.
Да
и целое число Координата y, в которой произошла прокрутка.
Да

СтопКонфигурация

До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры. Возвращенный текст не будет содержать последовательность остановки.

Этот компонент может быть одним из следующих компонентов:

КонфигурацияФорматаТекстовогоОтвета

Объект, указывающий формат, который должен выводить модель.

Настройка { "type": "json_schema" } включает структурированные выходные данные, которые гарантируют, что модель будет соответствовать предоставленной схеме JSON.

Формат по умолчанию — это { "type": "text" } без дополнительных параметров.

Не рекомендуется использовать для gpt-4o и более новых моделей:

Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его.

Этот компонент может быть одним из следующих компонентов:

Схема формата ответа в формате JSON (TextResponseFormatJsonSchema)

Формат ответа схемы JSON. Используется для создания структурированных ответов JSON. Дополнительные сведения о структурированных выходных данных.

Имя Тип Описание Обязательно По умолчанию
описание струна Описание формата ответа, которое используется моделью для определения того, как отвечать в этом формате.
нет
имя струна Имя формата ответа. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64.
нет
схема ResponseFormatJsonSchemaSchemaSchema Схема формата ответа, описанная как объект схемы JSON. Да
строгий булевый Следует ли включить строгое соблюдение схемы при создании выходных данных.
Если задано значение true, модель всегда будет соответствовать точной схеме, определенной schema в поле. Только подмножество схемы JSON поддерживается, если stricttrue.
нет Неправда
тип перечисление Тип определяемого формата ответа. Всегда json_schema.
Возможные значения: json_schema
Да

Инструмент

Этот компонент может быть одним из следующих компонентов:

Функция выбора инструмента

Используйте этот параметр, чтобы принудительно вызвать определенную функцию.

Имя Тип Описание Обязательно По умолчанию
имя струна Имя вызываемой функции. Да
тип перечисление Для вызова функции тип всегда function.
Возможные значения: function
Да

ПараметрыВыбораИнструмента

Определяет, какое средство (если таковое) вызывается моделью.

none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.

auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.

required означает, что модель должна вызывать один или несколько инструментов.

Недвижимость Ценность
Описание Определяет, какое средство (если таковое) вызывается моделью.

none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.

auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.

required означает, что модель должна вызывать один или несколько инструментов.
Тип струна
Значения none
auto
required

Типы Выбора Инструментов

Указывает, что модель должна использовать встроенное средство для создания ответа.

Имя Тип Описание Обязательно По умолчанию
тип перечисление Тип размещенного инструмента, который должна использовать модель. Допустимые значения:
- file_search
- computer_use_preview

Возможные значения: file_search, computer_use_preview
Да

Тип

Действие для ввода текста.

Имя Тип Описание Обязательно По умолчанию
текст струна Текст для набора.
Да
тип перечисление Указывает тип события. Для действия типа это свойство всегда имеет значение type.

Возможные значения: type
Да

Запрос на обновление атрибутов файла в хранилище векторов

Имя Тип Описание Обязательно По умолчанию
атрибуты VectorStoreFileAttributes Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами.
Да

Цитирование URL-адреса

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

Имя Тип Описание Обязательно По умолчанию
конечный индекс целое число Индекс последнего символа ссылки URL-адреса в сообщении.
Да
начальный_индекс целое число Индекс первого символа ссылки URL-адреса в сообщении.
Да
заголовок струна Заголовок веб-ресурса.
Да
тип перечисление Тип URL-ссылки. Всегда url_citation.

Возможные значения: url_citation
Да
URL-адрес струна URL-адрес веб-ресурса.
Да

VectorStoreFileAttributes

Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами.

Для этого компонента не определены свойства.

Ответ на запрос содержимого файла хранилища векторов

Представляет проанализированное содержимое файла векторного хранилища.

Имя Тип Описание Обязательно По умолчанию
данные массив Проанализированное содержимое файла. Да
есть_еще булевый Указывает, есть ли еще страницы содержимого для загрузки. Да
следующая_страница струна Маркер для следующей страницы, если таковой есть. Да
объект перечисление Тип объекта, который всегда является vector_store.file_content.page
Возможные значения: vector_store.file_content.page
Да

Запрос на поиск в VectorStore

Имя Тип Описание Обязательно По умолчанию
фильтры ComparisonFilter или CompoundFilter Фильтр для применения на основе атрибутов файла. нет
максимальное_количество_результатов целое число Максимальное количество отображаемых результатов. Это число должно быть от 1 до 50 включительно. нет 10
запрос строка или массив Строка запроса для поиска Да
опции рейтинга объект Параметры ранжирования для поиска. нет
Рангер └️ перечисление Возможные значения: auto, default-2024-11-15 нет
└─ порог оценки число/номер нет 0
переписать запрос булевый Следует ли переписать запрос естественного языка для векторного поиска. нет Неправда

VectorStoreSearchResultContentObject

Имя Тип Описание Обязательно По умолчанию
текст струна Текстовое содержимое, возвращенное из поиска. Да
тип перечисление Тип содержимого.
Возможные значения: text
Да

Элемент результата поиска в векторном хранилище

Имя Тип Описание Обязательно По умолчанию
атрибуты VectorStoreFileAttributes Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами.
Да
содержимое массив Фрагменты содержимого из файла. Да
идентификатор_файла струна Идентификатор файла векторного хранилища. Да
имя файла струна Имя файла векторного хранилища. Да
счёт число/номер Оценка сходства результата. Да

Страница результатов поиска в хранилище векторов

Имя Тип Описание Обязательно По умолчанию
данные массив Список элементов результатов поиска. Да
есть_еще булевый Указывает, есть ли дополнительные результаты для получения. Да
следующая_страница струна Маркер для следующей страницы, если таковой есть. Да
объект перечисление Тип объекта, который всегда является vector_store.search_results.page
Возможные значения: vector_store.search_results.page
Да
поисковый запрос массив Да

VoiceIdsShared

Для этого компонента не определены свойства.

Ждать

Действие ожидания.

Имя Тип Описание Обязательно По умолчанию
тип перечисление Указывает тип события. Для действия ожидания это свойство всегда имеет значение wait.

Возможные значения: wait
Да

Усилия на рассуждение

Только модели o-серии

Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе.

Недвижимость Ценность
Описание Только модели o-серии

Ограничивает усилия по рассуждениям моделей.
В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе.
Тип струна
По умолчанию Средний
Значения low
medium
high

событие ошибки

Возникает при возникновении ошибки. Это может произойти из-за ошибки внутреннего сервера или времени ожидания.

Имя Тип Описание Обязательно По умолчанию
данные ошибка Да
событие струна Да

перечисление события: ErrorEventEnum

Ценность Описание
ошибка

событие завершено

Происходит, когда поток заканчивается.

Имя Тип Описание Обязательно По умолчанию
данные струна Да
событие струна Да

перечисление события: DoneEventEnum

Ценность Описание
Готово

перечисление данных: DoneEventDataEnum

Ценность Описание
[ГОТОВО]

Дальнейшие шаги

Узнайте о моделях и тонкой настройке с помощью REST API. Ознакомьтесь с дополнительными сведениями о базовых моделях, лежащих в основе Azure OpenAI.