Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье содержатся сведения о конечных точках REST API вывода для Azure OpenAI.
Вывод плоскости данных
Остальная часть статьи охватывает новый выпуск API предварительной версии 1 для спецификации вывода Azure плоскости данных OpenAI. Дополнительные сведения см. в руководстве по жизненному циклу API.
Если вы ищете документацию по последнему выпуску API общедоступной версии 1, обратитесь к последнему API вывода плоскости данных общедоступной версии
Создание речи
POST {endpoint}/openai/v1/audio/speech?api-version=preview
Генерирует аудио для преобразования текста в речь.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API моделей Microsoft Foundry, используемая для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Content-Type: многочастный формат данных
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | струна | Текст для создания аудио. Максимальная длина — 4096 символов. | Да | |
| instructions | струна | Управляйте голосом созданного звука с помощью дополнительных инструкций. Не работает с tts-1 или tts-1-hd. |
нет | |
| модель | струна | Модель, используемая для этого текстового запроса на речь. | Да | |
| формат_ответа | объект | Поддерживаемые форматы выходных данных звука для преобразования текста в речь. | нет | |
| speed | число/номер | Скорость речи для сгенерированного аудио. Значения допустимы в диапазоне от 0,25 до 4.0 с 1.0 по умолчанию и более высокими значениями, соответствующими более быстрой речи. | нет | 1 |
| stream_format | перечисление | Формат для потоковой передачи звука. Поддерживаемые форматы: sse и audio.
sse не поддерживается или tts-1tts-1-hdне поддерживается.Возможные значения: sse, audio |
нет | |
| голос | объект | Да |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/octet-stream | струна |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример
Синтезирует звук из предоставленного текста.
POST {endpoint}/openai/v1/audio/speech?api-version=preview
{
"input": "Hi! What are you going to make?",
"voice": "fable",
"response_format": "mp3",
"model": "tts-1"
}
Ответы: код состояния: 200
{
"body": "101010101"
}
Создание транскрибирования
POST {endpoint}/openai/v1/audio/transcriptions?api-version=preview
Транскрибирует звук на язык ввода.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Content-Type: многочастный формат данных
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| chunking_strategy | объект | нет | ||
| └prefix_padding_ms | целое число | Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). | нет | 300 |
| └─ длительность_тишины_мс | целое число | Длительность молчания для обнаружения остановки речи (в миллисекундах). С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя. | нет | 200 |
| Пороговое значение └️ | число/номер | Порог чувствительности (от 0.0 до 1.0) для обнаружения голосовой активности. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах. | нет | 0,5 |
| └─ Тип | перечисление | Необходимо установить значение server_vad, чтобы включить ручное фрагментирование с использованием серверного VAD.Возможные значения: server_vad |
нет | |
| файл | струна | Да | ||
| filename | струна | Необязательный идентификатор файла или описательный идентификатор для связывания с звуковыми данными. | нет | |
| include[] | массив | Дополнительные сведения для добавления в ответ транскрипции.
logprobs возвращает логарифмы вероятностей маркеров в ответе, чтобы понять достоверность модели в транскрипции.
logprobs работает только с response_format, заданным на json, и только с моделями gpt-4o-transcribe, gpt-4o-transcribe-diarize, gpt-4o-mini-transcribe и gpt-4o-mini-transcribe-2025-12-15. |
нет | |
| язык | струна | Язык входного звука. Предоставление языка ввода в формате ISO-639-1 (например en, ) повышает точность и задержку. |
нет | |
| модель | струна | Модель, используемая для этого запроса транскрибирования. | нет | |
| prompt | струна | Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен соответствовать языку звука. | нет | |
| формат_ответа | объект | нет | ||
| поток | булевый | Если задано значение true, данные ответа модели будут передаваться клиенту по мере его создания с помощью событий, отправляемых сервером. Примечание. Потоковая передача не поддерживается для whisper-1 модели и будет игнорироваться. |
нет | Неправда |
| Температура | число/номер | Температура выборки от 0 до 1. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Если задано значение 0, модель будет использовать логарифмическую вероятность для автоматического повышения температуры до достижения определённых пороговых значений. | нет | 0 |
| timestamp_granularities[] | массив | Гранулярность метки времени для заполнения этой транскрибирования.
response_format необходимо задать verbose_json для использования детализации метки времени. Поддерживаются либо оба этих параметра: wordили segment. Примечание. Дополнительная задержка для меток времени сегмента отсутствует, но при создании меток времени слова возникает дополнительная задержка. |
нет | ['segment'] |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureAudioTranscriptionResponse | |
| текст/без форматирования | струна |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример
Получает транскрибированный текст и связанные метаданные из предоставленных речевых звуковых данных.
POST {endpoint}/openai/v1/audio/transcriptions?api-version=preview
{
"file": "<binary audio data>",
"model": "whisper-1",
"response_format": "text"
}
Ответы: код состояния: 200
{
"body": "plain text when requesting text, srt, or vtt"
}
Создание перевода
POST {endpoint}/openai/v1/audio/translations?api-version=preview
Получает транскрибированный текст на английском языке и связанные метаданные из предоставленных речевых звуковых данных.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Content-Type: многочастный формат данных
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| файл | струна | Да | ||
| filename | струна | Необязательный идентификатор файла или описательный идентификатор для связи с звуковыми данными | нет | |
| модель | струна | Модель, используемая для этого запроса на перевод. | нет | |
| prompt | струна | Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен находиться на английском языке. | нет | |
| формат_ответа | объект | нет | ||
| Температура | число/номер | Температура выборки от 0 до 1. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Если задано значение 0, модель будет использовать логарифмическую вероятность для автоматического повышения температуры до достижения определённых пороговых значений. | нет | 0 |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureAudioTranslationResponse | |
| текст/без форматирования | струна |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример
Получает транскрибированный текст на английском языке и связанные метаданные из предоставленных речевых звуковых данных.
POST {endpoint}/openai/v1/audio/translations?api-version=preview
{
"file": "<binary audio data>",
"model": "whisper-1",
"response_format": "text"
}
Ответы: код состояния: 200
{
"body": "plain text when requesting text, srt, or vtt"
}
Создание завершения чата
POST {endpoint}/openai/v1/chat/completions?api-version=preview
Создает завершение чата.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| audio | объект | Параметры выходных данных звука. Требуется при запросе на вывод звука с modalities: ["audio"]. |
нет | |
| └─ Формат | перечисление | Указывает выходной формат звука. Должен быть одним из wav, , mp3,flacopus или pcm16.Возможные значения: wav, aac, mp3, flac, opus, pcm16 |
нет | |
| └️ голос | объект | нет | ||
| источники данных | массив | Источники данных, используемые для функции On Your Data, эксклюзивные для Azure OpenAI. | нет | |
| штраф за частоту | число/номер | Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры на основе их существующей частоты в тексте до сих пор, уменьшая вероятность повторения модели той же строки дословно. | нет | 0 |
| вызов_функции | перечисление | Указание определенной функции путем {"name": "my_function"} принудительного вызова этой функции моделью.Возможные значения: none, auto |
нет | |
| functions | массив | Не рекомендуется использовать в пользу tools.Список функций, для которые модель может создавать входные данные JSON. |
нет | |
| логит_биас | объект | Изменяет вероятность появления указанных маркеров в завершении. Принимает объект JSON, который сопоставляет маркеры (указанные идентификатором маркера в токенизаторе) со связанным значением предвзятости от -100 до 100. С математической точки зрения смещение добавляется к логитам, созданным моделью до выборки. Точный эффект зависит от модели, но значения от –1 до 1 должны уменьшать или увеличивать вероятность выбора; такие значения, как –100 или 100, должны приводить к запрету или эксклюзивному выбору соответствующего маркера. | нет | None |
| logprobs | булевый | Следует ли возвращать вероятности журналов выходных маркеров или нет. Если значение true, возвращает вероятности журнала каждого выходного маркера, возвращаемого в параметре contentmessage. |
нет | Неправда |
| max_completion_tokens (максимальное количество токенов завершения) | целое число | Верхняя граница для числа маркеров, которые можно создать для завершения, включая видимые выходные маркеры и маркеры причин. | нет | |
| макс_токены | целое число | Максимальное количество маркеров, которые можно создать в завершении чата. Это значение можно использовать для управления затратами на текст, созданный с помощью API. Это значение теперь устарело, а предпочитается max_completion_tokens, и несовместимо с моделями серии o1. |
нет | |
| messages | массив | Список сообщений, составляющих беседу до сих пор. В зависимости от используемой модели поддерживаются различные типы сообщений (модальности), такие как текст, изображения и звук. | Да | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| Условия | объект | Типы выходных данных, которые вы хотите, чтобы модель генерировала. Большинство моделей могут создавать текст, который по умолчанию: ["text"]Модель gpt-4o-audio-preview также может использоваться для создания звука. Чтобы запросить, что эта модель создает как текстовые, так и звуковые ответы, можно использовать:["text", "audio"] |
нет | |
| модель | струна | Идентификатор развертывания модели, используемый для запроса завершения чата. | Да | |
| н | целое число | Сколько вариантов завершения чата для каждого входного сообщения. Обратите внимание, что плата будет взиматься на основе количества созданных маркеров во всех вариантах. Имейте в виду n , чтобы 1 свести к минимуму затраты. |
нет | 1 |
| вызовы инструмента в параллельном режиме | объект | Следует ли включить параллельные вызовы функций во время использования средства. | нет | |
| prediction | объект | Базовое представление прогнозируемых выходных данных модели. | нет | |
| └─ Тип | OpenAI.ChatOutputPredictionType | нет | ||
| штраф за присутствие | число/номер | Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры в зависимости от того, появляются ли они в тексте до сих пор, что повышает вероятность того, что модель будет говорить о новых темах. | нет | 0 |
| усилия на рассуждение | объект |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
нет | |
| формат_ответа | объект | нет | ||
| └─ Тип | перечисление | Возможные значения: text, json_objectjson_schema |
нет | |
| seed | целое число | Эта функция доступна в бета-версии. Если задано, наша система будет предпринять лучшие усилия для выборки детерминированного, таким образом, что повторяющиеся запросы с одинаковыми и теми же параметрами должны возвращать тот же seed результат.Детерминированность не гарантируется, и вы должны ссылаться на system_fingerprint параметр ответа для отслеживания изменений в серверной части. |
нет | |
| stop | объект | Не поддерживается с последними моделями рассуждений o3 и o4-mini.До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры. Возвращенный текст не будет содержать последовательность остановки. |
нет | |
| store | булевый | Следует ли хранить выходные данные этого запроса завершения чата для использования в дистилляциях модели или продуктах оценки. | нет | Неправда |
| поток | булевый | Если задано значение true, данные ответа модели будут передаваться клиенту по мере его создания с помощью событий, отправляемых сервером. | нет | Неправда |
| stream_options | объект | Параметры потокового ответа. Этот параметр устанавливается только при установке stream: true. |
нет | |
| └️ include_usage | булевый | Если задано, перед сообщением будет передаваться data: [DONE] дополнительный блок. Поле usage на этом блоке отображает статистику использования маркеров для всего запроса, и choices поле всегда будет пустым массивом.Все остальные блоки также будут содержать usage поле, но со значением NULL.
ЗАМЕТКА: Если поток прерван, вы можете не получить последний блок данных об использовании, содержащий общие данные о количестве использованных токенов для запроса. |
нет | |
| Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | 1 |
| выбор инструмента | OpenAI.ChatCompletionToolChoiceOption | Определяет, какое средство (если таковое) вызывается моделью.none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.required означает, что модель должна вызывать один или несколько инструментов.Указание определенного средства с помощью {"type": "function", "function": {"name": "my_function"}} принудительного вызова этого средства моделью.none значение по умолчанию, если средства отсутствуют.
auto значение по умолчанию, если существуют средства. |
нет | |
| инструменты | массив | Список инструментов, которые может вызывать модель. В настоящее время в качестве инструмента поддерживаются только функции. Используйте это для предоставления списка функций, для которые модель может создавать входные данные JSON. Поддерживаются не более 128 функций. | нет | |
| top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | 1 |
| Пользователь | струна | Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений. | нет | |
| user_security_context | AzureUserSecurityContext | Контекст безопасности пользователя содержит несколько параметров, описывающих само приложение, и конечный пользователь, взаимодействующий с приложением. Эти поля помогают группам по операциям безопасности исследовать и устранять инциденты безопасности, предоставляя комплексный подход к защите приложений ИИ. Learn more о защите приложений ИИ с помощью Microsoft Defender for Cloud. | нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureCreateChatCompletionResponse | |
| text/event-stream | AzureCreateChatCompletionStreamResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример
Создает завершение для предоставленного запроса, параметров и выбранной модели.
POST {endpoint}/openai/v1/chat/completions?api-version=preview
{
"model": "gpt-4o-mini",
"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?..."
}
}
],
"usage": {
"completion_tokens": 557,
"prompt_tokens": 33,
"total_tokens": 590
}
}
}
Создание внедрения
POST {endpoint}/openai/v1/embeddings?api-version=preview
Создает вектор внедрения, представляющий входной текст.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| dimensions | целое число | Число измерений, в которых должны быть внедренные выходные данные. Поддерживается только в text-embedding-3 и более поздних моделях. |
нет | |
| формат_кодирования | перечисление | Формат, в который возвращаются встраиваемые элементы. Может быть либо float, либо base64.Возможные значения: float, base64 |
нет | |
| ввод | строка или массив | Да | ||
| модель | струна | Модель, используемая для запроса внедрения. | Да | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.CreateEmbeddingResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример
Верните встраивания для заданного запроса.
POST {endpoint}/openai/v1/embeddings?api-version=preview
{
"model": "text-embedding-ada-002",
"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.0040426035,
-0.03443847,
-0.00091273896,
-0.0019217303,
0.002349888,
-0.021560553,
0.016515596,
-0.015572986,
0.0038666942,
-8.432463e-05,
0.0032178196,
-0.020365695,
-0.009631885,
-0.007647093,
0.0033837722,
-0.026764825,
-0.010501476,
0.020219658,
0.024640633,
-0.0066912062,
-0.036456455,
-0.0040923897,
-0.013966565,
0.017816665,
0.005366905,
0.022835068,
0.0103488,
-0.0010811808,
-0.028942121,
0.0074280356,
-0.017033368,
0.0074877786,
0.021640211,
0.002499245,
0.013316032,
0.0021524043,
0.010129742,
0.0054731146,
0.03143805,
0.014856071,
0.0023366117,
-0.0008243692,
0.022781964,
0.003038591,
-0.017617522,
0.0013309394,
0.0022154662,
0.00097414135,
0.012041516,
-0.027906578,
-0.023817508,
0.013302756,
-0.003003741,
-0.006890349,
0.0016744611
]
}
],
"usage": {
"prompt_tokens": 4,
"total_tokens": 4
}
}
}
Перечисление evals
GET {endpoint}/openai/v1/evals?api-version=preview
Вывод списка оценок для project.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| after | query | нет | струна | Идентификатор последней оценки из предыдущего запроса на страничную навигацию. |
| limit | query | нет | целое число | Ограничение на количество возвращаемых вальвов в одном ответе на страницы. |
| заказ | query | нет | струна Возможные значения: asc, desc |
Порядок сортировки оценок по временным меткам. Используется asc для возрастания или desc для убывающего порядка. |
| сортировать_по | query | нет | струна Возможные значения: created_at, updated_at |
Evals можно упорядочить по времени создания или времени последнего обновления. Используется created_at для времени создания или updated_at последнего обновления. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.EvalList |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Createeval
POST {endpoint}/openai/v1/evals?api-version=preview
Создайте структуру оценки, которую можно использовать для тестирования производительности модели.
Оценка — это набор критериев тестирования и источника данных. После создания оценки его можно запустить на разных моделях и параметрах модели. Мы поддерживаем несколько типов классировщиков и источников данных.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| настройка_источника_данных | объект | Да | ||
| └─ Тип | OpenAI.EvalDataSourceConfigType | нет | ||
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| имя | струна | Имя оценки. | нет | |
| код состояния | перечисление | Возможные значения: 201 |
Да | |
| критерии тестирования | массив | Список оценщиков для всех запусков оценок в этой группе. Классировщики могут ссылаться на переменные в источнике данных с помощью двойной фигурной скобки, например {{item.variable_name}}. Чтобы ссылаться на выходные данные модели, используйте sample пространство имен (т. е. {{sample.output_text}}). |
Да |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.Eval |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение eval
GET {endpoint}/openai/v1/evals/{eval_id}?api-version=preview
Получение оценки по идентификатору. Извлекает оценку по идентификатору.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.Eval |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Обновление eval
POST {endpoint}/openai/v1/evals/{eval_id}?api-version=preview
Обновите выбор, изменяемые свойства указанной оценки.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| metadata | OpenAI.MetadataPropertyForRequest | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| имя | струна | нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.Eval |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Удаление eval
DELETE {endpoint}/openai/v1/evals/{eval_id}?api-version=preview
Удалите указанную оценку.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | объект |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение запусков eval
GET {endpoint}/openai/v1/evals/{eval_id}/runs?api-version=preview
Получение списка запусков для указанной оценки.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна | |
| after | query | нет | струна | |
| limit | query | нет | целое число | |
| заказ | query | нет | струна Возможные значения: asc, desc |
|
| статус | query | нет | струна Возможные значения: queued, in_progress, completed, canceled, failed |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.EvalRunList |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Создание запуска eval
POST {endpoint}/openai/v1/evals/{eval_id}/runs?api-version=preview
Создайте новый запуск оценки, начинающий процесс оценки.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| источник данных | объект | Да | ||
| └─ Тип | OpenAI.EvalRunDataSourceType | нет | ||
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| имя | струна | Имя запуска. | нет |
Responses
Код состояния: 201
Описание: запрос успешно выполнен, и в результате был создан новый ресурс.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.EvalRun |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение запуска eval
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}?api-version=preview
Получение определенной оценки, выполняемой идентификатором.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна | |
| run_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.EvalRun |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Отмена выполнения eval
POST {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}?api-version=preview
Отмена определенной оценки, выполняемой идентификатором.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна | |
| run_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.EvalRun |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Deleteevalrun
DELETE {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}?api-version=preview
Удалите конкретную оценку, выполняемую идентификатором.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна | |
| run_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | объект |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение выходных элементов выполнения eval
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items?api-version=preview
Получите список выходных элементов для указанного выполнения оценки.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна | |
| run_id | путь | Да | струна | |
| after | query | нет | струна | |
| limit | query | нет | целое число | |
| статус | query | нет | струна Возможные значения: fail, pass |
|
| заказ | query | нет | струна Возможные значения: asc, desc |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.EvalRunOutputItemList |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение выходного элемента выполнения eval
GET {endpoint}/openai/v1/evals/{eval_id}/runs/{run_id}/output_items/{output_item_id}?api-version=preview
Извлеките определенный выходной элемент из вычисления, выполняемого его идентификатором.
ПРИМЕЧАНИЕ. Этот Azure API OpenAI находится в предварительной версии и подлежит изменению.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| aoai-evals | header | Да | струна Возможные значения: preview |
Включает access в AOAI Evals, предварительная версия функции. Для этой функции необходимо задать для заголовка aoai-evals значение preview. |
| eval_id | путь | Да | струна | |
| run_id | путь | Да | струна | |
| output_item_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.EvalRunOutputItem |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Создать файл
POST {endpoint}/openai/v1/files?api-version=preview
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Content-Type: многочастный формат данных
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| истекает через | объект | Да | ||
| Привязка └️ | AzureFileExpiryAnchor | нет | ||
| └= секунды | целое число | нет | ||
| файл | струна | Да | ||
| purpose | перечисление | Целевое назначение загружаемого файла. Одно из следующих: assistants: используется в API помощников: batchиспользуется в API пакетной службы : fine-tuneиспользуется для точной настройки : evalsиспользуется для наборов данных evalВозможные значения: assistants, , batchfine-tuneevals |
Да |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIFile |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример
POST {endpoint}/openai/v1/files?api-version=preview
Перечень файлов
GET {endpoint}/openai/v1/files?api-version=preview
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| purpose | query | нет | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureListFilesResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение файла
GET {endpoint}/openai/v1/files/{file_id}?api-version=preview
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_файла | путь | Да | струна | Идентификатор файла, используемого для этого запроса. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIFile |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Удалить файл
DELETE {endpoint}/openai/v1/files/{file_id}?api-version=preview
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_файла | путь | Да | струна | Идентификатор файла, используемого для этого запроса. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.DeleteFileResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Скачивание файла
GET {endpoint}/openai/v1/files/{file_id}/content?api-version=preview
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_файла | путь | Да | струна | Идентификатор файла, используемого для этого запроса. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/octet-stream | струна |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Rungrader
POST {endpoint}/openai/v1/fine_tuning/alpha/graders/run?api-version=preview
Запустите классировщик.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| грейдер | объект | Объект StringCheckGrader, выполняющий сравнение строк между входами и ссылкой с помощью указанной операции. | Да | |
| └calculate_output calculate_output | струна | Формула для вычисления выходных данных на основе результатов оценки. | нет | |
| └️ evaluation_metric | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
нет | |
| └️ классировщиков | объект | нет | ||
| └image_tag | струна | Тег изображения, используемый для скрипта Python. | нет | |
| └─ Входные данные | массив | Входной текст. Это может включать строки шаблона. | нет | |
| └─ Модель | струна | Модель, используемая для оценки. | нет | |
| └️ имя | струна | Имя классировщика. | нет | |
| Операция └️ | перечисление | Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.Возможные значения: eq, , nelikeilike |
нет | |
| Диапазон └️ | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| Справочник по └️ | струна | Текст, классируемый против. | нет | |
| └─sampling_params | Параметры выборки для модели. | нет | ||
| └─ Источник | струна | Исходный код скрипта Python. | нет | |
| └─ Тип | перечисление | Тип объекта, который всегда multiявляется .Возможные значения: multi |
нет | |
| item | Элемент набора данных, предоставленный классировщику. Это будет использоваться для заполнения item пространства имен. |
нет | ||
| model_sample | струна | Пример модели, который необходимо оценить. Это значение будет использоваться для заполнения sample пространства имен. Переменная output_json будет заполнена, если пример модели является допустимой строкой JSON. |
Да |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.RunGraderResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Проверка оценки
POST {endpoint}/openai/v1/fine_tuning/alpha/graders/validate?api-version=preview
Проверьте классировщик.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| грейдер | объект | Объект StringCheckGrader, выполняющий сравнение строк между входами и ссылкой с помощью указанной операции. | Да | |
| └calculate_output calculate_output | струна | Формула для вычисления выходных данных на основе результатов оценки. | нет | |
| └️ evaluation_metric | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
нет | |
| └️ классировщиков | объект | нет | ||
| └image_tag | струна | Тег изображения, используемый для скрипта Python. | нет | |
| └─ Входные данные | массив | Входной текст. Это может включать строки шаблона. | нет | |
| └─ Модель | струна | Модель, используемая для оценки. | нет | |
| └️ имя | струна | Имя классировщика. | нет | |
| Операция └️ | перечисление | Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.Возможные значения: eq, , nelikeilike |
нет | |
| Диапазон └️ | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| Справочник по └️ | струна | Текст, классируемый против. | нет | |
| └─sampling_params | Параметры выборки для модели. | нет | ||
| └─ Источник | струна | Исходный код скрипта Python. | нет | |
| └─ Тип | перечисление | Тип объекта, который всегда multiявляется .Возможные значения: multi |
нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ValidateGraderResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Создание задания тонкой настройки
POST {endpoint}/openai/v1/fine_tuning/jobs?api-version=preview
Создает задание тонкой настройки, которое начинает процесс создания новой модели из заданного набора данных.
Ответ содержит подробные сведения о задании, в том числе о состоянии задания и имени настроенных моделей после завершения.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| гиперпараметры | объект | Гиперпараметры, используемые для задания тонкой настройки. Это значение теперь устарело в пользу methodи должно передаваться в соответствии с параметром method . |
нет | |
| └batch_size | перечисление | Возможные значения: auto |
нет | |
| └learning_rate_multiplier learning_rate_multiplier | перечисление | Возможные значения: auto |
нет | |
| └️ n_epochs | перечисление | Возможные значения: auto |
нет | |
| Интеграции | массив | Список интеграции для задания тонкой настройки. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| method | OpenAI.FineTuneMethod | Метод, используемый для точной настройки. | нет | |
| модель | строка (см. допустимые модели ниже) | Имя модели для точной настройки. | Да | |
| seed | целое число | Сид определяет воспроизводимость задания. Передача одинаковых параметров начального значения и заданий должна иметь одинаковые результаты, но может отличаться в редких случаях. Если начальное значение не указано, он будет создан для вас. |
нет | |
| Суффикс | струна | Строка до 64 символов, которые будут добавлены в имя настраиваемой модели. Например, suffix в поле "Custom-model-name" будет производиться имя модели, например ft:gpt-4o-mini:openai:custom-model-name:7p4lURel. |
нет | None |
| файл_обучения | струна | Идентификатор отправленного файла, содержащего данные обучения. Набор данных должен быть отформатирован в формате JSONL-файла. Кроме того, необходимо передать файл с целью fine-tune.Содержимое файла должно отличаться в зависимости от того, использует ли модель чат, формат завершения или использует ли метод тонкой настройки формат предпочтения. |
Да | |
| Файл_валидации | струна | Идентификатор отправленного файла, содержащего данные проверки. Если вы предоставляете этот файл, данные используются для периодического создания метрик валидации во время точной настройки. Эти показатели можно просмотреть в файле результатов тонкой настройки. Одни и те же данные не должны присутствовать в файлах обучения и проверки. Набор данных должен быть отформатирован в формате JSONL-файла. Необходимо отправить файл с целью fine-tune. |
нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Список заданий тонкой настройки с разбивкой на страницы
GET {endpoint}/openai/v1/fine_tuning/jobs?api-version=preview
Перечисление заданий точной настройки организации
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| after | query | нет | струна | Идентификатор последнего задания из предыдущего запроса на страницы. |
| limit | query | нет | целое число | Количество получаемых заданий точной настройки. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ListPaginatedFineTuningJobsResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение задания точной настройки
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}?api-version=preview
Получение сведений о задании тонкой настройки.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_задания_тончайшей_настройки | путь | Да | струна | Идентификатор задания тонкой настройки. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Отмена задания тонкой настройки
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/cancel?api-version=preview
Немедленно отмените задание точной настройки.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_задания_тончайшей_настройки | путь | Да | струна | Идентификатор задания тонкой настройки для отмены. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Перечисление контрольных точек задания точной настройки
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints?api-version=preview
Вывод списка контрольных точек для задания тонкой настройки.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_задания_тончайшей_настройки | путь | Да | струна | Идентификатор задания точной настройки для получения контрольных точек. |
| after | query | нет | струна | Идентификатор последнего идентификатора контрольной точки из предыдущего запроса на страницы. |
| limit | query | нет | целое число | Количество получаемых контрольных точек. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ListFineTuningJobCheckpointsResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Список событий настройки параметров
GET {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/events?api-version=preview
Получение обновлений состояния для задания тонкой настройки.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_задания_тончайшей_настройки | путь | Да | струна | Идентификатор задания точной настройки для получения событий. |
| after | query | нет | струна | Идентификатор последнего события из предыдущего запроса на страницы. |
| limit | query | нет | целое число | Количество извлекаемых событий. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ListFineTuningJobEventsResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Приостановка задания тонкой настройки
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/pause?api-version=preview
Приостановка задания точной настройки.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_задания_тончайшей_настройки | путь | Да | струна | Идентификатор задания тонкой настройки для приостановки. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Возобновление задания тонкой настройки
POST {endpoint}/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/resume?api-version=preview
Возобновление приостановленного задания точной настройки.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор_задания_тончайшей_настройки | путь | Да | струна | Идентификатор задания тонкой настройки для возобновления. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.FineTuningJob |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Редактировать изображение
POST {endpoint}/openai/v1/images/edits?api-version=preview
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Content-Type: многочастный формат данных
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | перечисление | Позволяет задать прозрачность фона созданных образов. Этот параметр поддерживается только для gpt-image-1моделей серии. Должно быть одним из значений transparentopaque или auto (значение по умолчанию). При auto использовании модель автоматически определяет лучший фон для изображения.Если transparentвыходной формат должен поддерживать прозрачность, поэтому он должен иметь значение png (значение по умолчанию) или webp.Возможные значения: transparent, opaqueauto |
нет | |
| image | строка или массив | Да | ||
| mask | струна | нет | ||
| модель | струна | Развертывание модели для использования в операции по редактированию изображения. | Да | |
| н | целое число | Количество генерируемых изображений. Должно быть от 1 до 10. | нет | 1 |
| сжатие вывода | целое число | Уровень сжатия (0–100%) для созданных образов. Этот параметр поддерживается только для gpt-image-1-серий моделей с webp или jpeg выходными форматами, и по умолчанию, 100. |
нет | 100 |
| формат_выходных_данных | перечисление | Формат, в котором возвращаются созданные изображения. Этот параметр поддерживается только для gpt-image-1моделей серии. Должно иметь один из типов png, jpeg или webp.Значение по умолчанию — png.Возможные значения: png, jpegwebp |
нет | |
| prompt | струна | Текстовое описание требуемых изображений. Максимальная длина — 1000 символов для dall-e-2gpt-image-1моделей серии и 32000 символов. |
Да | |
| качество | перечисление | Качество создаваемого изображения.
high, medium и low поддерживаются только для gpt-image-1моделей серии.
dall-e-2 поддерживает только standard качество. По умолчанию — auto.Возможные значения: standard, low, medium, high, auto |
нет | |
| формат_ответа | перечисление | Формат, в котором возвращаются созданные изображения. Должен быть одним из url или b64_json. URL-адреса действительны только в течение 60 минут после создания образа. Этот параметр поддерживается только для dall-e-2моделей серии , так как gpt-image-1всегда возвращает образы в кодировке Base64.Возможные значения: url, b64_json |
нет | |
| size | перечисление | Размер созданных изображений. Должен быть одним из 1024x1024, 1536x1024 (альбомная ориентация), 1024x1536 (книжная ориентация) или auto (значение по умолчанию) для моделей серии gpt-image-1, а также одно из 256x256, 512x512 или 1024x1024 для dall-e-2.Возможные значения: 256x256, 512x512, 1024x1024, 1536x1024, 1024x1536, auto |
нет | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureImagesResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Createimage
POST {endpoint}/openai/v1/images/generations?api-version=preview
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | перечисление | Позволяет задать прозрачность фона созданных образов. Этот параметр поддерживается только для gpt-image-1моделей серии. Должно быть одним из значений transparentopaque или auto (значение по умолчанию). При auto использовании модель автоматически определяет лучший фон для изображения.Если transparentвыходной формат должен поддерживать прозрачность, поэтому он должен иметь значение png (значение по умолчанию) или webp.Возможные значения: transparent, opaqueauto |
нет | |
| модель | струна | Развертывание модели, используемое для создания образа. | Да | |
| moderation | перечисление | Управление уровнем модерации содержимого для изображений, созданных моделями серии gpt-image-1.
low Для менее строгой фильтрации или auto (значения по умолчанию).Возможные значения: low, auto |
нет | |
| н | целое число | Количество генерируемых изображений. Должно быть от 1 до 10. Для dall-e-3 поддерживается только n=1. |
нет | 1 |
| сжатие вывода | целое число | Уровень сжатия (0–100%) для созданных образов. Этот параметр поддерживается только для gpt-image-1-серий моделей с webp или jpeg выходными форматами, и по умолчанию, 100. |
нет | 100 |
| формат_выходных_данных | перечисление | Формат, в котором возвращаются созданные изображения. Этот параметр поддерживается только для gpt-image-1моделей серии. Должно иметь один из типов png, jpeg или webp.Возможные значения: png, jpegwebp |
нет | |
| prompt | струна | Текстовое описание требуемых изображений. Максимальная длина — 32000 символов для gpt-image-1моделей серии, 1000 символов для dall-e-2 и 4000 символов.dall-e-3 |
Да | |
| качество | перечисление | Качество создаваемого изображения. - auto (значение по умолчанию) автоматически выбирает лучшее качество для данной модели.- high, medium и low поддерживаются для gpt-image-1моделей серии.- hd и standard поддерживаются для dall-e-3.- standard — единственный вариант для dall-e-2.Возможные значения: standard, hd, low, medium, high, auto |
нет | |
| формат_ответа | перечисление | Формат, в котором сгенерированные изображения с dall-e-2 и dall-e-3 возвращаются. Должен быть одним из url или b64_json. URL-адреса действительны только в течение 60 минут после создания образа. Этот параметр не поддерживается для gpt-image-1моделей серии, которые всегда возвращают образы в кодировке Base64.Возможные значения: url, b64_json |
нет | |
| size | перечисление | Размер созданных изображений. Должен быть одним из 1024x1024, 1536x1024 (альбомная), 1024x1536 (книжная) или auto (значение по умолчанию) для моделей серии gpt-image-1, одним из 256x256, 512x512, или 1024x1024 для dall-e-2, и одним из 1024x1024, 1792x1024 или 1024x1792 для dall-e-3.Возможные значения: auto, 1024x1024, 1536x1024, 1024x1536, 256x256, 512x512, 1792x1024, 1024x1792 |
нет | |
| стиль | перечисление | Стиль созданных изображений. Этот параметр поддерживается только для dall-e-3. Должен быть одним из vivid или natural. Яркость заставляет модель стремиться к созданию гипер-реальных и драматических изображений. Естественные свойства модели позволяют создавать более естественные, менее гипер-реалистичные изображения.Возможные значения: vivid, natural |
нет | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureImagesResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример
Создает изображения с запросом.
POST {endpoint}/openai/v1/images/generations?api-version=preview
{
"model": "dall-e-3",
"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
}
}
}
]
}
}
Перечисление моделей
GET {endpoint}/openai/v1/models?api-version=preview
Выводит список доступных в настоящее время моделей и предоставляет основные сведения о каждом из них, например владельца и доступности.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ListModelsResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение модели
GET {endpoint}/openai/v1/models/{model}?api-version=preview
Извлекает экземпляр модели, предоставляя основные сведения о модели, например владельца и разрешения.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| модель | путь | Да | струна | Идентификатор модели, используемой для этого запроса. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.Model |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Создание ответа
POST {endpoint}/openai/v1/responses?api-version=preview
Создает модельный ответ.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| include | массив | Укажите дополнительные выходные данные для включения в ответ модели. В настоящее время поддерживаются следующие значения: - code_interpreter_call.outputs: включает выходные данные выполнения кода Python в элементах вызова средства интерпретатора.- computer_call_output.output.image_url: добавьте URL-адреса изображений из выходных данных компьютерного вызова.- file_search_call.results: включите результаты поиска вызова средства поиска файлов.- message.input_image.image_url: включите URL-адреса изображения из входного сообщения.- message.output_text.logprobs: включите журналы с сообщениями помощника.- reasoning.encrypted_content: включает зашифрованную версию токенов в элементах рассуждения на выходе. Это позволяет использовать элементы рассуждений в многоэтапных беседах при статическом использовании API ответов (например, если store параметр задан false, или когда организация зарегистрирована в программе нулевого хранения данных). |
нет | |
| ввод | строка или массив | нет | ||
| instructions | струна | Сообщение системы (или разработчика), вставленное в контекст модели. При использовании вместе с previous_response_id инструкциями из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах. |
нет | |
| max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| модель | струна | Развертывание модели, используемое для создания этого ответа. | Да | |
| вызовы инструмента в параллельном режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | нет | True |
| previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| prompt | объект | Ссылка на шаблон запроса и его переменные. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор используемого шаблона запроса. | нет | |
| Переменные └️ | OpenAI.ResponsePromptVariables | Необязательная карта значений для замены переменных в запросе. Значения подстановки могут быть строками или другими типами входных данных ответа, такими как изображения или файлы. | нет | |
| Версия └️ | струна | Необязательная версия шаблона запроса. | нет | |
| reasoning | объект |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| - усилия | OpenAI.ReasoningEffort |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
нет | |
| └─generate_summary | перечисление |
Не рекомендуется: используйте summary вместо этого.Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| └️ сводка | перечисление | Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| store | булевый | Следует ли хранить созданный ответ модели для последующего получения через API. | нет | True |
| поток | булевый | Если задано значение true, данные ответа модели будут передаваться клиенту по мере его создания с помощью событий, отправляемых сервером. | нет | Неправда |
| Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | 1 |
| текст | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| выбор инструмента | объект | Определяет, какое средство (если таковое) вызывается моделью.none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.required означает, что модель должна вызывать один или несколько инструментов. |
нет | |
| └─ Тип | OpenAI.ToolChoiceObjectType | Указывает, что модель должна использовать встроенное средство для создания ответа. | нет | |
| инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Ты может указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели, например поиск файлов. - Вызовы функций (пользовательские средства): функции, определенные вами, что позволяет модели вызывать собственный код. |
нет | |
| top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | 1 |
| truncation | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureResponse | |
| text/event-stream | OpenAI.ResponseStreamEvent |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример
Создать примерный ответ
POST {endpoint}/openai/v1/responses?api-version=preview
Получение ответа
GET {endpoint}/openai/v1/responses/{response_id}?api-version=preview
Извлекает ответ модели с заданным идентификатором.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| response_id | путь | Да | струна | |
| include[] | query | нет | массив |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Удаление ответа
DELETE {endpoint}/openai/v1/responses/{response_id}?api-version=preview
Удаляет ответ по идентификатору.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| response_id | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | объект |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Список входных элементов
GET {endpoint}/openai/v1/responses/{response_id}/input_items?api-version=preview
Возвращает список входных элементов для заданного ответа.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| response_id | путь | Да | струна | |
| limit | query | нет | целое число | Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20. |
| заказ | query | нет | струна Возможные значения: asc, desc |
Сортировка объектов по их метке времени created_at.
asc для возрастания порядка иdesc для убывания. |
| after | query | нет | струна | Курсор для использования в разбиении на страницы.
after — это идентификатор объекта, определяющий место в списке.Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка. |
| before | query | нет | струна | Курсор для использования в разбиении на страницы.
before — это идентификатор объекта, определяющий место в списке.Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo, ваш последующий вызов может содержать before=obj_foo, чтобы получить предыдущую страницу списка. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ResponseItemList |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Список хранилищ векторов
GET {endpoint}/openai/v1/vector_stores?api-version=preview
Возвращает список хранилищ векторов.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| limit | query | нет | целое число | Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20. |
| заказ | query | нет | струна Возможные значения: asc, desc |
Сортировка объектов по их метке времени created_at.
asc для возрастания порядка иdesc для убывания. |
| after | query | нет | струна | Курсор для использования в разбиении на страницы.
after — это идентификатор объекта, определяющий место в списке.Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка. |
| before | query | нет | струна | Курсор для использования в разбиении на страницы.
before — это идентификатор объекта, определяющий место в списке.Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo, ваш последующий вызов может содержать before=obj_foo, чтобы получить предыдущую страницу списка. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ListVectorStoresResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Создание хранилища векторов
POST {endpoint}/openai/v1/vector_stores?api-version=preview
Создает векторное хранилище.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| chunking_strategy | объект | Стратегия по умолчанию. В настоящее время эта стратегия использует и max_chunk_size_tokens имеет значение 800chunk_overlap_tokens .400 |
нет | |
| └️ статический | OpenAI.StaticChunkingStrategy | нет | ||
| └─ Тип | перечисление | Всегда static.Возможные значения: static |
нет | |
| истекает через | OpenAI.VectorStoreExpirationAfter | Политика истечения срока действия для хранилища векторов. | нет | |
| идентификаторы_файлов | массив | Список идентификаторов файлов, которые следует использовать векторным хранилищем. Полезно для таких средств, как file_search, которые могут access файлов. |
нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| имя | струна | Имя векторного хранилища. | нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Примеры
Пример файла не найден: ./examples/vector_stores.json
Получение хранилища векторов
GET {endpoint}/openai/v1/vector_stores/{vector_store_id}?api-version=preview
Извлекает векторное хранилище.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор извлекаемого хранилища векторов. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Изменение хранилища векторов
POST {endpoint}/openai/v1/vector_stores/{vector_store_id}?api-version=preview
Изменяет векторное хранилище.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор измененного хранилища векторов. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| истекает через | объект | Политика истечения срока действия для хранилища векторов. | нет | |
| Привязка └️ | перечисление | Метка времени привязки, после которой применяется политика истечения срока действия. Поддерживаемые привязки: last_active_at.Возможные значения: last_active_at |
нет | |
| └️ дней | целое число | Количество дней после истечения срока действия привязки хранилища векторов. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| имя | струна | Имя векторного хранилища. | нет |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Удаление хранилища векторов
DELETE {endpoint}/openai/v1/vector_stores/{vector_store_id}?api-version=preview
Удаление векторного хранилища.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор удаленного хранилища векторов. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.DeleteVectorStoreResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Создание пакета файлов хранилища векторов
POST {endpoint}/openai/v1/vector_stores/{vector_store_id}/file_batches?api-version=preview
Создайте пакет файла векторного хранилища.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор хранилища векторов, для которого создается пакет файла. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| attributes | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами. | нет | |
| chunking_strategy | OpenAI.ChunkingStrategyRequestParam | Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . |
нет | |
| идентификаторы_файлов | массив | Список идентификаторов файлов, которые следует использовать векторным хранилищем. Полезно для таких средств, как file_search, которые могут access файлов. |
Да |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreFileBatchObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение пакета файлов хранилища векторов
GET {endpoint}/openai/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}?api-version=preview
Извлекает пакет файла векторного хранилища.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор хранилища векторов, к которому принадлежит пакет файла. |
| batch_id | путь | Да | струна | Идентификатор извлекаемого пакета файлов. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreFileBatchObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Отмена пакета файлов хранилища векторов
POST {endpoint}/openai/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/cancel?api-version=preview
Отмена пакета файла векторного хранилища. Это пытается отменить обработку файлов в этом пакете как можно скорее.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор хранилища векторов, к которому принадлежит пакет файла. |
| batch_id | путь | Да | струна | Идентификатор партии файлов, которую нужно отменить. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreFileBatchObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Вывод списка файлов в пакетном хранилище векторного хранилища
GET {endpoint}/openai/v1/vector_stores/{vector_store_id}/file_batches/{batch_id}/files?api-version=preview
Возвращает список файлов векторного хранилища в пакете.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор хранилища векторов, к которому принадлежит пакет файла. |
| batch_id | путь | Да | струна | Идентификатор пакета файлов, к которому принадлежат файлы. |
| limit | query | нет | целое число | Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20. |
| заказ | query | нет | струна Возможные значения: asc, desc |
Сортировка объектов по их метке времени created_at.
asc для возрастания порядка иdesc для убывания. |
| after | query | нет | струна | Курсор для использования в разбиении на страницы.
after — это идентификатор объекта, определяющий место в списке.Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка. |
| before | query | нет | струна | Курсор для использования в разбиении на страницы.
before — это идентификатор объекта, определяющий место в списке.Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo, ваш последующий вызов может содержать before=obj_foo, чтобы получить предыдущую страницу списка. |
| фильтр | query | нет | Фильтрация по состоянию файла. Один из in_progress, completed, failed, cancelled. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ListVectorStoreFilesResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Вывод списка файлов хранилища векторов
GET {endpoint}/openai/v1/vector_stores/{vector_store_id}/files?api-version=preview
Возвращает список файлов векторного хранилища.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор хранилища векторов, к которому принадлежат файлы. |
| limit | query | нет | целое число | Ограничение количества возвращаемых объектов. Ограничение может быть от 1 до 100, а значение по умолчанию — 20. |
| заказ | query | нет | струна Возможные значения: asc, desc |
Сортировка объектов по их метке времени created_at.
asc для возрастания порядка иdesc для убывания. |
| after | query | нет | струна | Курсор для использования в разбиении на страницы.
after — это идентификатор объекта, определяющий место в списке.Например, если вы делаете запрос списка и получаете 100 объектов, заканчивая obj_foo, последующий вызов может включать after=obj_foo, чтобы получить следующую страницу списка. |
| before | query | нет | струна | Курсор для использования в разбиении на страницы.
before — это идентификатор объекта, определяющий место в списке.Например, если вы делаете запрос списка и получаете 100 объектов, список заканчивается на obj_foo, ваш последующий вызов может содержать before=obj_foo, чтобы получить предыдущую страницу списка. |
| фильтр | query | нет | Фильтрация по состоянию файла. Один из in_progress, completed, failed, cancelled. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.ListVectorStoreFilesResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Создание файла хранилища векторов
POST {endpoint}/openai/v1/vector_stores/{vector_store_id}/files?api-version=preview
Создайте файл векторного хранилища, прикрепив его к векторному хранилищу.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор векторного хранилища, для которого создается файл. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| attributes | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами. | нет | |
| chunking_strategy | OpenAI.ChunkingStrategyRequestParam | Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . |
нет | |
| идентификатор_файла | струна | Идентификатор файла, который должен использовать хранилище векторов. Полезно для таких средств, как file_search, которые могут access файлов. |
Да |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreFileObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Получение файла хранилища векторов
GET {endpoint}/openai/v1/vector_stores/{vector_store_id}/files/{file_id}?api-version=preview
Извлекает файл векторного хранилища.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор векторного хранилища, к которому принадлежит файл. |
| идентификатор_файла | путь | Да | струна | Идентификатор извлекаемого файла. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreFileObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Обновление атрибутов файла хранилища векторов
POST {endpoint}/openai/v1/vector_stores/{vector_store_id}/files/{file_id}?api-version=preview
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | |
| идентификатор_файла | путь | Да | струна |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| attributes | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами. | Да |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.VectorStoreFileObject |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Удаление файла хранилища векторов
DELETE {endpoint}/openai/v1/vector_stores/{vector_store_id}/files/{file_id}?api-version=preview
Удаление файла векторного хранилища. Это приведет к удалению файла из векторного хранилища, но сам файл не будет удален. Чтобы удалить файл, используйте конечную точку удаления файла.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| vector_store_id | путь | Да | струна | Идентификатор векторного хранилища, к которому принадлежит файл. |
| идентификатор_файла | путь | Да | струна | Идентификатор удаленного файла. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | OpenAI.DeleteVectorStoreFileResponse |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureErrorResponse |
Задания создания видео — создание
POST {endpoint}/openai/v1/video/generations/jobs?api-version=preview
Создает задание создания видео.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Тело запроса
Тип содержания: application/json
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| height | целое число | Высота видео. Поддерживаются следующие измерения: 480x480, 854x480, 720x720, 1280x720, 1080x1080 и 1920x1080 в альбомной и книжной ориентации. | Да | |
| модель | струна | Имя развертывания, используемого для этого запроса. | Да | |
| n_seconds | целое число | Длительность задания создания видео. Должно быть от 1 до 20 секунд. | нет | 5 |
| n_variants | целое число | Количество видео для создания в качестве вариантов для этого задания. Значение должно находиться в диапазоне от 1 до 5. Меньшие размеры позволяют больше вариантов. | нет | 1 |
| prompt | струна | Запрос для задания создания видео. | Да | |
| Ширина | целое число | Ширина видео. Поддерживаются следующие измерения: 480x480, 854x480, 720x720, 1280x720, 1080x1080 и 1920x1080 в альбомной и книжной ориентации. | Да |
Тело запроса
Content-Type: многочастный формат данных
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| files | массив | Да | ||
| height | целое число | Высота видео. Поддерживаются следующие измерения: 480x480, 854x480, 720x720, 1280x720, 1080x1080 и 1920x1080 в альбомной и книжной ориентации. | Да | |
| inpaint_items | массив | Необязательные элементы для этого задания создания видео. | нет | |
| модель | струна | Имя развертывания, используемого для этого запроса. | Да | |
| n_seconds | целое число | Длительность задания создания видео. Должно быть от 1 до 20 секунд. | нет | 5 |
| n_variants | целое число | Количество видео для создания в качестве вариантов для этого задания. Значение должно находиться в диапазоне от 1 до 5. Меньшие размеры позволяют больше вариантов. | нет | 1 |
| prompt | струна | Запрос для задания создания видео. | Да | |
| Ширина | целое число | Ширина видео. Поддерживаются следующие измерения: 480x480, 854x480, 720x720, 1280x720, 1080x1080 и 1920x1080 в альбомной и книжной ориентации. | Да |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | VideoGenerationJob |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIVideoGenerationErrorResponse |
Примеры
Пример файла не найден: ./examples/create_video_generation_job_simple.json
Задания создания видео — список
GET {endpoint}/openai/v1/video/generations/jobs?api-version=preview
Выводит список заданий создания видео.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| before | query | нет | струна | |
| after | query | нет | струна | |
| limit | query | Да | целое число | |
| statuses | query | нет | массив |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | VideoGenerationJobList |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIVideoGenerationErrorResponse |
Примеры
Пример файла не найден: ./examples/get_video_generation_job_list.json
Задания создания видео — Получение
GET {endpoint}/openai/v1/video/generations/jobs/{job-id}?api-version=preview
Извлекает свойства задания создания видео.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор задания | путь | Да | струна | Идентификатор задания создания видео, используемого для запроса OpenAI Azure. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | VideoGenerationJob |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIVideoGenerationErrorResponse |
Примеры
Пример файла не найден: ./examples/get_video_generation_job.json
Задания создания видео — удаление
DELETE {endpoint}/openai/v1/video/generations/jobs/{job-id}?api-version=preview
Удаляет задание создания видео.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| идентификатор задания | путь | Да | струна | Идентификатор задания создания видео, используемого для запроса OpenAI Azure. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 204
Описание. Для этого запроса нет содержимого, но заголовки могут быть полезны.
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIVideoGenerationErrorResponse |
Поколения видео — Получить
GET {endpoint}/openai/v1/video/generations/{generation-id}?api-version=preview
Извлекает поколение видео по идентификатору.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| generation-id | путь | Да | струна | Идентификатор создания видео, используемого для запроса OpenAI Azure. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | VideoGeneration |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIVideoGenerationErrorResponse |
Примеры
Пример файла не найден: ./examples/get_video_generation.json
Генерация видео — получение миниатюры
GET {endpoint}/openai/v1/video/generations/{generation-id}/content/thumbnail?api-version=preview
Извлекает эскиз созданного видеоконтента.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| generation-id | путь | Да | струна | Идентификатор создания видео, используемого для запроса OpenAI Azure. |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| image/jpg | струна |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIVideoGenerationErrorResponse |
Поколения видео — получение содержимого видео
GET {endpoint}/openai/v1/video/generations/{generation-id}/content/video?api-version=preview
Извлекает созданное видео содержимое.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| generation-id | путь | Да | струна | Идентификатор создания видео, используемого для запроса OpenAI Azure. |
| качество | query | нет |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
| Тип содержимого | Тип | Описание |
|---|---|---|
| video/mp4 | струна |
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIVideoGenerationErrorResponse |
Поколения видео — получение только заголовков видеоконтентов
HEAD {endpoint}/openai/v1/video/generations/{generation-id}/content/video?api-version=preview
Извлекает заголовки для созданного видеоконтента.
Параметры URI
| Имя. | In | Обязательно | Тип | Description |
|---|---|---|---|---|
| endpoint | путь | Да | струна URL-адрес |
Поддерживаемые конечные точки OpenAI Azure (протокол и имя узла, например https://aoairesource.openai.azure.com. Замените "aoairesource" именем ресурса OpenAI Azure). https://{your-resource-name}.openai. azure.com |
| версия API | query | нет | Явная версия API Foundry Models, которую следует использовать для этого запроса.v1, если не указано иначе. |
|
| generation-id | путь | Да | струна | Идентификатор создания видео, используемого для запроса OpenAI Azure. |
| качество | query | нет |
Заголовок запроса
Используйте аутентификацию на основе токенов или API-ключ. Рекомендуется использовать аутентификацию на основе токенов, так как это более безопасно.
| Имя. | Обязательно | Тип | Description |
|---|---|---|---|
| Authorization | True | струна |
Пример:Authorization: Bearer {Azure_OpenAI_Auth_Token}To создайте маркер проверки подлинности с помощью Azure CLI: az account get-access-token --resource https://cognitiveservices.azure.comТип: oauth2 URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/v2.0/authorizeобласть: https://ai.azure.com/.default |
| API-ключ | True | струна | Укажите здесь ключ API OpenAI Azure |
Responses
Код состояния: 200
Описание: запрос выполнен успешно.
Код состояния: по умолчанию
Описание: непредвиденная ошибка.
| Тип содержимого | Тип | Описание |
|---|---|---|
| application/json | AzureOpenAIVideoGenerationErrorResponse |
Components
AudioTaskLabel
Определяет возможные дескрипторы для доступных ответов на звуковые операции.
| Недвижимость | Ценность |
|---|---|
| Описание | Определяет возможные дескрипторы для доступных ответов на звуковые операции. |
| Тип | струна |
| Значения | transcribetranslate |
AudioTranslationSegment
Расширенная информация о одном сегменте переведенных звуковых данных. Сегменты обычно представляют примерно 5–10 секунд речи. Границы сегментов обычно происходят между словами, но не обязательно предложениями.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| avg_logprob | число/номер | Средняя вероятность журнала, связанная с этим сегментом звука. | Да | |
| коэффициент сжатия | число/номер | Коэффициент сжатия этого сегмента звука. | Да | |
| конец | число/номер | Время, в течение которого этот сегмент закончился относительно начала переведенного звука. | Да | |
| id | целое число | 0-й индекс этого сегмента в переводе. | Да | |
| вероятность_отсутствия_речи | число/номер | Вероятность отсутствия обнаружения речи в этом сегменте звука. | Да | |
| seek | целое число | Позиция поиска, связанная с обработкой этого сегмента звука. Позиции поиска выражаются как сотые секунды. Модель может обрабатывать несколько сегментов из одной позиции поиска, поэтому, хотя позиция поиска никогда не будет указывать на более позднее время, чем начало сегмента, начало сегмента может отражать значительно более позднее время, чем связанная с ним поисковая позиция. |
Да | |
| начало | число/номер | Время начала этого сегмента относительно начала переведенного звука. | Да | |
| Температура | число/номер | Оценка температуры, связанная с этим сегментом звука. | Да | |
| текст | струна | Переведенный текст, который был частью этого сегмента звука. | Да | |
| tokens | массив | Идентификаторы маркеров, соответствующие переведенным тексту в этом сегменте звука. | Да |
AzureAIFoundryModelsApiVersion
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | v1preview |
AzureAudioTranscriptionResponse
Сведения о результатах операции, которая транскрибировала голосовой звук в письменный текст.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| duration | число/номер | Общая длительность звука, обработанного для создания сопроводительных сведений о транскрибировании. | нет | |
| язык | струна | Речной язык, обнаруженный в транскрибированных звуковых данных. Это выражается как двухбуквенный код языка ISO-639-1, например en или fr. |
нет | |
| segments | массив | Коллекция сведений о времени, вероятностях и других деталях каждого обработанного сегмента звука. | нет | |
| Задача | объект | Определяет возможные дескрипторы для доступных ответов на звуковые операции. | нет | |
| текст | струна | Транскрибированный текст для предоставленных аудиофайлов. | Да | |
| words | массив | Коллекция сведений о времени обработки каждого обработанного слова. | нет |
AzureAudioTranslationResponse
Сведения о результатах операции, которая превратила речной звук в письменный текст.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| duration | число/номер | Общая длительность звука, обработанного для создания сопровождающих сведений о переводе. | нет | |
| язык | струна | Речной язык, обнаруженный в переведенных звуковых данных. Это выражается как двухбуквенный код языка ISO-639-1, например en или fr. |
нет | |
| segments | массив | Коллекция сведений о времени, вероятностях и других деталях каждого обработанного сегмента звука. | нет | |
| Задача | объект | Определяет возможные дескрипторы для доступных ответов на звуковые операции. | нет | |
| текст | струна | Переведенный текст для предоставленных звуковых данных. | Да |
AzureChatCompletionResponseMessage
Компонент расширенной модели ответа для сообщений ответа о завершении чата на Azure OpenAI service. Эта модель добавляет поддержку контекста сообщения чата, используемого функцией On Your Data для намерений, ссылок и других сведений, связанных с получением дополненного поколения.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| аннотации | массив | Заметки для сообщения, если это применимо, как при использовании средства поиска в Интернете. | нет | |
| audio | объект | Если запрашивается модальность вывода звука, этот объект содержит данные о звуковом ответе модели. | нет | |
| └─ Данные | струна | Звуковые байты в кодировке Base64, созданные моделью, в формате, указанном в запросе. | нет | |
| └ истекает_в | целое число | Метка времени Unix (в секундах), когда этот звуковой ответ больше не будет доступен на сервере для использования в многоэтапных беседах. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор для этого звукового ответа. | нет | |
| └─ Расшифровка | струна | Расшифровка звука, созданного моделью. | нет | |
| содержимое | струна | Содержимое сообщения. | Да | |
| context | объект | Дополнительное свойство, добавленное в ответные сообщения о завершении чата, созданное Azure OpenAI service при использовании поведения расширения. Сюда входят сведения о намерении и ссылке из функции On Your Data. | нет | |
| └─ все_извлеченные_документы | объект | Сводная информация о документах, полученных операцией извлечения данных. | нет | |
| └chunk_id | струна | Идентификатор блока для ссылки. | нет | |
| └─ Содержимое | струна | Содержимое ссылки. | нет | |
| └ data_source_index | целое число | Индекс источника данных, используемый для извлечения. | нет | |
| └─ путь к файлу | струна | Путь к файлу для цитирования. | нет | |
| └️ причина_фильтрации | перечисление | Если применимо, указывает на то, почему документ был отфильтрован. Возможные значения: score, rerank |
нет | |
| └─ оригинальный_оценочный_балл_поиска | число/номер | Исходная оценка релевантности для поиска. | нет | |
| └─ пересчет_оценки | число/номер | Оценка повторного извлечения. | нет | |
| └─ поисковые_запросы | массив | Поисковые запросы, выполняемые для получения документов. | нет | |
| Заголовок | струна | Заголовок ссылки. | нет | |
| └─ URL | струна | URL-адрес ссылки. | нет | |
| Цитаты | массив | Ссылки, созданные извлечением данных. | нет | |
| └─ намерение | струна | Детектированное намерение из истории чата, которое используется для сохранения контекста беседы между взаимодействиями | нет | |
| вызов_функции | объект | Устаревшие и замененные tool_calls. Имя и аргументы вызываемой функции, созданной моделью. |
нет | |
| └─ аргументы | струна | нет | ||
| └️ имя | струна | нет | ||
| reasoning_content | струна | Свойство расширения Azure, содержащее созданное содержимое причин из поддерживаемых моделей. | нет | |
| отказ | струна | Сообщение об отказе, созданное моделью. | Да | |
| роль | перечисление | Роль автора этого сообщения. Возможные значения: assistant |
Да | |
| вызовы инструментов | ChatCompletionMessageToolCallsItem | Вызовы средства, созданные моделью, например вызовы функций. | нет |
AzureChatCompletionStreamResponseDelta
Модель расширенного ответа для ответа потокового чата в Azure OpenAI service. Эта модель добавляет поддержку контекста сообщения чата, используемого функцией On Your Data для намерений, ссылок и других сведений, связанных с получением дополненного поколения.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| audio | объект | нет | ||
| └─ Данные | струна | нет | ||
| └ истекает_в | целое число | нет | ||
| Идентификатор └️ | струна | нет | ||
| └─ Расшифровка | струна | нет | ||
| содержимое | струна | Содержимое сообщения блока. | нет | |
| context | объект | Дополнительное свойство, добавленное в ответные сообщения о завершении чата, созданное Azure OpenAI service при использовании поведения расширения. Сюда входят сведения о намерении и ссылке из функции On Your Data. | нет | |
| └─ все_извлеченные_документы | объект | Сводная информация о документах, полученных операцией извлечения данных. | нет | |
| └chunk_id | струна | Идентификатор блока для ссылки. | нет | |
| └─ Содержимое | струна | Содержимое ссылки. | нет | |
| └ data_source_index | целое число | Индекс источника данных, используемый для извлечения. | нет | |
| └─ путь к файлу | струна | Путь к файлу для цитирования. | нет | |
| └️ причина_фильтрации | перечисление | Если применимо, указывает на то, почему документ был отфильтрован. Возможные значения: score, rerank |
нет | |
| └─ оригинальный_оценочный_балл_поиска | число/номер | Исходная оценка релевантности для поиска. | нет | |
| └─ пересчет_оценки | число/номер | Оценка повторного извлечения. | нет | |
| └─ поисковые_запросы | массив | Поисковые запросы, выполняемые для получения документов. | нет | |
| Заголовок | струна | Заголовок ссылки. | нет | |
| └─ URL | струна | URL-адрес ссылки. | нет | |
| Цитаты | массив | Ссылки, созданные извлечением данных. | нет | |
| └─ намерение | струна | Детектированное намерение из истории чата, которое используется для сохранения контекста беседы между взаимодействиями | нет | |
| вызов_функции | объект | Устаревшие и замененные tool_calls. Имя и аргументы вызываемой функции, созданной моделью. |
нет | |
| └─ аргументы | струна | нет | ||
| └️ имя | струна | нет | ||
| reasoning_content | струна | Свойство расширения Azure, содержащее созданное содержимое причин из поддерживаемых моделей. | нет | |
| отказ | струна | Сообщение об отказе, созданное моделью. | нет | |
| роль | объект | Роль автора сообщения | нет | |
| вызовы инструментов | массив | нет |
AzureChatDataSource
Представление данных конфигурации для одного источника данных чата OpenAI Azure. Это будет использоваться запросом завершения чата, который должен использовать Azure расширения чата OpenAI для расширения поведения ответа. Использование этой конфигурации совместимо только с Azure OpenAI.
Дискриминатор для AzureChatDataSource
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
azure_search |
AzureSearchChatDataSource |
azure_cosmos_db |
AzureCosmosDBChatDataSource |
elasticsearch |
ElasticsearchChatDataSource |
pinecone |
PineconeChatDataSource |
mongo_db |
MongoDBChatDataSource |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | объект | Да |
AzureChatDataSourceAccessTokenAuthenticationOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| access_token | струна | Да | ||
| type | перечисление | Возможные значения: access_token |
Да |
AzureChatDataSourceApiKeyAuthenticationOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ключ | струна | Да | ||
| type | перечисление | Возможные значения: api_key |
Да |
AzureChatDataSourceAuthenticationOptions
Дискриминатор для AzureChatDataSourceAuthenticationOptions
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
system_assigned_managed_identity |
AzureChatDataSourceSystemAssignedManagedIdentityAuthenticationOptions |
user_assigned_managed_identity |
AzureChatDataSourceUserAssignedManagedIdentityAuthenticationOptions |
access_token |
AzureChatDataSourceAccessTokenAuthenticationOptions |
connection_string |
AzureChatDataSourceConnectionStringAuthenticationOptions |
key_and_key_id |
AzureChatDataSourceKeyAndKeyIdAuthenticationOptions |
encoded_api_key |
AzureChatDataSourceEncodedApiKeyAuthenticationOptions |
username_and_password |
AzureChatDataSourceUsernameAndPasswordAuthenticationOptions |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | AzureChatDataSourceAuthenticationOptionsType | Да |
AzureChatDataSourceAuthenticationOptionsType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | api_keyusername_and_passwordconnection_stringkey_and_key_idencoded_api_keyaccess_tokensystem_assigned_managed_identityuser_assigned_managed_identity |
AzureChatDataSourceConnectionStringAuthenticationOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| строка подключения | струна | Да | ||
| type | перечисление | Возможные значения: connection_string |
Да |
AzureChatDataSourceDeploymentNameVectorizationSource
Представляет источник векторизации, который вызывает внутренние вызовы службы к развертыванию модели внедрения OpenAI Azure. В отличие от источника векторизации на основе конечных точек, источник векторизации на основе развертываний должен быть частью одного и того же Azure ресурса OpenAI, но может использоваться даже в частных сетях.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| имя_развертывания | струна | Модель встраивания, используемая для векторизации. Это развертывание должно существовать в том же Azure ресурсе OpenAI, что и развертывание модели, используемое для завершения чата. | Да | |
| dimensions | целое число | Количество измерений, запрашиваемых для эмбеддингов. Поддерживается только в моделях text-embedding-3 и более поздних версий. |
нет | |
| type | перечисление | Идентификатор типа, всегда «deployment_name» для этого источника данных векторизации. Возможные значения: deployment_name |
Да |
AzureChatDataSourceEncodedApiKeyAuthenticationOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| encoded_api_key | струна | Да | ||
| type | перечисление | Возможные значения: encoded_api_key |
Да |
AzureChatDataSourceEndpointVectorizationSource
Представляет источник векторизации, который вызывает вызовы общедоступной службы к развертыванию модели внедрения openAI Azure.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| аутентификация | объект | Да | ||
| └─access_token | струна | нет | ||
| └─ Ключ | струна | нет | ||
| └─ Тип | перечисление | Возможные значения: access_token |
нет | |
| dimensions | целое число | Количество измерений, запрашиваемых для эмбеддингов. Поддерживается только в моделях text-embedding-3 и более поздних версий. |
нет | |
| endpoint | струна | Указывает URL-адрес конечной точки ресурса, из которого должны быть получены внедренные модули. Он должен быть в формате: https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings. Параметр запроса версии API не разрешен. |
Да | |
| type | перечисление | Идентификатор типа всегда "endpoint" для этого типа источника векторизации. Возможные значения: endpoint |
Да |
AzureChatDataSourceIntegratedVectorizationSource
Представляет интегрированный источник векторизации, определенный в вспомогательном ресурсе поиска.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Идентификатор типа всегда "интегрированный" для этого типа источника векторизации. Возможные значения: integrated |
Да |
AzureChatDataSourceKeyAndKeyIdAuthenticationOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ключ | струна | Да | ||
| key_id | струна | Да | ||
| type | перечисление | Возможные значения: key_and_key_id |
Да |
AzureChatDataSourceModelIdVectorizationSource
Представляет источник векторизации, который вызывает службы на основе идентификатора модели search service. Этот исходный тип в настоящее время поддерживается только Elasticsearch.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| model_id | струна | Идентификатор сборки модели внедрения, используемый для векторизации. | Да | |
| type | перечисление | Идентификатор типа всегда model_id для этого типа источника векторизации. Возможные значения: model_id |
Да |
AzureChatDataSourceSystemAssignedManagedIdentityAuthenticationOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: system_assigned_managed_identity |
Да |
AzureChatDataSourceType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | azure_searchazure_cosmos_dbelasticsearchpineconemongo_db |
AzureChatDataSourceUserAssignedManagedIdentityAuthenticationOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| идентификатор ресурса управляемой идентификации | струна | Да | ||
| type | перечисление | Возможные значения: user_assigned_managed_identity |
Да |
AzureChatDataSourceUsernameAndPasswordAuthenticationOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| пароль | струна | Да | ||
| type | перечисление | Возможные значения: username_and_password |
Да | |
| username | струна | Да |
AzureChatDataSourceVectorizationSource
Представление источника векторизации данных, который можно использовать как ресурс внедрения с источником данных.
Дискриминатор для AzureChatDataSourceVectorizationSource
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
deployment_name |
AzureChatDataSourceDeploymentNameVectorizationSource |
integrated |
AzureChatDataSourceIntegratedVectorizationSource |
model_id |
AzureChatDataSourceModelIdVectorizationSource |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | объект | Да |
AzureChatDataSourceVectorizationSourceType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | endpointdeployment_namemodel_idintegrated |
AzureChatMessageContext
Дополнительное свойство, добавленное в ответные сообщения о завершении чата, созданное Azure OpenAI service при использовании поведения расширения. Сюда входят сведения о намерении и ссылке из функции On Your Data.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| all_retrieved_documents | объект | Сводная информация о документах, полученных операцией извлечения данных. | нет | |
| └chunk_id | струна | Идентификатор блока для ссылки. | нет | |
| └─ Содержимое | струна | Содержимое ссылки. | нет | |
| └ data_source_index | целое число | Индекс источника данных, используемый для извлечения. | нет | |
| └─ путь к файлу | струна | Путь к файлу для цитирования. | нет | |
| └️ причина_фильтрации | перечисление | Если применимо, указывает на то, почему документ был отфильтрован. Возможные значения: score, rerank |
нет | |
| └─ оригинальный_оценочный_балл_поиска | число/номер | Исходная оценка релевантности для поиска. | нет | |
| └─ пересчет_оценки | число/номер | Оценка повторного извлечения. | нет | |
| └─ поисковые_запросы | массив | Поисковые запросы, выполняемые для получения документов. | нет | |
| Заголовок | струна | Заголовок ссылки. | нет | |
| └─ URL | струна | URL-адрес ссылки. | нет | |
| citations | массив | Ссылки, созданные извлечением данных. | нет | |
| намерение | струна | Детектированное намерение из истории чата, которое используется для сохранения контекста беседы между взаимодействиями | нет |
AzureContentFilterBlocklistResult
Коллекция результатов фильтрации true/false для настроенных настраиваемых списков блокировок.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| details | массив | Пары отдельных идентификаторов черных списков и привели ли они к действию фильтрации. | нет | |
| Фильтруется | булевый | Значение, указывающее, приводит ли любой из подробных списков блокировок к действию фильтрации. | Да |
AzureContentFilterCompletionTextSpan
Представление диапазона текста завершения, используемого результатами фильтра содержимого OpenAI Azure.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| completion_end_offset | целое число | Смещение первой точки кода UTF32, которая исключается из диапазона. Это поле всегда равно completion_start_offset для пустых диапазонов. Это поле всегда больше completion_start_offset для непустых диапазонов. | Да | |
| completion_start_offset | целое число | Смещение точки кода UTF32, которая начинает диапазон. | Да |
AzureContentFilterCompletionTextSpanDetectionResult
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| details | массив | Подробные сведения об обнаруженных диапазонах текста завершения. | Да | |
| Обнаружены | булевый | Обнаружена ли в содержимом категория отмеченного контента. | Да | |
| Фильтруется | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | Да |
AzureContentFilterCustomTopicResult
Коллекция результатов фильтрации true/false для настроенных пользовательских разделов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| details | массив | Пары идентификаторов отдельных разделов и их обнаружение. | нет | |
| Фильтруется | булевый | Значение, указывающее, приводит ли любой из подробных разделов к действию фильтрации. | Да |
AzureContentFilterDetectionResult
Элемент результата фильтра содержимого с метками, указывающий, был ли обнаружен контент и был ли отфильтрован содержимое.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| Обнаружены | булевый | Обнаружена ли в содержимом категория отмеченного контента. | Да | |
| Фильтруется | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | Да |
AzureContentFilterImagePromptResults
Результат фильтра содержимого для содержимого входного запроса операции создания изображения.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| custom_blocklists | объект | Коллекция результатов фильтрации true/false для настроенных настраиваемых списков блокировок. | нет | |
| └️ подробности | массив | Пары отдельных идентификаторов черных списков и привели ли они к действию фильтрации. | нет | |
| └️ отфильтрован | булевый | Значение, указывающее, приводит ли любой из подробных списков блокировок к действию фильтрации. | нет | |
| custom_topics | объект | Коллекция результатов фильтрации true/false для настроенных пользовательских разделов. | нет | |
| └️ подробности | массив | Пары идентификаторов отдельных разделов и их обнаружение. | нет | |
| └️ отфильтрован | булевый | Значение, указывающее, приводит ли любой из подробных разделов к действию фильтрации. | нет | |
| jailbreak | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли обнаружен контент и был ли отфильтрован содержимое. | Да | |
| └─ Обнаружено | булевый | Обнаружена ли в содержимом категория отмеченного контента. | нет | |
| └️ отфильтрован | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | нет | |
| profanity | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли обнаружен контент и был ли отфильтрован содержимое. | нет | |
| └─ Обнаружено | булевый | Обнаружена ли в содержимом категория отмеченного контента. | нет | |
| └️ отфильтрован | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | нет |
AzureContentFilterImageResponseResults
Результат фильтрации содержимого для вывода содержимого ответа операции генерации изображений.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| hate | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| самоповреждение | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| sexual | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| violence | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет |
AzureContentFilterResultForChoice
Результат фильтра содержимого для одного элемента ответа, созданного системой создания искусственного интеллекта.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| custom_blocklists | объект | Коллекция результатов фильтрации true/false для настроенных настраиваемых списков блокировок. | нет | |
| └️ подробности | массив | Пары отдельных идентификаторов черных списков и привели ли они к действию фильтрации. | нет | |
| └️ отфильтрован | булевый | Значение, указывающее, приводит ли любой из подробных списков блокировок к действию фильтрации. | нет | |
| custom_topics | объект | Коллекция результатов фильтрации true/false для настроенных пользовательских разделов. | нет | |
| └️ подробности | массив | Пары идентификаторов отдельных разделов и их обнаружение. | нет | |
| └️ отфильтрован | булевый | Значение, указывающее, приводит ли любой из подробных разделов к действию фильтрации. | нет | |
| ошибка | объект | Если имеются, подробные сведения об ошибке, которая помешала завершить оценку фильтрации содержимого. | нет | |
| └─ Код | целое число | Отдельный удобочитаемый компьютером код, связанный с ошибкой. | нет | |
| Сообщение └️ | струна | Сообщение, доступное для чтения человеком, связанное с ошибкой. | нет | |
| hate | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| profanity | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли обнаружен контент и был ли отфильтрован содержимое. | нет | |
| └─ Обнаружено | булевый | Обнаружена ли в содержимом категория отмеченного контента. | нет | |
| └️ отфильтрован | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | нет | |
| код_защищённого_материала | объект | Результат обнаружения, описывающий совпадение с лицензированным кодом или другим защищенным исходным материалом. | нет | |
| └─ цитирование | объект | Если возможно, детали цитирования, описывающие связанную лицензию и место их расположения. | нет | |
| URL-адрес | струна | URL-адрес, связанный с лицензией. | нет | |
| Лицензия | струна | Имя или идентификатор лицензии, связанной с обнаружением. | нет | |
| └─ Обнаружено | булевый | Обнаружена ли в содержимом категория отмеченного контента. | нет | |
| └️ отфильтрован | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | нет | |
| защищённый_текст_материала | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли обнаружен контент и был ли отфильтрован содержимое. | нет | |
| └─ Обнаружено | булевый | Обнаружена ли в содержимом категория отмеченного контента. | нет | |
| └️ отфильтрован | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | нет | |
| самоповреждение | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| sexual | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| ungrounded_material | AzureContentFilterCompletionTextSpanDetectionResult | нет | ||
| violence | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет |
AzureContentFilterResultForPrompt
Результат фильтрации содержимого, связанный с одним элементом входного запроса в генеративную систему ИИ.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| результаты фильтрации контента | объект | Сведения о категории фильтрации содержимого для результата. | нет | |
| └─ настраиваемые черные списки | объект | Коллекция результатов фильтрации true/false для настроенных настраиваемых списков блокировок. | нет | |
| └️ подробности | массив | Пары отдельных идентификаторов черных списков и привели ли они к действию фильтрации. | нет | |
| └️ отфильтрован | булевый | Значение, указывающее, приводит ли любой из подробных списков блокировок к действию фильтрации. | нет | |
| └custom_topics | объект | Коллекция результатов фильтрации true/false для настроенных пользовательских разделов. | нет | |
| └️ подробности | массив | Пары идентификаторов отдельных разделов и их обнаружение. | нет | |
| └️ отфильтрован | булевый | Значение, указывающее, приводит ли любой из подробных разделов к действию фильтрации. | нет | |
| └─ Ошибка | объект | Если имеются, подробные сведения об ошибке, которая помешала завершить оценку фильтрации содержимого. | нет | |
| └─ Код | целое число | Отдельный удобочитаемый компьютером код, связанный с ошибкой. | нет | |
| Сообщение └️ | струна | Сообщение, доступное для чтения человеком, связанное с ошибкой. | нет | |
| └️ ненависть | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| └─ косвенная_атака | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли обнаружен контент и был ли отфильтрован содержимое. | нет | |
| └─ Обнаружено | булевый | Обнаружена ли в содержимом категория отмеченного контента. | нет | |
| └️ отфильтрован | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | нет | |
| └️ джейл-брейк | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли обнаружен контент и был ли отфильтрован содержимое. | нет | |
| └─ Обнаружено | булевый | Обнаружена ли в содержимом категория отмеченного контента. | нет | |
| └️ отфильтрован | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | нет | |
| └️ ненормативная лексика | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли обнаружен контент и был ли отфильтрован содержимое. | нет | |
| └─ Обнаружено | булевый | Обнаружена ли в содержимом категория отмеченного контента. | нет | |
| └️ отфильтрован | булевый | Приведет ли обнаружение содержимого к действию фильтрации содержимого. | нет | |
| └─ членовредительство | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| └️ сексуальный | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| └️ насилие | объект | Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории. | нет | |
| └️ отфильтрован | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | нет | |
| └─ серьезность | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
нет | |
| индекс_подсказки | целое число | Индекс входного запроса, связанного с сопутствующими категориями результатов фильтра содержимого. | нет |
AzureContentFilterSeverityResult
Элемент результата фильтра содержимого с метками, указывающий, был ли отфильтрован контент и какой уровень серьезности содержимого был оценен по конфигурации фильтра содержимого для категории.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| Фильтруется | булевый | Является ли серьезность содержимого результатом действия фильтрации содержимого. | Да | |
| severity | перечисление | Заданный уровень серьезности содержимого. Возможные значения: safe, , lowmediumhigh |
Да |
AzureCosmosDBChatDataSource
Представляет конфигурацию источника данных, которая будет использовать ресурс Azure CosmosDB.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| параметры | объект | Сведения о параметрах для управления использованием источника данных Azure CosmosDB. | Да | |
| └️ allow_partial_result | булевый | Если установлено значение true, система позволит использовать частичные результаты поиска, и запрос будет считаться неуспешным, если все частичные запросы окажутся неудачными. Если запрос не указан или указан как false, запрос завершится ошибкой, если любой поисковый запрос завершается ошибкой. | нет | Неправда |
| └─ проверка подлинности | AzureChatDataSourceConnectionStringAuthenticationOptions | нет | ||
| └️ container_name | струна | нет | ||
| └ «database_name» | струна | нет | ||
| └─ встраивание_зависимости | AzureChatDataSourceVectorizationSource | Представление источника векторизации данных, который можно использовать как ресурс внедрения с источником данных. | нет | |
| └─ сопоставление_полей | объект | нет | ||
| └─ поля_контента | массив | нет | ||
| └─content_fields_separator | струна | нет | ||
| └filepath_field | струна | нет | ||
| └─ название_поля | струна | нет | ||
| └─ поле_ссылки | струна | нет | ||
| └─ векторные_поля | массив | нет | ||
| └in_scope | булевый | Следует ли ограничить запросы использованием индексированных данных. | нет | |
| └─ включить_контексты | массив | Свойства контекста выходных данных, которые необходимо включить в ответ. По умолчанию запрашивается ссылка и намерение. |
нет | ['цитаты', 'намерение'] |
| └– index_name | струна | нет | ||
| └max_search_queries | целое число | Максимальное количество перезаписанных запросов, которые должны отправляться поставщику поиска для одного сообщения пользователя. По умолчанию система сделает автоматическое определение. |
нет | |
| └️ строгость | целое число | Настроенная строгость фильтрации релевантности поиска. Более строгие критерии увеличат точность, но снизят полноту ответа. |
нет | |
| └top_n_documents | целое число | Настроено количество документов, которые нужно выделить в запросе. | нет | |
| type | перечисление | Идентификатор различаемого типа, который всегда равен azure_cosmos_db. Возможные значения: azure_cosmos_db |
Да |
AzureCreateChatCompletionRequest
Модель расширенного запроса для завершения чата в Azure OpenAI service. Это добавляет возможность предоставлять источники данных для функции On Your Data.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| audio | объект | Параметры выходных данных звука. Требуется при запросе на вывод звука с modalities: ["audio"]. |
нет | |
| └─ Формат | перечисление | Указывает выходной формат звука. Должен быть одним из wav, mp3, flac, opus или pcm16.Возможные значения: wav, aac, mp3, flac, opus, pcm16 |
нет | |
| └️ голос | объект | нет | ||
| источники данных | массив | Источники данных, используемые для функции On Your Data, эксклюзивные для Azure OpenAI. | нет | |
| штраф за частоту | число/номер | Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры на основе их существующей частоты в тексте до сих пор, уменьшая вероятность повторения модели той же строки дословно. | нет | 0 |
| вызов_функции | перечисление | Указание определенной функции путем {"name": "my_function"} принудительного вызова этой функции моделью.Возможные значения: none, auto |
нет | |
| functions | массив | Не рекомендуется использовать в пользу tools.Список функций, для которые модель может создавать входные данные JSON. |
нет | |
| логит_биас | объект | Изменяет вероятность появления указанных маркеров в завершении. Принимает объект JSON, который сопоставляет маркеры (указанные идентификатором маркера в токенизаторе) со связанным значением предвзятости от -100 до 100. С математической точки зрения смещение добавляется к логитам, созданным моделью до выборки. Точный эффект зависит от модели, но значения от –1 до 1 должны уменьшать или увеличивать вероятность выбора; такие значения, как –100 или 100, должны приводить к запрету или эксклюзивному выбору соответствующего маркера. |
нет | None |
| logprobs | булевый | Следует ли возвращать вероятности журналов выходных маркеров или нет. Если значение true, возвращает вероятности журнала каждого выходного маркера, возвращаемого в параметре contentmessage. |
нет | Неправда |
| max_completion_tokens (максимальное количество токенов завершения) | целое число | Верхняя граница для числа маркеров, которые можно создать для завершения, включая видимые выходные маркеры и маркеры причин. | нет | |
| макс_токены | целое число | Максимальное количество маркеров, которые можно создать в завершении чата. Это значение можно использовать для управления затратами на текст, созданный с помощью API. Это значение теперь устарело, а предпочитается max_completion_tokens, и несовместимо с моделями серии o1. |
нет | |
| messages | массив | Список сообщений, составляющих беседу до сих пор. В зависимости от используемой модели поддерживаются различные типы сообщений (модальности), такие как текст, изображения и звук. | Да | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| Условия | объект | Типы выходных данных, которые вы хотите, чтобы модель генерировала. Большинство моделей могут создавать текст, который по умолчанию: ["text"]Модель gpt-4o-audio-preview также может использоваться для создания звука. Чтобы запросить, что эта модель создает как текстовые, так и звуковые ответы, можно использовать:["text", "audio"] |
нет | |
| модель | струна | Идентификатор развертывания модели, используемый для запроса завершения чата. | Да | |
| н | целое число | Сколько вариантов завершения чата для каждого входного сообщения. Обратите внимание, что плата будет взиматься на основе количества созданных маркеров во всех вариантах. Имейте в виду n , чтобы 1 свести к минимуму затраты. |
нет | 1 |
| вызовы инструмента в параллельном режиме | объект | Следует ли включить параллельные вызовы функций во время использования средства. | нет | |
| prediction | объект | Базовое представление прогнозируемых выходных данных модели. | нет | |
| └─ Тип | OpenAI.ChatOutputPredictionType | нет | ||
| штраф за присутствие | число/номер | Число от -2.0 до 2.0. Положительные значения наказывают новые маркеры в зависимости от того, появляются ли они в тексте до сих пор, что повышает вероятность того, что модель будет говорить о новых темах. | нет | 0 |
| усилия на рассуждение | объект |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
нет | |
| формат_ответа | объект | нет | ||
| └─ Тип | перечисление | Возможные значения: text, json_objectjson_schema |
нет | |
| seed | целое число | Эта функция доступна в бета-версии. Если задано, наша система будет предпринять лучшие усилия для выборки детерминированного, таким образом, что повторяющиеся запросы с одинаковыми и теми же параметрами должны возвращать тот же seed результат.Детерминированность не гарантируется, и вы должны ссылаться на system_fingerprint параметр ответа для отслеживания изменений в серверной части. |
нет | |
| stop | объект | Не поддерживается с последними моделями рассуждений o3 и o4-mini.До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры. Возвращенный текст не будет содержать последовательность остановки. |
нет | |
| store | булевый | Независимо от того, следует ли хранить результаты этого запроса на завершение чата для использования в дистилляции модели или продуктах оценки. | нет | Неправда |
| поток | булевый | Если задано значение true, данные ответа модели будут передаваться клиенту по мере его создания с помощью событий, отправляемых сервером. | нет | Неправда |
| stream_options | объект | Параметры потокового ответа. Этот параметр устанавливается только при установке stream: true. |
нет | |
| └️ include_usage | булевый | Если задано, перед сообщением будет передаваться data: [DONE] дополнительный блок. Поле usage на этом блоке отображает статистику использования маркеров для всего запроса, и choices поле всегда будет пустым массивом.Все остальные блоки также будут содержать usage поле, но со значением NULL.
ЗАМЕТКА: Если поток прерван, вы можете не получить последний блок данных об использовании, содержащий общие данные о количестве использованных токенов для запроса. |
нет | |
| Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | 1 |
| выбор инструмента | OpenAI.ChatCompletionToolChoiceOption | Определяет, какое средство (если таковое) вызывается моделью.none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.required означает, что модель должна вызывать один или несколько инструментов.Указание определенного средства с помощью {"type": "function", "function": {"name": "my_function"}} принудительного вызова этого средства моделью.none значение по умолчанию, если средства отсутствуют.
auto значение по умолчанию, если существуют средства. |
нет | |
| инструменты | массив | Список инструментов, которые может вызывать модель. В настоящее время в качестве инструмента поддерживаются только функции. Используйте это для предоставления списка функций, для которые модель может создавать входные данные JSON. Поддерживаются не более 128 функций. | нет | |
| top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | 1 |
| Пользователь | струна | Уникальный идентификатор, представляющий конечного пользователя, который может помочь в мониторинге и обнаружении злоупотреблений. | нет | |
| user_security_context | AzureUserSecurityContext | Контекст безопасности пользователя содержит несколько параметров, описывающих само приложение, и конечный пользователь, взаимодействующий с приложением. Эти поля помогают группам по операциям безопасности исследовать и устранять инциденты безопасности, предоставляя комплексный подход к защите приложений ИИ. Learn more о защите приложений ИИ с помощью Microsoft Defender for Cloud. | нет |
AzureCreateChatCompletionResponse
Расширенная модель ответа на завершение чата верхнего уровня для Azure OpenAI service. Эта модель добавляет аннотации на основе фильтрации содержимого для ответственного использования ИИ при вводе запросов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| choices | массив | Да | ||
| создано | целое число | Метка времени Unix (в секундах) при создании завершения чата. | Да | |
| id | струна | Уникальный идентификатор завершения чата. | Да | |
| модель | струна | Модель, используемая для завершения чата. | Да | |
| объект | перечисление | Тип объекта, который всегда chat.completionявляется .Возможные значения: chat.completion |
Да | |
| результаты_фильтрации_запросов | массив | Заметки фильтра содержимого ответственного искусственного интеллекта, связанные с вводом запроса в завершения чата. | нет | |
| системный отпечаток | струна | Этот отпечаток представляет конфигурацию серверной части, с которой работает модель. Можно использовать в сочетании с параметром seed запроса, чтобы понять, когда внутренние изменения были внесены, что может повлиять на детерминированность. |
нет | |
| использование | OpenAI.CompletionUsage | Статистика использования для запроса завершения. | нет |
AzureCreateChatCompletionStreamResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| choices | массив | Список вариантов завершения чата. Может содержать несколько элементов, если n больше 1. Может также быть пустым для последнего блока, если вы установите stream_options: {"include_usage": true}. |
Да | |
| результаты фильтрации контента | AzureContentFilterResultForChoice | Результат фильтра содержимого для одного элемента ответа, созданного системой создания искусственного интеллекта. | нет | |
| создано | целое число | Метка времени Unix (в секундах) при создании завершения чата. Каждый блок имеет одинаковую метку времени. | Да | |
| delta | AzureChatCompletionStreamResponseDelta | Модель расширенного ответа для ответа потокового чата в Azure OpenAI service. Эта модель добавляет поддержку контекста сообщения чата, используемого функцией On Your Data для намерений, ссылок и других сведений, связанных с получением дополненного поколения. |
нет | |
| id | струна | Уникальный идентификатор завершения чата. Каждый блок имеет один и тот же идентификатор. | Да | |
| модель | струна | Модель для создания завершения. | Да | |
| объект | перечисление | Тип объекта, который всегда chat.completion.chunkявляется .Возможные значения: chat.completion.chunk |
Да | |
| системный отпечаток | струна | Этот отпечаток представляет конфигурацию серверной части, с которой работает модель. Можно использовать в сочетании с параметром seed запроса, чтобы понять, когда внутренние изменения были внесены, что может повлиять на детерминированность. |
нет | |
| использование | объект | Статистика использования для запроса завершения. | нет | |
| └─ токены завершения | целое число | Количество маркеров в созданном завершении. | нет | 0 |
| └completion_tokens_details | объект | Разбивка маркеров, используемых в завершении. | нет | |
| └️ accepted_prediction_tokens | целое число | При использовании прогнозируемых выходных данных число маркеров в прогнозе, появившемся в завершении. | нет | 0 |
| └audio_tokens | целое число | Маркеры ввода звука, созданные моделью. | нет | 0 |
| └️ reasoning_tokens | целое число | Маркеры, созданные моделью для рассуждений. | нет | 0 |
| └─ отклонённые_токены_предсказания | целое число | При использовании прогнозируемых выходных данных число маркеров в прогнозе, которое не отображалось в завершении. Однако, как и маркеры причин, эти маркеры по-прежнему учитываются в общих маркерах завершения для целей выставления счетов, выходных данных и контекстного окна. | нет | 0 |
| └─ токены_запроса | целое число | Количество маркеров в запросе. | нет | 0 |
| └ prompt_tokens_details | объект | Разбивка токенов, используемых в запросе. | нет | |
| └audio_tokens | целое число | Маркеры ввода звука, представленные в запросе. | нет | 0 |
| └ cached_tokens | целое число | Кэшированные маркеры присутствуют в запросе. | нет | 0 |
| └️ всего_токенов | целое число | Общее количество маркеров, используемых в запросе (запрос + завершение). | нет | 0 |
AzureCreateEmbeddingRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| dimensions | целое число | Число измерений, в которых должны быть внедренные выходные данные. Поддерживается только в text-embedding-3 и более поздних моделях. |
нет | |
| формат_кодирования | перечисление | Формат, в который возвращаются встраиваемые элементы. Может быть либо float, либо base64.Возможные значения: float, base64 |
нет | |
| ввод | строка или массив | Да | ||
| модель | струна | Модель, используемая для запроса внедрения. | Да | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет |
AzureCreateFileRequestMultiPart
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| истекает через | объект | Да | ||
| Привязка └️ | AzureFileExpiryAnchor | нет | ||
| └= секунды | целое число | нет | ||
| файл | струна | Да | ||
| purpose | перечисление | Целевое назначение загружаемого файла. Одно из следующих: assistants — используется в API помощников, batch — используется в пакетном API, fine-tune — используется для точной настройки, evals — используется для наборов данных для оценки. Возможные значения: assistants, , batchfine-tuneevals |
Да |
AzureCreateImageEditRequestMultiPart
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | перечисление | Позволяет задать прозрачность фона созданных образов. Этот параметр поддерживается только для gpt-image-1моделей серии. Должно быть одним из значений transparentopaque или auto (значение по умолчанию). При auto использовании модель автоматически определяет лучший фон для изображения.Если transparentвыходной формат должен поддерживать прозрачность, поэтому он должен иметь значение png (значение по умолчанию) или webp.Возможные значения: transparent, opaqueauto |
нет | |
| image | строка или массив | Да | ||
| mask | струна | нет | ||
| модель | струна | Развертывание модели для использования в операции по редактированию изображения. | Да | |
| н | целое число | Количество генерируемых изображений. Должно быть от 1 до 10. | нет | 1 |
| сжатие вывода | целое число | Уровень сжатия (0–100%) для созданных образов. Этот параметр поддерживается только для gpt-image-1-серий моделей с webp или jpeg выходными форматами, и по умолчанию, 100. |
нет | 100 |
| формат_выходных_данных | перечисление | Формат, в котором возвращаются созданные изображения. Этот параметр поддерживается только для gpt-image-1моделей серии. Должно иметь один из типов png, jpeg или webp.Значение по умолчанию — png.Возможные значения: png, jpegwebp |
нет | |
| prompt | струна | Текстовое описание требуемых изображений. Максимальная длина — 1000 символов для dall-e-2gpt-image-1моделей серии и 32000 символов. |
Да | |
| качество | перечисление | Качество создаваемого изображения.
high, medium и low поддерживаются только для gpt-image-1моделей серии.
dall-e-2 поддерживает только standard качество. По умолчанию — auto.Возможные значения: standard, low, medium, high, auto |
нет | |
| формат_ответа | перечисление | Формат, в котором возвращаются созданные изображения. Должен быть одним из url или b64_json. URL-адреса действительны только в течение 60 минут после создания образа. Этот параметр поддерживается только для dall-e-2моделей серии , так как gpt-image-1всегда возвращает образы в кодировке Base64.Возможные значения: url, b64_json |
нет | |
| size | перечисление | Размер созданных изображений. Должен быть одним из 1024x1024, 1536x1024 (альбомная ориентация), 1024x1536 (книжная ориентация) или auto (значение по умолчанию) для моделей серии gpt-image-1, а также одно из 256x256, 512x512 или 1024x1024 для dall-e-2.Возможные значения: 256x256, 512x512, 1024x1024, 1536x1024, 1024x1536, auto |
нет | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет |
AzureCreateImageRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | перечисление | Позволяет задать прозрачность фона созданных образов. Этот параметр поддерживается только для gpt-image-1моделей серии. Должно быть одним из значений transparentopaque или auto (значение по умолчанию). При auto использовании модель автоматически определяет лучший фон для изображения.Если transparentвыходной формат должен поддерживать прозрачность, поэтому он должен иметь значение png (значение по умолчанию) или webp.Возможные значения: transparent, opaqueauto |
нет | |
| модель | струна | Развертывание модели, используемое для создания образа. | Да | |
| moderation | перечисление | Управление уровнем модерации содержимого для изображений, созданных моделями серии gpt-image-1.
low Для менее строгой фильтрации или auto (значения по умолчанию).Возможные значения: low, auto |
нет | |
| н | целое число | Количество генерируемых изображений. Должно быть от 1 до 10. Для dall-e-3 поддерживается только n=1. |
нет | 1 |
| сжатие вывода | целое число | Уровень сжатия (0–100%) для созданных образов. Этот параметр поддерживается только для gpt-image-1-серий моделей с webp или jpeg выходными форматами, и по умолчанию, 100. |
нет | 100 |
| формат_выходных_данных | перечисление | Формат, в котором возвращаются созданные изображения. Этот параметр поддерживается только для gpt-image-1моделей серии. Должно иметь один из типов png, jpeg или webp.Возможные значения: png, jpegwebp |
нет | |
| prompt | струна | Текстовое описание требуемых изображений. Максимальная длина — 32000 символов для gpt-image-1моделей серии, 1000 символов для dall-e-2 и 4000 символов.dall-e-3 |
Да | |
| качество | перечисление | Качество создаваемого изображения. - auto (значение по умолчанию) автоматически выбирает лучшее качество для данной модели.- high, medium и low поддерживаются для gpt-image-1моделей серии.- hd и standard поддерживаются для dall-e-3.- standard — единственный вариант для dall-e-2.Возможные значения: standard, hd, low, medium, high, auto |
нет | |
| формат_ответа | перечисление | Формат, в котором сгенерированные изображения с dall-e-2 и dall-e-3 возвращаются. Должен быть одним из url или b64_json. URL-адреса действительны только в течение 60 минут после создания образа. Этот параметр не поддерживается для gpt-image-1моделей серии, которые всегда возвращают образы в кодировке Base64.Возможные значения: url, b64_json |
нет | |
| size | перечисление | Размер созданных изображений. Должен быть одним из 1024x1024, 1536x1024 (альбомная), 1024x1536 (книжная) или auto (значение по умолчанию) для моделей серии gpt-image-1, одним из 256x256, 512x512, или 1024x1024 для dall-e-2, и одним из 1024x1024, 1792x1024 или 1024x1792 для dall-e-3.Возможные значения: auto, 1024x1024, 1536x1024, 1024x1536, 256x256, 512x512, 1792x1024, 1024x1792 |
нет | |
| стиль | перечисление | Стиль созданных изображений. Этот параметр поддерживается только для dall-e-3. Должен быть одним из vivid или natural. Яркость заставляет модель стремиться к созданию гипер-реальных и драматических изображений. Естественные свойства модели позволяют создавать более естественные, менее гипер-реалистичные изображения.Возможные значения: vivid, natural |
нет | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет |
AzureCreateResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| include | массив | Укажите дополнительные выходные данные для включения в ответ модели. В настоящее время поддерживаются следующие значения: - code_interpreter_call.outputs: включает выходные данные выполнения кода Python в элементах вызова средства интерпретатора.- computer_call_output.output.image_url: добавьте URL-адреса изображений из выходных данных компьютерного вызова.- file_search_call.results: включите результаты поиска вызова средства поиска файлов.- message.input_image.image_url: включите URL-адреса изображения из входного сообщения.- message.output_text.logprobs: включите журналы с сообщениями помощника.- reasoning.encrypted_content: включает зашифрованную версию токенов в элементах рассуждения на выходе. Это позволяет использовать элементы рассуждений в многоэтапных беседах при статическом использовании API ответов (например, если store параметр задан false, или когда организация зарегистрирована в программе нулевого хранения данных). |
нет | |
| ввод | строка или массив | нет | ||
| instructions | струна | Сообщение системы (или разработчика), вставленное в контекст модели. При использовании вместе с previous_response_id инструкциями из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах. |
нет | |
| max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| модель | струна | Развертывание модели, используемое для создания этого ответа. | Да | |
| вызовы инструмента в параллельном режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | нет | True |
| previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| prompt | объект | Ссылка на шаблон запроса и его переменные. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор используемого шаблона запроса. | нет | |
| Переменные └️ | OpenAI.ResponsePromptVariables | Необязательная карта значений для замены переменных в запросе. Значения подстановки могут быть строками или другими типами входных данных ответа, такими как изображения или файлы. | нет | |
| Версия └️ | струна | Необязательная версия шаблона запроса. | нет | |
| reasoning | объект |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| - усилия | OpenAI.ReasoningEffort |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
нет | |
| └─generate_summary | перечисление |
Не рекомендуется: используйте summary вместо этого.Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| └️ сводка | перечисление | Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| store | булевый | Следует ли хранить созданный ответ модели для последующего получения через API. | нет | True |
| поток | булевый | Если задано значение true, данные ответа модели будут передаваться клиенту по мере его создания с помощью событий, отправляемых сервером. | нет | Неправда |
| Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | 1 |
| текст | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| выбор инструмента | объект | Определяет, какое средство (если таковое) вызывается моделью.none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.required означает, что модель должна вызывать один или несколько инструментов. |
нет | |
| └─ Тип | OpenAI.ToolChoiceObjectType | Указывает, что модель должна использовать встроенное средство для создания ответа. | нет | |
| инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели, например поиск файлов. - Вызовы функций (пользовательские средства): функции, определенные вами, что позволяет модели вызывать собственный код. |
нет | |
| top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | 1 |
| truncation | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет |
AzureCreateSpeechRequestMultiPart
Представление параметров запроса, которые управляют поведением операции преобразования текста в речь.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | струна | Текст для создания аудио. Максимальная длина — 4096 символов. | Да | |
| instructions | струна | Управляйте голосом созданного звука с помощью дополнительных инструкций. Не работает с tts-1 или tts-1-hd. |
нет | |
| модель | струна | Модель, используемая для этого текстового запроса на речь. | Да | |
| формат_ответа | объект | Поддерживаемые форматы выходных данных звука для преобразования текста в речь. | нет | |
| speed | число/номер | Скорость речи для сгенерированного аудио. Значения допустимы в диапазоне от 0,25 до 4.0 с 1.0 по умолчанию и более высокими значениями, соответствующими более быстрой речи. | нет | 1 |
| stream_format | перечисление | Формат для потоковой передачи звука. Поддерживаемые форматы: sse и audio.
sse не поддерживается или tts-1tts-1-hdне поддерживается.Возможные значения: sse, audio |
нет | |
| голос | объект | Да |
AzureCreateTranscriptionRequestMultiPart
Сведения о конфигурации запроса транскрибирования звука.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| chunking_strategy | объект | нет | ||
| └prefix_padding_ms | целое число | Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). | нет | 300 |
| └─ длительность_тишины_мс | целое число | Длительность молчания для обнаружения остановки речи (в миллисекундах). С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя. |
нет | 200 |
| Пороговое значение └️ | число/номер | Порог чувствительности (от 0.0 до 1.0) для обнаружения голосовой активности. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах. | нет | 0,5 |
| └─ Тип | перечисление | Необходимо установить значение server_vad, чтобы включить ручное фрагментирование с использованием серверного VAD.Возможные значения: server_vad |
нет | |
| файл | струна | Да | ||
| filename | струна | Необязательный идентификатор файла или описательный идентификатор для связывания с звуковыми данными. | нет | |
| include[] | массив | Дополнительные сведения для добавления в ответ транскрипции.logprobs возвращает логарифмы вероятностей маркеров в ответе, чтобы понять достоверность модели в транскрипции.logprobs работает только с response_format, заданным на json, и только с моделями gpt-4o-transcribe, gpt-4o-transcribe-diarize, gpt-4o-mini-transcribe и gpt-4o-mini-transcribe-2025-12-15. |
нет | |
| язык | струна | Язык входного звука. Предоставление языка ввода в формате ISO-639-1 (например en, ) повышает точность и задержку. |
нет | |
| модель | струна | Модель, используемая для этого запроса транскрибирования. | нет | |
| prompt | струна | Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен соответствовать языку звука. | нет | |
| формат_ответа | объект | нет | ||
| поток | булевый | Если задано значение true, данные ответа модели будут передаваться клиенту по мере его создания с помощью событий, отправляемых сервером. Примечание. Потоковая передача не поддерживается для whisper-1 модели и будет игнорироваться. |
нет | Неправда |
| Температура | число/номер | Температура выборки от 0 до 1. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Если задано значение 0, модель будет использовать логарифмическую вероятность для автоматического повышения температуры до достижения определённых пороговых значений. | нет | 0 |
| timestamp_granularities[] | массив | Гранулярность метки времени для заполнения этой транскрибирования.
response_format необходимо задать verbose_json для использования детализации метки времени. Поддерживаются либо оба этих параметра: wordили segment. Примечание. Дополнительная задержка для меток времени сегмента отсутствует, но при создании меток времени слова возникает дополнительная задержка. |
нет | ['segment'] |
AzureCreateTranslationRequestMultiPart
Сведения о конфигурации запроса транскрибирования звука.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| файл | струна | Да | ||
| filename | струна | Необязательный идентификатор файла или описательный идентификатор для связи с звуковыми данными | нет | |
| модель | струна | Модель, используемая для этого запроса на перевод. | нет | |
| prompt | струна | Необязательный текст для руководства стилем модели или продолжением предыдущего сегмента звука. Запрос должен находиться на английском языке. | нет | |
| формат_ответа | объект | нет | ||
| Температура | число/номер | Температура выборки от 0 до 1. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Если задано значение 0, модель будет использовать логарифмическую вероятность для автоматического повышения температуры до достижения определённых пороговых значений. | нет | 0 |
Ответ об ошибке Azure
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ошибка | объект | Сведения об ошибке. | нет | |
| └─ Код | струна | Отдельный идентификатор, созданный компьютером для ошибки. | нет | |
| └─ внутренняя_ошибка | нет | |||
| Сообщение └️ | струна | Сообщение, доступное для чтения человеком, связанное с ошибкой. | нет | |
| └─ параметр | струна | Если применимо, входной параметр запроса, связанный с ошибкой | нет | |
| └─ Тип | перечисление | Тип объекта всегда "error". Возможные значения: error |
нет |
AzureEvalAPICompletionsSamplingParams
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| вызовы инструмента в параллельном режиме | булевый | нет | ||
| формат_ответа | OpenAI.ResponseTextFormatConfiguration | нет | ||
| инструменты | массив | нет |
AzureEvalAPIModelSamplingParams
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| макс_токены | целое число | Максимальное количество токенов в сгенерированном выводе. | нет | |
| усилия на рассуждение | перечисление | Управляет уровнем усилий, применяемых во время создания. Возможные значения: low, mediumhigh |
нет | |
| seed | целое число | Начальное значение для инициализации случайности во время выборки. | нет | |
| Температура | число/номер | Более высокая температура увеличивает случайность выходных данных. | нет | |
| top_p | число/номер | Альтернатива температуре для выборки ядра; 1.0 включает все маркеры. | нет |
AzureEvalAPIResponseSamplingParams
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| вызовы инструмента в параллельном режиме | булевый | нет | ||
| формат_ответа | OpenAI.ResponseTextFormatConfiguration | нет | ||
| инструменты | массив | нет |
AzureFileExpiryAnchor
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | created_at |
AzureFineTuneReinforcementMethod
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| грейдер | объект | Объект StringCheckGrader, выполняющий сравнение строк между входами и ссылкой с помощью указанной операции. | Да | |
| └calculate_output calculate_output | струна | Формула для вычисления выходных данных на основе результатов оценки. | нет | |
| └️ evaluation_metric | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
нет | |
| └️ классировщиков | объект | нет | ||
| └─ Входные данные | массив | Входной текст. Это может включать строки шаблона. | нет | |
| └─ Модель | струна | Модель, используемая для оценки. | нет | |
| └️ имя | струна | Имя классировщика. | нет | |
| Операция └️ | перечисление | Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.Возможные значения: eq, , nelikeilike |
нет | |
| Диапазон └️ | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| Справочник по └️ | струна | Текст, классируемый против. | нет | |
| └─sampling_params | Параметры выборки для модели. | нет | ||
| └─ Тип | перечисление | Тип объекта, который всегда multiявляется .Возможные значения: multi |
нет | |
| гиперпараметры | OpenAI.FineTuneReinforcementHyperparameters | Гиперпараметры, используемые для задания точной настройки с подкреплением. | нет | |
| формат_ответа | объект | нет | ||
| └json_schema | объект | Схема JSON для формата ответа | нет | |
| └─ Тип | перечисление | Тип формата ответа. Возможные значения: json_schema |
нет |
AzureImage
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| b64_json | струна | Кодированный в кодировке Base64 JSON созданного образа. Значение по умолчанию для моделей серии gpt-image-1, и только если response_format имеет значение b64_json для dall-e-2 и dall-e-3. |
нет | |
| результаты фильтрации контента | AzureContentFilterImageResponseResults | Результат фильтрации содержимого для вывода содержимого ответа операции генерации изображений. | Да | |
| результаты_фильтрации_запросов | AzureContentFilterImagePromptResults | Результат фильтра содержимого для содержимого входного запроса операции создания изображения. | Да | |
| пересмотренный_запрос | струна | Только dall-e-3 измененный запрос, который использовался для создания образа. |
нет | |
| URL-адрес | струна | При использовании dall-e-2 или dall-e-3URL-адрес созданного изображения, если response_format задано значение url (значение по умолчанию). Не поддерживается для моделей серии gpt-image-1. |
нет |
AzureImagesResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | перечисление | Фоновый параметр, используемый для создания образа.
transparent или opaque.Возможные значения: transparent, opaque |
нет | |
| создано | целое число | Метка времени Unix (в секундах) момента создания образа. | Да | |
| данные | массив | нет | ||
| формат_выходных_данных | перечисление | Выходной формат создания изображения. Возможные значения: png, webp или jpeg.Возможные значения: png, webpjpeg |
нет | |
| качество | перечисление | Качество созданного изображения. Возможные значения: low, medium или high.Возможные значения: low, mediumhigh |
нет | |
| size | перечисление | Размер созданного изображения. Возможные значения: 1024x1024, 1024x1536 или 1536x1024.Возможные значения: 1024x1024, 1024x15361536x1024 |
нет | |
| использование | объект | Только для моделей серии gpt-image-1: информация об использовании токенов для генерации изображений. |
нет | |
| └input_tokens | целое число | Количество токенов (изображений и текста) в входном запросе. | нет | |
| └─ данные_входных_токенов | объект | Подробные сведения о входных токенах для создания изображения. | нет | |
| └─image_tokens | целое число | Количество маркеров изображения во входной подсказке. | нет | |
| └️ текст_токены | целое число | Количество текстовых токенов в запросе ввода. | нет | |
| └─ выходные_токены (output_tokens) | целое число | Количество маркеров изображения в выходном изображении. | нет | |
| └️ всего_токенов | целое число | Общее количество маркеров (изображений и текста), используемых для создания изображения. | нет |
AzureListFilesResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Да | ||
| первый_идентификатор | струна | Да | ||
| есть_еще | булевый | Да | ||
| last_id | струна | Да | ||
| объект | перечисление | Возможные значения: list |
Да |
AzureOpenAIFile
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| байт | целое число | Размер файла в байтах. | Да | |
| создано_в | целое число | Метка времени Unix (в секундах) для момента создания файла. | Да | |
| срок_действия_до | целое число | Метка времени Unix (в секундах) для истечения срока действия файла. | нет | |
| filename | струна | Имя файла. | Да | |
| id | струна | Идентификатор файла, на который можно ссылаться в конечных точках API. | Да | |
| объект | перечисление | Тип объекта, который всегда fileявляется .Возможные значения: file |
Да | |
| purpose | перечисление | Предназначение файла. Поддерживаемые значения: assistants, , assistants_outputbatch, batch_outputfine-tuneи fine-tune-results.Возможные значения: assistants, , , assistants_outputbatchbatch_outputfine-tunefine-tune-resultsevals |
Да | |
| статус | перечисление | Возможные значения: uploaded, , , pendingrunningprocessederrordeletingdeleted |
Да | |
| подробности_статуса | струна | Устарело. Дополнительные сведения о том, почему сбой проверки файла обучения точной настройки см. в errorfine_tuning.jobполе . |
нет |
AzureOpenAIVideoGenerationErrorResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | струна | Отдельный идентификатор, созданный компьютером для ошибки. | нет | |
| внутренняя ошибка | объект | Если применимо, ошибкой, которая вызвала эту ошибку, является вышестоящая ошибка. | нет | |
| └─ Код | перечисление | Код, связанный с внутренней ошибкой. Возможные значения: ResponsibleAIPolicyViolation |
нет | |
| └─ детали ошибки | Сведения о результатах фильтра содержимого, связанные с внутренней ошибкой. | нет | ||
| └─ пересмотренный_запрос | струна | Если применимо, измененный запрос, используемый для генерации. | нет | |
| сообщение | струна | Сообщение, доступное для чтения человеком, связанное с ошибкой. | нет | |
| параметр | струна | Если применимо, входной параметр запроса, связанный с ошибкой | нет | |
| type | струна | Если применимо, номер строки ввода, связанный с ошибкой. | нет |
AzureResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| создано_в | целое число | Метка времени в формате Unix (в секундах), когда был создан этот ответ. | Да | |
| ошибка | объект | Объект ошибки, возвращаемый, когда модель не сможет создать ответ. | Да | |
| └─ Код | OpenAI.ResponseErrorCode | Код ошибки для ответа. | нет | |
| Сообщение └️ | струна | Описание ошибки, доступной для чтения человеком. | нет | |
| id | струна | Уникальный идентификатор для этого ответа. | Да | |
| incomplete_details | объект | Сведения о том, почему ответ неполный. | Да | |
| └─ Причина | перечисление | Причина, по которой ответ является неполным. Возможные значения: max_output_tokens, content_filter |
нет | |
| instructions | строка или массив | Да | ||
| max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| модель | струна | Модель, используемая для создания этого ответа. | Да | |
| объект | перечисление | Тип объекта этого ресурса — всегда установлено response.Возможные значения: response |
Да | |
| output | массив | Массив элементов контента, созданных моделью. — длина и порядок элементов в массиве output зависит от ответа модели.— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK. |
Да | |
| output_text | струна | Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.Поддерживается в пакетах SDK для Python и JavaScript. |
нет | |
| вызовы инструмента в параллельном режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | Да | True |
| previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| prompt | объект | Ссылка на шаблон запроса и его переменные. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор используемого шаблона запроса. | нет | |
| Переменные └️ | OpenAI.ResponsePromptVariables | Необязательная карта значений для замены переменных в запросе. Значения подстановки могут быть строками или другими типами входных данных ответа, такими как изображения или файлы. | нет | |
| Версия └️ | струна | Необязательная версия шаблона запроса. | нет | |
| reasoning | объект |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| - усилия | OpenAI.ReasoningEffort |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
нет | |
| └─generate_summary | перечисление |
Не рекомендуется: используйте summary вместо этого.Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| └️ сводка | перечисление | Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| статус | перечисление | Статус формирования ответа. Один из completed, failed, in_progress, cancelled, queued, incomplete или .Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete |
нет | |
| Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
Да | |
| текст | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| выбор инструмента | объект | Определяет, какое средство (если таковое) вызывается моделью.none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.required означает, что модель должна вызывать один или несколько инструментов. |
нет | |
| └─ Тип | OpenAI.ToolChoiceObjectType | Указывает, что модель должна использовать встроенное средство для создания ответа. | нет | |
| инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели. |
нет | |
| top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
Да | |
| truncation | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| использование | OpenAI.ResponseUsage | Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры. | нет | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | Да |
AzureSearchChatDataSource
Представляет конфигурацию источника данных, которая будет использовать ресурс поиска Azure.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| параметры | объект | Сведения о параметрах для управления использованием источника данных Azure поиска. | Да | |
| └️ allow_partial_result | булевый | Если установлено значение true, система позволит использовать частичные результаты поиска, и запрос будет считаться неуспешным, если все частичные запросы окажутся неудачными. Если запрос не указан или указан как false, запрос завершится ошибкой, если любой поисковый запрос завершается ошибкой. | нет | Неправда |
| └─ проверка подлинности | объект | нет | ||
| └─access_token | струна | нет | ||
| └─ Ключ | струна | нет | ||
| └managed_identity_resource_id | струна | нет | ||
| └─ Тип | перечисление | Возможные значения: access_token |
нет | |
| └─ встраивание_зависимости | объект | Представляет источник векторизации, который вызывает вызовы общедоступной службы к развертыванию модели внедрения openAI Azure. | нет | |
| └─ проверка подлинности | AzureChatDataSourceApiKeyAuthenticationOptions или AzureChatDataSourceAccessTokenAuthenticationOptions | Механизм аутентификации, используемый с источником векторизации, основанным на конечной точке. Проверка подлинности конечной точки поддерживает ключ API и механизмы маркеров access. |
нет | |
| └deployment_name deployment_name | струна | Модель встраивания, используемая для векторизации. Это развертывание должно существовать в том же Azure ресурсе OpenAI, что и развертывание модели, используемое для завершения чата. | нет | |
| Размеры | целое число | Количество измерений, запрашиваемых для эмбеддингов. Поддерживается только в моделях text-embedding-3 и более поздних версий. |
нет | |
| Конечная точка | струна | Указывает URL-адрес конечной точки ресурса, из которого должны быть получены внедренные модули. Он должен быть в формате: https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings. Параметр запроса версии API не разрешен. |
нет | |
| └─ Тип | перечисление | Идентификатор типа всегда "интегрированный" для этого типа источника векторизации. Возможные значения: integrated |
нет | |
| Конечная точка | струна | Абсолютный путь конечной точки для используемого ресурса поиска Azure. | нет | |
| └─ сопоставление_полей | объект | Сопоставления полей для использования с ресурсом поиска Azure. | нет | |
| └─ поля_контента | массив | Имена полей индекса, которые следует рассматривать как содержимое. | нет | |
| └─content_fields_separator | струна | Шаблон разделителя, который должны использовать поля содержимого. | нет | |
| └filepath_field | струна | Имя поля индекса, используемого в качестве файлового пути. | нет | |
| └️ image_vector_fields | массив | Имена полей, представляющих векторные данные изображения. | нет | |
| └─ название_поля | струна | Имя поля индекса, используемого в качестве заголовка. | нет | |
| └─ поле_ссылки | струна | Имя поля индекса, используемого в качестве URL-адреса. | нет | |
| └─ векторные_поля | массив | Имена полей, представляющих векторные данные. | нет | |
| └─ Фильтр | струна | Фильтр для применения к поиску. | нет | |
| └in_scope | булевый | Следует ли ограничить запросы использованием индексированных данных. | нет | |
| └─ включить_контексты | массив | Свойства контекста выходных данных, которые необходимо включить в ответ. По умолчанию запрашивается ссылка и намерение. |
нет | ['цитаты', 'намерение'] |
| └– index_name | струна | Имя используемого индекса, как указано в ресурсе поиска Azure. | нет | |
| └max_search_queries | целое число | Максимальное количество перезаписанных запросов, которые должны отправляться поставщику поиска для одного сообщения пользователя. По умолчанию система сделает автоматическое определение. |
нет | |
| └️ тип_запроса | перечисление | Тип запроса для используемого ресурса поиска Azure. Возможные значения: simple, semantic, vector, vector_simple_hybrid, vector_semantic_hybrid |
нет | |
| └─ семантическая_конфигурация | струна | Дополнительная семантическая конфигурация для запроса. | нет | |
| └️ строгость | целое число | Настроенная строгость фильтрации релевантности поиска. Более строгие критерии увеличат точность, но снизят полноту ответа. |
нет | |
| └top_n_documents | целое число | Настроено количество документов, которые нужно выделить в запросе. | нет | |
| type | перечисление | Идентификатор различаемого типа, который всегда равен "azure_search". Возможные значения: azure_search |
Да |
AzureUserSecurityContext
Контекст безопасности пользователя содержит несколько параметров, описывающих само приложение, и конечный пользователь, взаимодействующий с приложением. Эти поля помогают группам по операциям безопасности исследовать и устранять инциденты безопасности, предоставляя комплексный подход к защите приложений ИИ. Learn more о защите приложений ИИ с помощью Microsoft Defender for Cloud.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| application_name | струна | Имя приложения. Конфиденциальная личная информация не должна быть включена в это поле. | нет | |
| end_user_id | струна | Этот идентификатор — это идентификатор объекта пользователя Microsoft Entra ID (ранее Azure Active Directory), используемый для проверки подлинности конечных пользователей в созданном приложении ИИ. Конфиденциальная личная информация не должна быть включена в это поле. | нет | |
| end_user_tenant_id | струна | Идентификатор клиента Microsoft 365, к которому принадлежит конечный пользователь. Это необходимо, если созданное приложение искусственного интеллекта является мультитенантным. | нет | |
| source_ip | струна | Записывает IP-адрес исходного клиента. | нет |
ChatCompletionMessageToolCallsItem
Вызовы средства, созданные моделью, например вызовы функций.
Массив: OpenAI.ChatCompletionMessageToolCall
CreateVideoGenerationRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| height | целое число | Высота видео. Поддерживаются следующие измерения: 480x480, 854x480, 720x720, 1280x720, 1080x1080 и 1920x1080 в альбомной и книжной ориентации. | Да | |
| модель | струна | Имя развертывания, используемого для этого запроса. | Да | |
| n_seconds | целое число | Длительность задания создания видео. Должно быть от 1 до 20 секунд. | нет | 5 |
| n_variants | целое число | Количество видео для создания в качестве вариантов для этого задания. Значение должно находиться в диапазоне от 1 до 5. Меньшие размеры позволяют больше вариантов. | нет | 1 |
| prompt | струна | Запрос для задания создания видео. | Да | |
| Ширина | целое число | Ширина видео. Поддерживаются следующие измерения: 480x480, 854x480, 720x720, 1280x720, 1080x1080 и 1920x1080 в альбомной и книжной ориентации. | Да |
CreateVideoGenerationWithMediaRequestMultiPart
Свойства запроса задания создания видео с файлами мультимедиа.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| files | массив | Да | ||
| height | целое число | Высота видео. Поддерживаются следующие измерения: 480x480, 854x480, 720x720, 1280x720, 1080x1080 и 1920x1080 в альбомной и книжной ориентации. | Да | |
| inpaint_items | массив | Необязательные элементы для этого задания создания видео. | нет | |
| модель | струна | Имя развертывания, используемого для этого запроса. | Да | |
| n_seconds | целое число | Длительность задания создания видео. Должно быть от 1 до 20 секунд. | нет | 5 |
| n_variants | целое число | Количество видео для создания в качестве вариантов для этого задания. Значение должно находиться в диапазоне от 1 до 5. Меньшие размеры позволяют больше вариантов. | нет | 1 |
| prompt | струна | Запрос для задания создания видео. | Да | |
| Ширина | целое число | Ширина видео. Поддерживаются следующие измерения: 480x480, 854x480, 720x720, 1280x720, 1080x1080 и 1920x1080 в альбомной и книжной ориентации. | Да |
Обрезки
Границы обрезки для элемента инпакетирования. Это указывает область элемента мультимедиа, который следует использовать для вставки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| bottom_fraction | число/номер | Нижняя граница поля обрезки, указанная как доля высоты исходного элемента мультимедиа. Должно быть от 0.0 до 1.0. Используйте, например, 0,5 для половины высоты исходного элемента мультимедиа. | нет | 1 |
| left_fraction | число/номер | Левая граница поля обрезки, указанная как доля ширины исходного элемента мультимедиа. Должно быть от 0.0 до 1.0. Используйте, например, 0,5 для половины ширины исходного элемента мультимедиа. | нет | 0 |
| right_fraction | число/номер | Правая граница поля обрезки, указанная как доля ширины исходного элемента мультимедиа. Должно быть от 0.0 до 1.0. Используйте, например, 0,5 для половины ширины исходного элемента мультимедиа. | нет | 1 |
| top_fraction | число/номер | Верхняя граница поля обрезки, указанная как доля высоты исходного элемента мультимедиа. Должно быть от 0.0 до 1.0. Используйте, например, 0,5 для половины высоты исходного элемента мультимедиа. | нет | 0 |
ElasticsearchChatDataSource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| параметры | объект | Сведения о параметрах для управления использованием источника данных Elasticsearch. | Да | |
| └️ allow_partial_result | булевый | Если установлено значение true, система позволит использовать частичные результаты поиска, и запрос будет считаться неуспешным, если все частичные запросы окажутся неудачными. Если запрос не указан или указан как false, запрос завершится ошибкой, если любой поисковый запрос завершается ошибкой. | нет | Неправда |
| └─ проверка подлинности | объект | нет | ||
| └─encoded_api_key | струна | нет | ||
| └─ Ключ | струна | нет | ||
| └key_id | струна | нет | ||
| └─ Тип | перечисление | Возможные значения: encoded_api_key |
нет | |
| └─ встраивание_зависимости | AzureChatDataSourceVectorizationSource | Представление источника векторизации данных, который можно использовать как ресурс внедрения с источником данных. | нет | |
| Конечная точка | струна | нет | ||
| └─ сопоставление_полей | объект | нет | ||
| └─ поля_контента | массив | нет | ||
| └─content_fields_separator | струна | нет | ||
| └filepath_field | струна | нет | ||
| └─ название_поля | струна | нет | ||
| └─ поле_ссылки | струна | нет | ||
| └─ векторные_поля | массив | нет | ||
| └in_scope | булевый | Следует ли ограничить запросы использованием индексированных данных. | нет | |
| └─ включить_контексты | массив | Свойства контекста выходных данных, которые необходимо включить в ответ. По умолчанию запрашивается ссылка и намерение. |
нет | ['цитаты', 'намерение'] |
| └– index_name | струна | нет | ||
| └max_search_queries | целое число | Максимальное количество перезаписанных запросов, которые должны отправляться поставщику поиска для одного сообщения пользователя. По умолчанию система сделает автоматическое определение. |
нет | |
| └️ тип_запроса | перечисление | Возможные значения: simple, vector |
нет | |
| └️ строгость | целое число | Настроенная строгость фильтрации релевантности поиска. Более строгие критерии увеличат точность, но снизят полноту ответа. |
нет | |
| └top_n_documents | целое число | Настроено количество документов, которые нужно выделить в запросе. | нет | |
| type | перечисление | Идентификатор различаемого типа, который всегда — 'elasticsearch'. Возможные значения: elasticsearch |
Да |
InpaintItem
Элемент подкачений для задания создания видео. Это указывает элемент мультимедиа, который следует использовать для вставки в поколении видео.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| crop_bounds | объект | Границы обрезки для элемента инпакетирования. Это указывает область элемента мультимедиа, который следует использовать для вставки. |
нет | |
| └bottom_fraction | число/номер | Нижняя граница поля обрезки, указанная как доля высоты исходного элемента мультимедиа. Должно быть от 0.0 до 1.0. Используйте, например, 0,5 для половины высоты исходного элемента мультимедиа. | нет | 1 |
| └️ left_fraction | число/номер | Левая граница поля обрезки, указанная как доля ширины исходного элемента мультимедиа. Должно быть от 0.0 до 1.0. Используйте, например, 0,5 для половины ширины исходного элемента мультимедиа. | нет | 0 |
| └right_fraction | число/номер | Правая граница поля обрезки, указанная как доля ширины исходного элемента мультимедиа. Должно быть от 0.0 до 1.0. Используйте, например, 0,5 для половины ширины исходного элемента мультимедиа. | нет | 1 |
| └top_fraction | число/номер | Верхняя граница поля обрезки, указанная как доля высоты исходного элемента мультимедиа. Должно быть от 0.0 до 1.0. Используйте, например, 0,5 для половины высоты исходного элемента мультимедиа. | нет | 0 |
| file_name | струна | Имя файла элемента мультимедиа. Он должен соответствовать имени файла вложения в этом запросе. | Да | |
| frame_index | целое число | Индекс кадра для этого элемента мультимедиа. Это указывает начальный кадр в полученном созданном видео для этого элемента инпакетирования. | Да | 0 |
| type | объект | Тип элемента инпайтирования. | Да |
JobStatus
Состояние задания создания видео.
| Недвижимость | Ценность |
|---|---|
| Описание | Состояние задания создания видео. |
| Тип | струна |
| Значения | preprocessingqueuedrunningprocessingcancelledsucceededfailed |
MediaItemType
Тип элемента инпайтирования.
| Недвижимость | Ценность |
|---|---|
| Описание | Тип элемента инпайтирования. |
| Тип | струна |
| Значения | image |
MongoDBChatDataSource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| параметры | объект | Сведения о параметрах для управления использованием источника данных MongoDB. | Да | |
| └️ allow_partial_result | булевый | Если установлено значение true, система позволит использовать частичные результаты поиска, и запрос будет считаться неуспешным, если все частичные запросы окажутся неудачными. Если запрос не указан или указан как false, запрос завершится ошибкой, если любой поисковый запрос завершается ошибкой. | нет | Неправда |
| └app_name | струна | Имя приложения MongoDB. | нет | |
| └─ проверка подлинности | объект | нет | ||
| └─ Пароль | струна | нет | ||
| └─ Тип | перечисление | Возможные значения: username_and_password |
нет | |
| └️ имя пользователя | струна | нет | ||
| └─ имя_коллекции | струна | Имя коллекции MongoDB. | нет | |
| └ «database_name» | струна | Имя базы данных MongoDB. | нет | |
| └─ встраивание_зависимости | объект | Представляет источник векторизации, который вызывает вызовы общедоступной службы к развертыванию модели внедрения openAI Azure. | нет | |
| └─ проверка подлинности | AzureChatDataSourceApiKeyAuthenticationOptions или AzureChatDataSourceAccessTokenAuthenticationOptions | Механизм аутентификации, используемый с источником векторизации, основанным на конечной точке. Проверка подлинности конечной точки поддерживает ключ API и механизмы маркеров access. |
нет | |
| └deployment_name deployment_name | струна | Модель встраивания, используемая для векторизации. Это развертывание должно существовать в том же Azure ресурсе OpenAI, что и развертывание модели, используемое для завершения чата. | нет | |
| Размеры | целое число | Количество измерений, запрашиваемых для эмбеддингов. Поддерживается только в моделях text-embedding-3 и более поздних версий. |
нет | |
| Конечная точка | струна | Указывает URL-адрес конечной точки ресурса, из которого должны быть получены внедренные модули. Он должен быть в формате: https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings. Параметр запроса версии API не разрешен. |
нет | |
| └─ Тип | перечисление | Идентификатор типа, всегда «deployment_name» для этого источника данных векторизации. Возможные значения: deployment_name |
нет | |
| Конечная точка | струна | Имя конечной точки кластера MongoDB. | нет | |
| └─ сопоставление_полей | объект | Сопоставления полей для применения к данным, используемым источником данных MongoDB. Обратите внимание, что для MongoDB требуются сопоставления содержимого и векторных полей. |
нет | |
| └─ поля_контента | массив | нет | ||
| └─content_fields_separator | струна | нет | ||
| └filepath_field | струна | нет | ||
| └─ название_поля | струна | нет | ||
| └─ поле_ссылки | струна | нет | ||
| └─ векторные_поля | массив | нет | ||
| └in_scope | булевый | Следует ли ограничить запросы использованием индексированных данных. | нет | |
| └─ включить_контексты | массив | Свойства контекста выходных данных, которые необходимо включить в ответ. По умолчанию запрашивается ссылка и намерение. |
нет | ['цитаты', 'намерение'] |
| └– index_name | струна | Имя индекса MongoDB. | нет | |
| └max_search_queries | целое число | Максимальное количество перезаписанных запросов, которые должны отправляться поставщику поиска для одного сообщения пользователя. По умолчанию система сделает автоматическое определение. |
нет | |
| └️ строгость | целое число | Настроенная строгость фильтрации релевантности поиска. Более строгие критерии увеличат точность, но снизят полноту ответа. |
нет | |
| └top_n_documents | целое число | Настроено количество документов, которые нужно выделить в запросе. | нет | |
| type | перечисление | Идентификатор дискриминируемого типа, который всегда равен "mongo_db". Возможные значения: mongo_db |
Да |
OpenAI.Annotation
Дискриминатор для OpenAI.Annotation
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
file_citation |
OpenAI.AnnotationFileCitation |
url_citation |
OpenAI.AnnotationUrlCitation |
file_path |
OpenAI.AnnotationFilePath |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.AnnotationType | Да |
OpenAI.AnnotationFileCitation
Ссылка на файл.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| идентификатор_файла | струна | Идентификатор файла. | Да | |
| filename | струна | Имя файла, на который ссылается файл. | Да | |
| index | целое число | Индекс файла в списке файлов. | Да | |
| type | перечисление | Тип ссылки на файл. Всегда file_citation.Возможные значения: file_citation |
Да |
OpenAI.AnnotationFilePath
Путь к файлу.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| идентификатор_файла | струна | Идентификатор файла. | Да | |
| index | целое число | Индекс файла в списке файлов. | Да | |
| type | перечисление | Тип пути к файлу. Всегда file_path.Возможные значения: file_path |
Да |
OpenAI.AnnotationType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | file_citationurl_citationfile_pathcontainer_file_citation |
OpenAI.AnnotationUrlCitation
Ссылка на веб-ресурс, используемый для создания ответа модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| end_index | целое число | Индекс последнего символа ссылки URL-адреса в сообщении. | Да | |
| start_index | целое число | Индекс первого символа ссылки URL-адреса в сообщении. | Да | |
| title | струна | Заголовок веб-ресурса. | Да | |
| type | перечисление | Тип URL-ссылки. Всегда url_citation.Возможные значения: url_citation |
Да | |
| URL-адрес | струна | URL-адрес веб-ресурса. | Да |
OpenAI.ПримерноеМестоположение
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| city | струна | нет | ||
| country | струна | нет | ||
| region | струна | нет | ||
| timezone | струна | нет | ||
| type | перечисление | Возможные значения: approximate |
Да |
OpenAI.AudioResponseFormat
Формат выходных данных в одном из следующих параметров: json, , text, srtverbose_jsonили vtt. Для gpt-4o-transcribe, gpt-4o-transcribe-diarizeи gpt-4o-mini-transcribegpt-4o-mini-transcribe-2025-12-15. Единственным поддерживаемым форматом является json.
| Недвижимость | Ценность |
|---|---|
| Описание | Формат выходных данных в одном из следующих параметров: json, , text, srtverbose_jsonили vtt. Для gpt-4o-transcribe, gpt-4o-transcribe-diarizeи gpt-4o-mini-transcribegpt-4o-mini-transcribe-2025-12-15. Единственным поддерживаемым форматом является json. |
| Тип | струна |
| Значения | jsontextsrtverbose_jsonvtt |
OpenAI.AutoChunkingStrategyRequestParam
Стратегия по умолчанию. В настоящее время эта стратегия использует и max_chunk_size_tokens имеет значение 800chunk_overlap_tokens .400
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Всегда auto.Возможные значения: auto |
Да |
OpenAI.ChatCompletionFunctionCallOption
Указание определенной функции путем {"name": "my_function"} принудительного вызова этой функции моделью.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| имя | струна | Имя вызываемой функции. | Да |
OpenAI.ChatCompletionFunctions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| описание | струна | Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. | нет | |
| имя | струна | Имя вызываемой функции. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. | Да | |
| параметры | Параметры, которые принимают функции, описаны как объект схемы JSON. Дополнительные сведения о формате см. в справочнике по схеме JSON . Опущение parameters определяет функцию с пустым списком параметров. |
нет |
OpenAI.ChatCompletionMessageAudioChunk
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | струна | нет | ||
| срок_действия_до | целое число | нет | ||
| id | струна | нет | ||
| transcript | струна | нет |
OpenAI.ChatCompletionMessageToolCall
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| function | объект | Функция, вызываемая моделью. | Да | |
| └─ аргументы | струна | Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Обратите внимание, что модель не всегда создает допустимые json и может галлюцинировать параметры, не определенные схемой функции. Перед вызовом функции проверьте аргументы в коде. | нет | |
| └️ имя | струна | Имя вызываемой функции. | нет | |
| id | струна | Идентификатор вызова средства. | Да | |
| type | перечисление | Тип средства. В настоящее время поддерживается только function .Возможные значения: function |
Да |
OpenAI.ChatCompletionMessageToolCallChunk
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| function | объект | нет | ||
| └─ аргументы | струна | Аргументы, с которыми вызывается функция, как создается моделью в формате JSON. Обратите внимание, что модель не всегда создает допустимые json и может галлюцинировать параметры, не определенные схемой функции. Перед вызовом функции проверьте аргументы в коде. | нет | |
| └️ имя | струна | Имя вызываемой функции. | нет | |
| id | струна | Идентификатор вызова средства. | нет | |
| index | целое число | Да | ||
| type | перечисление | Тип средства. В настоящее время поддерживается только function .Возможные значения: function |
нет |
OpenAI.ChatCompletionNamedToolChoice
Указывает средство, которое должна использовать модель. Используется для принудительного вызова определенной функции.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| function | объект | Да | ||
| └️ имя | струна | Имя вызываемой функции. | нет | |
| type | перечисление | Тип средства. В настоящее время поддерживается только function .Возможные значения: function |
Да |
OpenAI.ChatCompletionRequestAssistantMessage
Сообщения, отправленные моделью в ответ на сообщения пользователя.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| audio | объект | Данные о предыдущем звуковом ответе модели. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор предыдущего звукового ответа модели. | нет | |
| содержимое | строка или массив | нет | ||
| вызов_функции | объект | Устаревшие и замененные tool_calls. Имя и аргументы вызываемой функции, созданной моделью. |
нет | |
| └─ аргументы | струна | нет | ||
| └️ имя | струна | нет | ||
| имя | струна | Необязательное имя участника. Предоставляет сведения о модели, чтобы различать участников одной роли. | нет | |
| отказ | струна | Сообщение об отказе помощником. | нет | |
| роль | перечисление | Роль автора сообщений в данном случае assistant.Возможные значения: assistant |
Да | |
| вызовы инструментов | ChatCompletionMessageToolCallsItem | Вызовы средства, созданные моделью, например вызовы функций. | нет |
OpenAI.ChatCompletionRequestAssistantMessageContentPart
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| отказ | струна | Сообщение об отказе, созданное моделью. | Да | |
| текст | струна | Текстовое содержимое. | Да | |
| type | перечисление | Тип части содержимого. Возможные значения: refusal |
Да |
OpenAI.ChatCompletionRequestDeveloperMessage
Предоставленные разработчиком инструкции по выполнению модели независимо от сообщений, отправляемых пользователем. При использовании моделей o1 и более поздних developer версий сообщения заменяют предыдущие system сообщения.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | строка или массив | Да | ||
| имя | струна | Необязательное имя участника. Предоставляет сведения о модели, чтобы различать участников одной роли. | нет | |
| роль | перечисление | Роль автора сообщений в данном случае developer.Возможные значения: developer |
Да |
OpenAI.ChatCompletionRequestFunctionMessage
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | струна | Содержимое сообщения функции. | Да | |
| имя | струна | Имя вызываемой функции. | Да | |
| роль | перечисление | Роль автора сообщений в данном случае function.Возможные значения: function |
Да |
OpenAI.ChatCompletionRequestMessage
Дискриминатор для OpenAI.ChatCompletionRequestMessage
Этот компонент использует свойство role для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
system |
OpenAI.ChatCompletionRequestSystemMessage |
developer |
OpenAI.ChatCompletionRequestDeveloperMessage |
user |
OpenAI.ChatCompletionRequestUserMessage |
assistant |
OpenAI.ChatCompletionRequestAssistantMessage |
tool |
OpenAI.ChatCompletionRequestToolMessage |
function |
OpenAI.ChatCompletionRequestFunctionMessage |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | строка или массив | нет | ||
| роль | объект | Роль автора сообщения | Да |
OpenAI.ChatCompletionRequestMessageContentPart
Дискриминатор для OpenAI.ChatCompletionRequestMessageContentPart
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
text |
OpenAI.ChatCompletionRequestMessageContentPartText |
image_url |
OpenAI.ChatCompletionRequestMessageContentPartImage |
refusal |
OpenAI.ChatCompletionRequestMessageContentPartRefusal |
file |
OpenAI.ChatCompletionRequestMessageContentPartFile |
input_audio |
OpenAI.ChatCompletionRequestMessageContentPartAudio |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ChatCompletionRequestMessageContentPartType | Да |
OpenAI.ChatCompletionRequestMessageContentPartAudio
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| input_audio | объект | Да | ||
| └─ Данные | струна | Звуковые данные в кодировке Base64. | нет | |
| └─ Формат | перечисление | Формат закодированных звуковых данных. В настоящее время поддерживается wav и mp3. Возможные значения: wav, mp3 |
нет | |
| type | перечисление | Тип части содержимого. Всегда input_audio.Возможные значения: input_audio |
Да |
OpenAI.ChatCompletionRequestMessageContentPartFile
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| файл | объект | Да | ||
| └ file_data | струна | Данные файла, кодированные в формате Base64, используемые при передаче файла в модель в виде текстовой строки. | нет | |
| └ file_id | струна | Идентификатор отправленного файла, который будет использоваться в качестве входных данных. | нет | |
| └️ имя файла | струна | Имя файла, используемое при передаче файла в модель в виде строки. | нет | |
| type | перечисление | Тип части содержимого. Всегда file.Возможные значения: file |
Да |
OpenAI.ChatCompletionRequestMessageContentPartImage
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ссылка_на_изображение | объект | Да | ||
| └️ подробные сведения | перечисление | Указывает уровень детализации изображения. Возможные значения: auto, lowhigh |
нет | |
| └─ URL | струна | URL-адрес изображения или данных в кодировке Base64. | нет | |
| type | перечисление | Тип части содержимого. Возможные значения: image_url |
Да |
OpenAI.ChatCompletionRequestMessageContentPartRefusal
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| отказ | струна | Сообщение об отказе, созданное моделью. | Да | |
| type | перечисление | Тип части содержимого. Возможные значения: refusal |
Да |
OpenAI.ChatCompletionRequestMessageContentPartText
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| текст | струна | Текстовое содержимое. | Да | |
| type | перечисление | Тип части содержимого. Возможные значения: text |
Да |
OpenAI.ChatCompletionRequestMessageContentPartType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | textfileinput_audioimage_urlrefusal |
OpenAI.ChatCompletionRequestSystemMessage
Предоставленные разработчиком инструкции по выполнению модели независимо от сообщений, отправляемых пользователем. С моделями o1 и более новых версий вместо этого используйте developer сообщения для этой цели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | строка или массив | Да | ||
| имя | струна | Необязательное имя участника. Предоставляет сведения о модели, чтобы различать участников одной роли. | нет | |
| роль | перечисление | Роль автора сообщений в данном случае system.Возможные значения: system |
Да |
OpenAI.ChatCompletionRequestSystemMessageContentPart
Ссылки: OpenAI.ChatCompletionRequestMessageContentPartText
OpenAI.ChatCompletionRequestToolMessage
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | строка или массив | Да | ||
| роль | перечисление | Роль автора сообщений в данном случае tool.Возможные значения: tool |
Да | |
| идентификатор вызова инструмента | струна | Вызов средства, на который отвечает это сообщение. | Да |
OpenAI.ChatCompletionRequestToolMessageContentPart
Ссылки: OpenAI.ChatCompletionRequestMessageContentPartText
OpenAI.ChatCompletionRequestUserMessage
Сообщения, отправленные конечным пользователем, содержащие запросы или дополнительные сведения о контексте.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | строка или массив | Да | ||
| имя | струна | Необязательное имя участника. Предоставляет сведения о модели, чтобы различать участников одной роли. | нет | |
| роль | перечисление | Роль автора сообщений в данном случае user.Возможные значения: user |
Да |
OpenAI.ChatCompletionRequestUserMessageContentPart
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| файл | объект | Да | ||
| └ file_data | струна | Данные файла, кодированные в формате Base64, используемые при передаче файла в модель в виде текстовой строки. | нет | |
| └ file_id | струна | Идентификатор отправленного файла, который будет использоваться в качестве входных данных. | нет | |
| └️ имя файла | струна | Имя файла, используемое при передаче файла в модель в виде строки. | нет | |
| ссылка_на_изображение | объект | Да | ||
| └️ подробные сведения | перечисление | Указывает уровень детализации изображения. Возможные значения: auto, lowhigh |
нет | |
| └─ URL | струна | URL-адрес изображения или данных в кодировке Base64. | нет | |
| input_audio | объект | Да | ||
| └─ Данные | струна | Звуковые данные в кодировке Base64. | нет | |
| └─ Формат | перечисление | Формат закодированных звуковых данных. В настоящее время поддерживается wav и mp3. Возможные значения: wav, mp3 |
нет | |
| текст | струна | Текстовое содержимое. | Да | |
| type | перечисление | Тип части содержимого. Всегда file.Возможные значения: file |
Да |
OpenAI.ChatCompletionRole
Роль автора сообщения
| Недвижимость | Ценность |
|---|---|
| Описание | Роль автора сообщения |
| Тип | струна |
| Значения | systemdeveloperuserassistanttoolfunction |
OpenAI.ChatCompletionStreamOptions
Параметры потокового ответа. Этот параметр устанавливается только при установке stream: true.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| включить_использование | булевый | Если задано, перед сообщением будет передаваться data: [DONE] дополнительный блок. Поле usage на этом блоке отображает статистику использования маркеров для всего запроса, и choices поле всегда будет пустым массивом.Все остальные блоки также будут содержать usage поле, но со значением NULL.
ЗАМЕТКА: Если поток прерван, вы можете не получить последний блок данных об использовании, содержащий общие данные о количестве использованных токенов для запроса. |
нет |
OpenAI.ChatCompletionStreamResponseDelta
Разностное завершение чата, созданное потоковой передачей ответов модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| audio | объект | нет | ||
| └─ Данные | струна | нет | ||
| └ истекает_в | целое число | нет | ||
| Идентификатор └️ | струна | нет | ||
| └─ Расшифровка | струна | нет | ||
| содержимое | струна | Содержимое сообщения блока. | нет | |
| вызов_функции | объект | Устаревшие и замененные tool_calls. Имя и аргументы вызываемой функции, созданной моделью. |
нет | |
| └─ аргументы | струна | нет | ||
| └️ имя | струна | нет | ||
| отказ | струна | Сообщение об отказе, созданное моделью. | нет | |
| роль | объект | Роль автора сообщения | нет | |
| вызовы инструментов | массив | нет |
OpenAI.ChatCompletionTokenLogprob
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| байт | массив | Список целых чисел, представляющих представление маркера UTF-8 байт. Полезно в случаях, когда символы представлены несколькими токенами, а их байтовые представления должны объединяться для создания правильного текстового представления. Может быть null , если для маркера нет представления байтов. |
Да | |
| logprob | число/номер | Вероятность этого маркера журнала, если она находится в пределах 20 наиболее вероятных маркеров. В противном случае значение -9999.0 используется для обозначения того, что маркер очень маловероятно. |
Да | |
| token | струна | Маркер. | Да | |
| top_logprobs | массив | Список наиболее вероятных маркеров и их вероятности журналов в этой позиции маркера. В редких случаях количество запрошенных top_logprobs возвращаемых данных может быть меньше. |
Да |
Инструмент завершения чата OpenAI
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| function | OpenAI.FunctionObject | Да | ||
| type | перечисление | Тип средства. В настоящее время поддерживается только function .Возможные значения: function |
Да |
OpenAI.ChatCompletionToolChoiceOption
Определяет, какое средство (если таковое) вызывается моделью.
none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.
auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.
required означает, что модель должна вызывать один или несколько инструментов.
Указание определенного средства с помощью {"type": "function", "function": {"name": "my_function"}} принудительного вызова этого средства моделью.
none значение по умолчанию, если средства отсутствуют.
auto значение по умолчанию, если существуют средства.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| function | объект | Да | ||
| └️ имя | струна | Имя вызываемой функции. | нет | |
| type | перечисление | Тип средства. В настоящее время поддерживается только function .Возможные значения: function |
Да |
OpenAI.ChatOutputPrediction
Базовое представление прогнозируемых выходных данных модели.
Дискриминатор для OpenAI.ChatOutputPrediction
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
content |
OpenAI.ChatOutputPredictionContent |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ChatOutputPredictionType | Да |
OpenAI.ChatOutputPredictionContent
Статическое прогнозируемое выходное содержимое, например содержимое создаваемого текстового файла.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | строка или массив | Да | ||
| type | перечисление | Тип прогнозируемого содержимого, который требуется предоставить. Этот тип в настоящее время всегда content.Возможные значения: content |
Да |
OpenAI.ChatOutputPredictionType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | content |
OpenAI.ChunkingStrategyRequestParam
Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto .
Дискриминация для OpenAI.ChunkingStrategyRequestParam
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
static |
OpenAI.StaticChunkingStrategyRequestParam |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Тип стратегии блокирования. Возможные значения: auto, static |
Да |
OpenAI.ChunkingStrategyResponseParam
Дискриминация для OpenAI.ChunkingStrategyResponseParam
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
other |
OpenAI.OtherChunkingStrategyResponseParam |
static |
OpenAI.StaticChunkingStrategyResponseParam |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: static, other |
Да |
OpenAI.CodeInterpreterOutput
Дискриминация для OpenAI.CodeInterpreterOutput
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
image |
OpenAI.CodeInterpreterOutputImage |
logs |
OpenAI.CodeInterpreterOutputLogs |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.CodeInterpreterOutputType | Да |
OpenAI.CodeInterpreterOutputImage
Выходные данные изображения интерпретатора кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Тип выходных данных. Всегда "изображение". Возможные значения: image |
Да | |
| URL-адрес | струна | URL-адрес выходных данных изображения из интерпретатора кода. | Да |
OpenAI.CodeInterpreterOutputLogs
Журналы, выходные данные интерпретатора кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| logs | струна | Журналы, выходные данные интерпретатора кода. | Да | |
| type | перечисление | Тип выходных данных. Всегда "журналы". Возможные значения: logs |
Да |
OpenAI.CodeInterpreterOutputType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | logsimage |
OpenAI.CodeInterpreterTool
Средство, которое запускает код Python для создания ответа на запрос.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| container | объект | Настройка контейнера интерпретатора кода. При необходимости укажите идентификаторы файлов для запуска кода. | Да | |
| └ file_ids | массив | Необязательный список загруженных файлов для использования в вашем коде. | нет | |
| └─ Тип | перечисление | Всегда auto.Возможные значения: auto |
нет | |
| type | перечисление | Тип средства интерпретатора кода. Всегда code_interpreter.Возможные значения: code_interpreter |
Да |
OpenAI.CodeInterpreterToolAuto
Настройка контейнера интерпретатора кода. При необходимости укажите идентификаторы файлов для запуска кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| идентификаторы_файлов | массив | Необязательный список загруженных файлов для использования в вашем коде. | нет | |
| type | перечисление | Всегда auto.Возможные значения: auto |
Да |
OpenAI.CodeInterpreterToolCallItemParam
Вызов инструмента для выполнения кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | струна | Код для запуска или null, если он недоступен. | Да | |
| container_id | струна | Идентификатор контейнера, используемого для запуска кода. | Да | |
| выходные данные | массив | Выходные данные, созданные интерпретатором кода, такими как журналы или изображения. Может иметь значение NULL, если выходные данные недоступны. |
Да | |
| type | перечисление | Возможные значения: code_interpreter_call |
Да |
OpenAI.CodeInterpreterToolCallItemResource
Вызов инструмента для выполнения кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | струна | Код для запуска или null, если он недоступен. | Да | |
| container_id | струна | Идентификатор контейнера, используемого для запуска кода. | Да | |
| выходные данные | массив | Выходные данные, созданные интерпретатором кода, такими как журналы или изображения. Может иметь значение NULL, если выходные данные недоступны. |
Да | |
| статус | перечисление | Возможные значения: in_progress, completed, incomplete, interpreting, failed |
Да | |
| type | перечисление | Возможные значения: code_interpreter_call |
Да |
OpenAI.ComparisonFilter (фильтр сравнения)
Фильтр, используемый для сравнения указанного ключа атрибута с заданным значением с помощью определенной операции сравнения.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ключ | струна | Ключ для сопоставления со значением. | Да | |
| type | перечисление | Указывает оператор сравнения: eq, ne, gt, gte, lt. lte- eq: Равно- ne: не равно- gt: больше чем- gte: больше или равно- lt:Менее- lte: меньше или равно.Возможные значения: eq, ne, gt, gte, lt, lte |
Да | |
| value | строка или число или логическое значение | Да |
OpenAI.CompletionUsage
Статистика использования для запроса завершения.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| токены завершения | целое число | Количество маркеров в созданном завершении. | Да | 0 |
| детали_токенов_завершения | объект | Разбивка маркеров, используемых в завершении. | нет | |
| └️ accepted_prediction_tokens | целое число | При использовании прогнозируемых выходных данных число маркеров в прогнозе, появившемся в завершении. | нет | 0 |
| └audio_tokens | целое число | Маркеры ввода звука, созданные моделью. | нет | 0 |
| └️ reasoning_tokens | целое число | Маркеры, созданные моделью для рассуждений. | нет | 0 |
| └─ отклонённые_токены_предсказания | целое число | При использовании прогнозируемых выходных данных число маркеров в прогнозе, которое не отображалось в завершении. Однако, как и маркеры причин, эти маркеры по-прежнему учитываются в общих маркерах завершения для целей выставления счетов, выходных данных и контекстного окна. | нет | 0 |
| подсказывающие токены | целое число | Количество маркеров в запросе. | Да | 0 |
| prompt_tokens_details | объект | Разбивка токенов, используемых в запросе. | нет | |
| └audio_tokens | целое число | Маркеры ввода звука, представленные в запросе. | нет | 0 |
| └ cached_tokens | целое число | Кэшированные маркеры присутствуют в запросе. | нет | 0 |
| общее количество токенов | целое число | Общее количество маркеров, используемых в запросе (запрос + завершение). | Да | 0 |
OpenAI.CompoundFilter
Объединение нескольких фильтров с помощью and или or.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| filters | массив | Массив фильтров для объединения. Элементы могут быть ComparisonFilter или CompoundFilter. |
Да | |
| type | перечисление | Тип операции: and или or.Возможные значения: and, or |
Да |
OpenAI.ComputerAction
Дискриминатор для OpenAI.ComputerAction
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
click |
OpenAI.ComputerActionClick |
double_click |
OpenAI.ComputerActionDoubleClick |
drag |
OpenAI.ComputerActionDrag |
move |
OpenAI.ComputerActionMove |
screenshot |
OpenAI.ComputerActionScreenshot |
scroll |
OpenAI.ComputerActionScroll |
type |
OpenAI.ComputerActionTypeKeys |
wait |
OpenAI.ComputerActionWait |
keypress |
OpenAI.ComputerActionKeyPress |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ComputerActionType | Да |
OpenAI.ComputerActionClick
Действие щелчка.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| button | перечисление | Указывает, какая кнопка мыши была нажата во время нажатия кнопки. Одно из значений left, right, wheel, back или forward.Возможные значения: left, right, wheel, back, forward |
Да | |
| type | перечисление | Указывает тип события. Для действия щелчка это свойство всегда имеет значение click.Возможные значения: click |
Да | |
| x | целое число | Координата x, в которой произошло нажатие. | Да | |
| и | целое число | Координата y, в которой произошло нажатие. | Да |
OpenAI.ComputerActionDoubleClick
Действие двойного щелчка.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Указывает тип события. Для действия двойного щелчка это свойство всегда имеет значение double_click.Возможные значения: double_click |
Да | |
| x | целое число | Координата x, в которой произошло двойное щелчко. | Да | |
| и | целое число | Координата y, в которой произошло двойное щелчко. | Да |
OpenAI.ComputerActionDrag
Действие перетаскивания.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| путь | массив | Массив координат, представляющий путь действия перетаскивания. Координаты будут отображаться в виде массива объектов, например{ x: 100, y: 200 }, { x: 200, y: 300 } |
Да | |
| type | перечисление | Указывает тип события. Для действия перетаскивания это свойство всегда имеет значение drag.Возможные значения: drag |
Да |
OpenAI.ComputerActionKeyPress
Коллекция нажатий клавиш, которые модель хотела бы выполнить.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ключи | массив | Сочетание клавиш, которые модель просит нажать. Это массив строк, каждый из которых представляет ключ. | Да | |
| type | перечисление | Указывает тип события. Для действия keypress это свойство всегда имеет значение keypress.Возможные значения: keypress |
Да |
OpenAI.ComputerActionMove
Операция перемещения мыши.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Указывает тип события. Для действия перемещения это свойство всегда имеет значение move.Возможные значения: move |
Да | |
| x | целое число | Координата x, к которой происходит движение. | Да | |
| и | целое число | Координата y, куда необходимо переместиться. | Да |
OpenAI.ComputerActionScreenshot
Действие с снимком экрана.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Указывает тип события. Для действия с снимка экрана это свойство всегда имеет значение screenshot.Возможные значения: screenshot |
Да |
OpenAI.ComputerActionScroll
Действие прокрутки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| scroll_x | целое число | Расстояние горизонтальной прокрутки. | Да | |
| scroll_y | целое число | Расстояние вертикальной прокрутки. | Да | |
| type | перечисление | Указывает тип события. Для действия прокрутки это свойство всегда имеет значение scroll.Возможные значения: scroll |
Да | |
| x | целое число | Координата x, в которой произошла прокрутка. | Да | |
| и | целое число | Координата y, в которой произошла прокрутка. | Да |
OpenAI.ComputerActionType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | screenshotclickdouble_clickscrolltypewaitkeypressdragmove |
OpenAI.ComputerActionTypeKeys
Действие для ввода текста.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| текст | струна | Текст для набора. | Да | |
| type | перечисление | Указывает тип события. Для действия типа это свойство всегда имеет значение type.Возможные значения: type |
Да |
OpenAI.ComputerActionWait
Действие ожидания.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Указывает тип события. Для действия ожидания это свойство всегда имеет значение wait.Возможные значения: wait |
Да |
OpenAI.ComputerToolCallItemParam
Вызов инструмента для работы с компьютером.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| действие | OpenAI.ComputerAction | Да | ||
| call_id | струна | Идентификатор, используемый при реагировании на вызов инструмента с выходными данными. | Да | |
| pending_safety_checks | массив | Ожидающие проверки безопасности для компьютеризированного процесса. | Да | |
| type | перечисление | Возможные значения: computer_call |
Да |
OpenAI.ComputerToolCallItemResource
Вызов инструмента для работы с компьютером.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| действие | OpenAI.ComputerAction | Да | ||
| call_id | струна | Идентификатор, используемый при реагировании на вызов инструмента с выходными данными. | Да | |
| pending_safety_checks | массив | Ожидающие проверки безопасности для компьютеризированного процесса. | Да | |
| статус | перечисление | Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.Возможные значения: in_progress, completedincomplete |
Да | |
| type | перечисление | Возможные значения: computer_call |
Да |
OpenAI.ComputerToolCallOutputItemOutput
Дискриминатор для OpenAI.ComputerToolCallOutputItemOutput
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
computer_screenshot |
OpenAI.ComputerToolCallOutputItemOutputComputerScreenshot |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ComputerToolCallOutputItemOutputType | Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера. | Да |
OpenAI.ComputerToolCallOutputItemOutputComputerScreenshot
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| идентификатор_файла | струна | нет | ||
| ссылка_на_изображение | струна | нет | ||
| type | перечисление | Возможные значения: computer_screenshot |
Да |
OpenAI.ComputerToolCallOutputItemOutputType
Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера.
| Недвижимость | Ценность |
|---|---|
| Описание | Снимок экрана компьютера, используемый с помощью инструмента для использования компьютера. |
| Тип | струна |
| Значения | computer_screenshot |
OpenAI.ComputerToolCallOutputItemParam
Выходные данные запуска компьютерного инструмента.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| acknowledged_safety_checks | массив | API сообщила о проверках безопасности, которые были подтверждены разработчиком. | нет | |
| call_id | струна | Идентификатор вызова средства компьютера, создающего выходные данные. | Да | |
| output | OpenAI.ComputerToolCallOutputItemOutput | Да | ||
| type | перечисление | Возможные значения: computer_call_output |
Да |
OpenAI.ComputerToolCallOutputItemResource
Выходные данные запуска компьютерного инструмента.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| acknowledged_safety_checks | массив | API сообщила о проверках безопасности, которые были подтверждены разработчиком. | нет | |
| call_id | струна | Идентификатор вызова средства компьютера, создающего выходные данные. | Да | |
| output | OpenAI.ComputerToolCallOutputItemOutput | Да | ||
| статус | перечисление | Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.Возможные значения: in_progress, completedincomplete |
Да | |
| type | перечисление | Возможные значения: computer_call_output |
Да |
OpenAI.ComputerToolCallSafetyCheck
Ожидается проверка безопасности для компьютерного вызова.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | струна | Тип ожидающей проверки безопасности. | Да | |
| id | струна | Идентификатор ожидающей проверки безопасности. | Да | |
| сообщение | струна | Сведения об этой ожидающейся проверке безопасности. | Да |
OpenAI.ИнструментПредварительногоПросмотраИспользованияКомпьютера
Средство управления виртуальным компьютером.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| высота дисплея | целое число | Высота дисплея компьютера. | Да | |
| ширина дисплея | целое число | Ширина дисплея компьютера. | Да | |
| environment | перечисление | Тип управляемой компьютерной среды. Возможные значения: windows, mac, linux, ubuntu, browser |
Да | |
| type | перечисление | Тип средства использования компьютера. Всегда computer_use_preview.Возможные значения: computer_use_preview |
Да |
OpenAI.Coordinate
Пара координат x/y, например { x: 100, y: 200 }.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| x | целое число | Координата x. | Да | |
| и | целое число | Координата y. | Да |
OpenAI.CreateEmbeddingResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Список внедрения, созданных моделью. | Да | |
| модель | струна | Имя модели, используемой для создания внедрения. | Да | |
| объект | перечисление | Тип объекта, который всегда является "list". Возможные значения: list |
Да | |
| использование | объект | Сведения об использовании запроса. | Да | |
| └─ токены_запроса | целое число | Количество маркеров, используемых запросом. | нет | |
| └️ всего_токенов | целое число | Общее количество маркеров, используемых запросом. | нет |
OpenAI.CreateEvalItem
Сообщение чата, включающее запрос или контекст. Может содержать ссылки на переменные в item пространство имен, т. е. {{item.name}}.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | string или OpenAI.EvalItemContent | Текстовые входные данные модели могут содержать строки шаблона. | Да | |
| роль | перечисление | Роль входных данных сообщения. Один из user, assistantsystemили developer.Возможные значения: user, , assistantsystemdeveloper |
Да | |
| type | перечисление | Тип входных данных сообщения. Всегда message.Возможные значения: message |
нет |
OpenAI.CreateEvalRunRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| источник данных | объект | Да | ||
| └─ Тип | OpenAI.EvalRunDataSourceType | нет | ||
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| имя | струна | Имя запуска. | нет |
OpenAI.CreateFineTuningJobRequest
Допустимые модели:
babbage-002
davinci-002
gpt-3.5-turbo
gpt-4o-mini
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| гиперпараметры | объект | Гиперпараметры, используемые для задания тонкой настройки. Это значение теперь устарело в пользу methodи должно передаваться в соответствии с параметром method . |
нет | |
| └batch_size | перечисление | Возможные значения: auto |
нет | |
| └learning_rate_multiplier learning_rate_multiplier | перечисление | Возможные значения: auto |
нет | |
| └️ n_epochs | перечисление | Возможные значения: auto |
нет | |
| Интеграции | массив | Список интеграции для задания тонкой настройки. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| method | OpenAI.FineTuneMethod | Метод, используемый для точной настройки. | нет | |
| модель | строка (см. допустимые модели ниже) | Имя модели для точной настройки. | Да | |
| seed | целое число | Сид определяет воспроизводимость задания. Передача одинаковых параметров начального значения и заданий должна иметь одинаковые результаты, но может отличаться в редких случаях. Если начальное значение не указано, он будет создан для вас. |
нет | |
| Суффикс | струна | Строка до 64 символов, которые будут добавлены в имя настраиваемой модели. Например, suffix в поле "Custom-model-name" будет производиться имя модели, например ft:gpt-4o-mini:openai:custom-model-name:7p4lURel. |
нет | None |
| файл_обучения | струна | Идентификатор отправленного файла, содержащего данные обучения. Набор данных должен быть отформатирован в формате JSONL-файла. Кроме того, необходимо передать файл с целью fine-tune.Содержимое файла должно отличаться в зависимости от того, использует ли модель чат, формат завершения или использует ли метод тонкой настройки формат предпочтения. |
Да | |
| Файл_валидации | струна | Идентификатор отправленного файла, содержащего данные проверки. Если вы предоставляете этот файл, данные используются для периодического создания метрик валидации во время точной настройки. Эти показатели можно просмотреть в файле результатов тонкой настройки. Одни и те же данные не должны присутствовать в файлах обучения и проверки. Набор данных должен быть отформатирован в формате JSONL-файла. Необходимо отправить файл с целью fine-tune. |
нет |
OpenAI.CreateFineTuningJobRequestIntegration
Дискриминация для OpenAI.CreateFineTuningJobRequestIntegration
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
wandb |
OpenAI.CreateFineTuningJobRequestWandbIntegration |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | строка (см. допустимые модели ниже) | Да |
OpenAI.CreateFineTuningJobRequestWandbIntegration
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: wandb |
Да | |
| wandb | объект | Да | ||
| Сущность └️ | струна | нет | ||
| └️ имя | струна | нет | ||
| └️ project | струна | нет | ||
| Теги └️ | массив | нет |
OpenAI.CreateVectorStoreFileBatchRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| attributes | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами. | нет | |
| chunking_strategy | OpenAI.ChunkingStrategyRequestParam | Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . |
нет | |
| идентификаторы_файлов | массив | Список идентификаторов файлов, которые следует использовать векторным хранилищем. Полезно для таких средств, как file_search, которые могут access файлов. |
Да |
OpenAI.CreateVectorStoreFileRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| attributes | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами. | нет | |
| chunking_strategy | OpenAI.ChunkingStrategyRequestParam | Стратегия блокирования, используемая для блокирования файлов. Если этот параметр не задан, используйте стратегию auto . |
нет | |
| идентификатор_файла | струна | Идентификатор файла, который должен использовать хранилище векторов. Полезно для таких средств, как file_search, которые могут access файлов. |
Да |
OpenAI.CreateVectorStoreRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| chunking_strategy | объект | Стратегия по умолчанию. В настоящее время эта стратегия использует и max_chunk_size_tokens имеет значение 800chunk_overlap_tokens .400 |
нет | |
| └️ статический | OpenAI.StaticChunkingStrategy | нет | ||
| └─ Тип | перечисление | Всегда static.Возможные значения: static |
нет | |
| истекает через | OpenAI.VectorStoreExpirationAfter | Политика истечения срока действия для хранилища векторов. | нет | |
| идентификаторы_файлов | массив | Список идентификаторов файлов, которые следует использовать векторным хранилищем. Полезно для таких средств, как file_search, которые могут access файлов. |
нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| имя | струна | Имя векторного хранилища. | нет |
OpenAI.DeleteFileResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| удалено | булевый | Да | ||
| id | струна | Да | ||
| объект | перечисление | Возможные значения: file |
Да |
OpenAI.DeleteVectorStoreFileResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| удалено | булевый | Да | ||
| id | струна | Да | ||
| объект | перечисление | Возможные значения: vector_store.file.deleted |
Да |
OpenAI.DeleteVectorStoreResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| удалено | булевый | Да | ||
| id | струна | Да | ||
| объект | перечисление | Возможные значения: vector_store.deleted |
Да |
OpenAI.Embedding
Представляет собой вектор эмбеддинга, возвращаемый конечной точкой эмбеддинга.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| embedding | массив или строка | Да | ||
| index | целое число | Индекс внедрения в список внедрения. | Да | |
| объект | перечисление | Тип объекта, который всегда является внедрением. Возможные значения: embedding |
Да |
OpenAI.Eval
Объект Eval с конфигурацией источника данных и критериями тестирования. Eval представляет задачу для интеграции LLM. Любить:
- Улучшение качества чат-бота
- Узнайте, как хорошо мой чат-бот обрабатывает поддержку клиентов
- Проверьте, лучше ли o4-mini в моем регистре использования, чем gpt-4o
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Метка времени Unix (в секундах) для момента создания eval. | Да | |
| настройка_источника_данных | объект | Да | ||
| └─ Тип | OpenAI.EvalDataSourceConfigType | нет | ||
| id | струна | Уникальный идентификатор для оценки. | Да | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| имя | струна | Имя оценки. | Да | |
| объект | перечисление | Тип объекта. Возможные значения: eval |
Да | |
| критерии тестирования | массив | Список критериев тестирования. | Да | None |
OpenAI.EvalApiError
Объект, представляющий ответ об ошибке из API Eval.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | струна | Код ошибки. | Да | |
| сообщение | струна | Сообщение об ошибке. | Да |
OpenAI.EvalCompletionsRunDataSourceParams
Объект CompletionsRunDataSource, описывающий конфигурацию выборки модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| входные_сообщения | объект | нет | ||
| └─ ссылка_на_элемент | струна | Ссылка на переменную в item пространстве имен. Т.е., "item.input_trajectory" |
нет | |
| └─ Шаблон | массив | Список сообщений чата, который формирует запрос или контекст. Может содержать ссылки на переменные в item пространство имен, т. е. {{item.name}}. |
нет | |
| └─ Тип | перечисление | Тип входных сообщений. Всегда item_reference.Возможные значения: item_reference |
нет | |
| модель | струна | Имя модели, используемой для создания завершений (например, o3-mini). | нет | |
| параметры выборки | AzureEvalAPICompletionsSamplingParams | нет | ||
| Источник | объект | Да | ||
| └─ Содержимое | массив | Содержимое jsonl-файла. | нет | |
| └created_after | целое число | Необязательная метка времени Unix для фильтрации элементов, созданных после этого времени. | нет | |
| └created_before | целое число | Необязательная метка времени Unix для фильтрации элементов, созданных до этого времени. | нет | |
| Идентификатор └️ | струна | Идентификатор файла. | нет | |
| Ограничение └️ | целое число | Необязательное максимальное количество возвращаемых элементов. | нет | |
| └─ Метаданные | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| └─ Модель | струна | Необязательная модель для фильтрации (например, gpt-4o). | нет | |
| └─ Тип | перечисление | Тип источника . Всегда stored_completions.Возможные значения: stored_completions |
нет | |
| type | перечисление | Тип источника данных запуска. Всегда completions.Возможные значения: completions |
Да |
OpenAI.EvalCustomDataSourceConfigParams
Объект CustomDataSourceConfig, определяющий схему источника данных, используемого для выполнения оценки. Эта схема используется для определения формы данных, которые будут:
- Используется для определения критериев тестирования и
- Какие данные требуются при создании запуска
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| включить_пример_схемы | булевый | Должен ли eval ожидать, что вы заполните пространство имен образца (т. е. создавая ответы на основе вашего источника данных) | нет | Неправда |
| схема_элемента | объект | Схема JSON для каждой строки в источнике данных. | Да | |
| type | перечисление | Тип источника данных. Всегда custom.Возможные значения: custom |
Да |
OpenAI.EvalCustomDataSourceConfigResource
CustomDataSourceConfig, указывающий схему ваших item и при необходимости sample пространств имен.
Схема ответа определяет форму данных, которые будут:
- Используется для определения критериев тестирования и
- Какие данные требуются при создании запуска
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| schema | объект | Схема JSON для элементов источника данных запуска. Узнайте, как создать схемы JSON здесь. |
Да | |
| type | перечисление | Тип источника данных. Всегда custom.Возможные значения: custom |
Да |
OpenAI.EvalDataSourceConfigParams
Дискриминатор для OpenAI.EvalDataSourceConfigParams
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
custom |
OpenAI.EvalCustomDataSourceConfigParams |
logs |
OpenAI.EvalLogsDataSourceConfigParams |
stored_completions |
OpenAI.EvalStoredCompletionsDataSourceConfigParams |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.EvalDataSourceConfigType | Да |
OpenAI.EvalDataSourceConfigResource
Дискриминация для OpenAI.EvalDataSourceConfigResource
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
custom |
OpenAI.EvalCustomDataSourceConfigResource |
stored_completions |
OpenAI.EvalStoredCompletionsDataSourceConfigResource |
logs |
OpenAI.EvalLogsDataSourceConfigResource |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.EvalDataSourceConfigType | Да |
OpenAI.EvalDataSourceConfigType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | customlogsstored_completions |
OpenAI.EvalGraderLabelModelParams
Объект LabelModelGrader, использующий модель для назначения меток каждому элементу в оценке.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | массив | Список сообщений чата, который формирует запрос или контекст. Может содержать ссылки на переменные в item пространство имен, т. е. {{item.name}}. |
Да | |
| labels | массив | Метки для классификации каждого элемента в оценке. | Да | |
| модель | струна | Модель, используемая для оценки. Должен поддерживать структурированные выходные данные. | Да | |
| имя | струна | Имя классировщика. | Да | |
| передача_меток | массив | Метки, указывающие на успешный результат. Должно быть подмножеством этих меток. | Да | |
| type | перечисление | Тип объекта, который всегда label_modelявляется .Возможные значения: label_model |
Да |
OpenAI.EvalGraderLabelModelResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | массив | Да | ||
| labels | массив | Метки, назначенные каждому элементу в оценке. | Да | |
| модель | струна | Модель, используемая для оценки. Должен поддерживать структурированные выходные данные. | Да | |
| имя | струна | Имя классировщика. | Да | |
| передача_меток | массив | Метки, указывающие на успешный результат. Должно быть подмножеством этих меток. | Да | |
| type | перечисление | Тип объекта, который всегда label_modelявляется .Возможные значения: label_model |
Да |
OpenAI.EvalGraderParams
Дискриминация для OpenAI.EvalGraderParams
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
label_model |
OpenAI.EvalGraderLabelModelParams |
string_check |
OpenAI.EvalGraderStringCheckParams |
text_similarity |
OpenAI.EvalGraderTextSimilarityParams |
python |
OpenAI.EvalGraderPythonParams |
score_model |
OpenAI.EvalGraderScoreModelParams |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.GraderType | Да |
OpenAI.EvalGraderPythonParams
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| image_tag | струна | Тег изображения, используемый для скрипта Python. | нет | |
| имя | струна | Имя классировщика. | Да | |
| порог_прохода | число/номер | Пороговое значение для оценки. | нет | |
| Источник | струна | Исходный код скрипта Python. | Да | |
| type | перечисление | Тип объекта, который всегда pythonявляется .Возможные значения: python |
Да |
OpenAI.EvalGraderPythonResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| image_tag | струна | Тег изображения, используемый для скрипта Python. | нет | |
| имя | струна | Имя классировщика. | Да | |
| порог_прохода | число/номер | Пороговое значение для оценки. | нет | |
| Источник | струна | Исходный код скрипта Python. | Да | |
| type | перечисление | Тип объекта, который всегда pythonявляется .Возможные значения: python |
Да |
OpenAI.EvalGraderResource
Дискриминация для OpenAI.EvalGraderResource
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
label_model |
OpenAI.EvalGraderLabelModelResource |
text_similarity |
OpenAI.EvalGraderTextSimilarityResource |
python |
OpenAI.EvalGraderPythonResource |
score_model |
OpenAI.EvalGraderScoreModelResource |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.GraderType | Да |
OpenAI.EvalGraderScoreModelParams
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | массив | Входной текст. Это может включать строки шаблона. | Да | |
| модель | струна | Модель, используемая для оценки. | Да | |
| имя | струна | Имя классировщика. | Да | |
| порог_прохода | число/номер | Пороговое значение для оценки. | нет | |
| диапазон | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| параметры выборки | Параметры выборки для модели. | нет | ||
| type | перечисление | Тип объекта, который всегда score_modelявляется .Возможные значения: score_model |
Да |
OpenAI.EvalGraderScoreModelResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | массив | Входной текст. Это может включать строки шаблона. | Да | |
| модель | струна | Модель, используемая для оценки. | Да | |
| имя | струна | Имя классировщика. | Да | |
| порог_прохода | число/номер | Пороговое значение для оценки. | нет | |
| диапазон | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| параметры выборки | Параметры выборки для модели. | нет | ||
| type | перечисление | Тип объекта, который всегда score_modelявляется .Возможные значения: score_model |
Да |
OpenAI.EvalGraderStringCheckParams
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | струна | Входной текст. Это может включать строки шаблона. | Да | |
| имя | струна | Имя классировщика. | Да | |
| Операция | перечисление | Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.Возможные значения: eq, , nelikeilike |
Да | |
| Ссылка | струна | Текст ссылки. Это может включать строки шаблона. | Да | |
| type | перечисление | Тип объекта, который всегда string_checkявляется .Возможные значения: string_check |
Да |
OpenAI.EvalGraderTextSimilarityParams
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| метрика оценки | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
Да | |
| ввод | струна | Текст, оцениваемый. | Да | |
| имя | струна | Имя классировщика. | Да | |
| порог_прохода | число/номер | Пороговое значение для оценки. | Да | |
| Ссылка | струна | Текст, классируемый против. | Да | |
| type | перечисление | Тип классировщика. Возможные значения: text_similarity |
Да |
OpenAI.EvalGraderTextSimilarityResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| метрика оценки | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
Да | |
| ввод | струна | Текст, оцениваемый. | Да | |
| имя | струна | Имя классировщика. | Да | |
| порог_прохода | число/номер | Пороговое значение для оценки. | Да | |
| Ссылка | струна | Текст, классируемый против. | Да | |
| type | перечисление | Тип классировщика. Возможные значения: text_similarity |
Да |
OpenAI.EvalItem
Входное сообщение модели с ролью, указывающей на следование иерархии инструкций. Инструкции с ролью developer или system имеют приоритет над инструкциями с ролью user. Предполагается, что сообщения с assistant ролью были созданы моделью в предыдущих взаимодействиях.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | объект | Да | ||
| └─ Тип | OpenAI.EvalItemContentType | нет | ||
| роль | перечисление | Роль входных данных сообщения. Один из user, assistantsystemили developer.Возможные значения: user, , assistantsystemdeveloper |
Да | |
| type | перечисление | Тип входных данных сообщения. Всегда message.Возможные значения: message |
нет |
OpenAI.EvalItemContent
Дискриминация для OpenAI.EvalItemContent
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
input_text |
OpenAI.EvalItemContentInputText |
output_text |
OpenAI.EvalItemContentOutputText |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.EvalItemContentType | Да |
OpenAI.EvalItemContentInputText
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| текст | струна | Да | ||
| type | перечисление | Возможные значения: input_text |
Да |
OpenAI.EvalItemContentOutputText
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| текст | струна | Да | ||
| type | перечисление | Возможные значения: output_text |
Да |
OpenAI.EvalItemContentType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | input_textoutput_text |
OpenAI.EvalJsonlRunDataSourceParams
Объект JsonlRunDataSource, указывающий JSONL-файл, соответствующий оценке.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| Источник | объект | Да | ||
| └─ Содержимое | массив | Содержимое jsonl-файла. | нет | |
| Идентификатор └️ | струна | Идентификатор файла. | нет | |
| └─ Тип | перечисление | Тип источника jsonl. Всегда file_id.Возможные значения: file_id |
нет | |
| type | перечисление | Тип источника данных. Всегда jsonl.Возможные значения: jsonl |
Да |
OpenAI.EvalList
Объект, представляющий список оценок.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Массив объектов eval. | Да | |
| первый_идентификатор | струна | Идентификатор первой функции eval в массиве данных. | Да | |
| есть_еще | булевый | Указывает, доступны ли дополнительные оценки. | Да | |
| last_id | струна | Идентификатор последнего eval в массиве данных. | Да | |
| объект | перечисление | Тип этого объекта. Для него всегда задано значение list. Возможные значения: list |
Да |
OpenAI.EvalLogsDataSourceConfigParams
Конфигурация источника данных, указывающая свойство метаданных запроса журналов.
Обычно это метаданные, такие как usecase=chatbot или prompt-version=v2и т. д.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| type | перечисление | Тип источника данных. Всегда logs.Возможные значения: logs |
Да |
OpenAI.EvalLogsDataSourceConfigResource
LogsDataSourceConfig, указывающий свойство метаданных запроса журналов.
Обычно это метаданные, такие как usecase=chatbot или prompt-version=v2и т. д. Схема, возвращаемая этой конфигурацией источника данных, используется для определения переменных, доступных в оценках.
item и sample определяются при использовании этой конфигурации источника данных.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| schema | объект | Схема JSON для элементов источника данных запуска. Узнайте, как создать схемы JSON здесь. |
Да | |
| type | перечисление | Тип источника данных. Всегда logs.Возможные значения: logs |
Да |
OpenAI.EvalResponsesRunDataSourceParams
Объект ResponsesRunDataSource, описывающий конфигурацию выборки модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| входные_сообщения | объект | нет | ||
| └─ ссылка_на_элемент | струна | Ссылка на переменную в item пространстве имен. Т.е., "item.name" |
нет | |
| └─ Шаблон | массив | Список сообщений чата, который формирует запрос или контекст. Может содержать ссылки на переменные в item пространство имен, т. е. {{item.name}}. |
нет | |
| └─ Тип | перечисление | Тип входных сообщений. Всегда item_reference.Возможные значения: item_reference |
нет | |
| модель | струна | Имя модели, используемой для создания завершений (например, o3-mini). | нет | |
| параметры выборки | AzureEvalAPIResponseSamplingParams | нет | ||
| Источник | объект | Да | ||
| └─ Содержимое | массив | Содержимое jsonl-файла. | нет | |
| └created_after | целое число | Включайте только элементы, созданные после этого метки времени (включительно). Это параметр запроса, используемый для выбора ответов. | нет | |
| └created_before | целое число | Включайте только элементы, созданные до этого метки времени (включительно). Это параметр запроса, используемый для выбора ответов. | нет | |
| Идентификатор └️ | струна | Идентификатор файла. | нет | |
| └instructions_search | струна | Необязательная строка для поиска в поле "инструкции". Это параметр запроса, используемый для выбора ответов. | нет | |
| └─ Метаданные | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| └─ Модель | струна | Имя модели для поиска ответов. Это параметр запроса, используемый для выбора ответов. | нет | |
| └reasoning_effort | OpenAI.ReasoningEffort | Необязательный параметр усилий по соображениям. Это параметр запроса, используемый для выбора ответов. | нет | |
| └─ Температура | число/номер | Температура выборки. Это параметр запроса, используемый для выбора ответов. | нет | |
| └─ Инструменты | массив | Список имен инструментов. Это параметр запроса, используемый для выбора ответов. | нет | |
| └️ top_p | число/номер | Параметр выборки ядра. Это параметр запроса, используемый для выбора ответов. | нет | |
| └─ Тип | перечисление | Тип источника данных запуска. Всегда responses.Возможные значения: responses |
нет | |
| Пользователи └️ | массив | Список идентификаторов пользователей. Это параметр запроса, используемый для выбора ответов. | нет | |
| type | перечисление | Тип источника данных запуска. Всегда responses.Возможные значения: responses |
Да |
OpenAI.EvalRun
Схема, представляющая процесс оценки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Метка времени Unix (в секундах) при создании запуска оценки. | Да | |
| источник данных | объект | Да | ||
| └─ Тип | OpenAI.EvalRunDataSourceType | нет | ||
| ошибка | OpenAI.EvalApiError | Объект, представляющий ответ об ошибке из API Eval. | Да | |
| eval_id | струна | Идентификатор ассоциированной оценки. | Да | |
| id | струна | Уникальный идентификатор для оценочной сессии. | Да | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| модель | струна | Модель, подлежащая оценке, если применимо. | Да | |
| имя | струна | Название сеанса оценки. | Да | |
| объект | перечисление | Тип объекта . Всегда "eval.run". Возможные значения: eval.run |
Да | |
| использование_на_модель | массив | Статистика использования для каждой модели во время выполнения оценки. | Да | |
| результаты_по_критериям_тестирования | массив | Результаты для каждого критерия тестирования, применяемые во время выполнения оценки. | Да | |
| report_url | струна | URL-адрес отчета о визуализации результатов выполнения оценочного запуска на панели мониторинга пользовательского интерфейса. | Да | |
| количество_результатов | объект | Счетчики, обобщающие результаты выполнения оценки. | Да | |
| Ошибка | целое число | Количество выходных элементов, которые привели к ошибке. | нет | |
| └─ Ошибка | целое число | Количество выходных элементов, которые не прошли оценку. | нет | |
| ├─ прошло | целое число | Количество выходных элементов, которые прошли оценку. | нет | |
| └─ всего | целое число | Общее количество выполненных выходных элементов. | нет | |
| статус | струна | Состояние выполнения оценки. | Да |
OpenAI.EvalRunDataContentSource
Дискриминация для OpenAI.EvalRunDataContentSource
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
file_id |
OpenAI.EvalRunFileIdDataContentSource |
stored_completions |
OpenAI.EvalRunStoredCompletionsDataContentSource |
responses |
OpenAI.EvalRunResponsesDataContentSource |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.EvalRunDataContentSourceType | Да |
OpenAI.EvalRunDataContentSourceType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | file_idfile_contentstored_completionsresponses |
OpenAI.EvalRunDataSourceCompletionsResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: completions |
Да |
OpenAI.EvalRunDataSourceJsonlResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: jsonl |
Да |
OpenAI.EvalRunDataSourceParams
Дискриминация для OpenAI.EvalRunDataSourceParams
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
jsonl |
OpenAI.EvalJsonlRunDataSourceParams |
completions |
OpenAI.EvalCompletionsRunDataSourceParams |
responses |
OpenAI.EvalResponsesRunDataSourceParams |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.EvalRunDataSourceType | Да |
OpenAI.EvalRunDataSourceResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.EvalRunDataSourceType | Да |
OpenAI.EvalRunDataSourceResponsesResource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: responses |
Да |
OpenAI.EvalRunDataSourceType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | jsonlcompletionsresponses |
OpenAI.EvalRunFileContentDataContentSource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое jsonl-файла. | Да | |
| type | перечисление | Тип источника jsonl. Всегда file_content.Возможные значения: file_content |
Да |
OpenAI.EvalRunFileIdDataContentSource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| id | струна | Идентификатор файла. | Да | |
| type | перечисление | Тип источника jsonl. Всегда file_id.Возможные значения: file_id |
Да |
OpenAI.EvalRunList
Объект, представляющий список запусков для оценки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Массив объектов выполнения eval. | Да | |
| первый_идентификатор | струна | Идентификатор первого запуска оценки в массиве данных. | Да | |
| есть_еще | булевый | Указывает, доступны ли дополнительные оценки. | Да | |
| last_id | струна | Идентификатор последнего запуска eval в массиве данных. | Да | |
| объект | перечисление | Тип этого объекта. Для него всегда задано значение list. Возможные значения: list |
Да |
OpenAI.EvalRunOutputItem
Схема, представляющая выходной элемент оценочного запуска.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Метка времени Unix (в секундах) при создании запуска оценки. | Да | |
| элемент источника данных | объект | Сведения об элементе источника входных данных. | Да | |
| идентификатор_элемента_источника_данных | целое число | Идентификатор элемента источника данных. | Да | |
| eval_id | струна | Идентификатор группы оценки. | Да | |
| id | струна | Уникальный идентификатор элемента результата выполнения оценки. | Да | |
| объект | перечисление | Тип объекта . Всегда "eval.run.output_item". Возможные значения: eval.run.output_item |
Да | |
| results | массив | Список результатов выполнения оценки. | Да | |
| run_id | струна | Идентификатор оценки, связанной с этим результирующим элементом. | Да | |
| образец | объект | Пример, содержащий входные и выходные данные выполнения оценки. | Да | |
| └─ Ошибка | OpenAI.EvalApiError | Объект, представляющий ответ об ошибке из API Eval. | нет | |
| └️ причина_завершения | струна | Причина завершения создания образца. | нет | |
| └─ Входные данные | массив | Массив входных сообщений. | нет | |
| └─max_completion_tokens | целое число | Максимальное количество токенов, разрешенных для завершения. | нет | |
| └─ Модель | струна | Модель, используемая для создания примера. | нет | |
| вывод └─ | массив | Массив выходных сообщений. | нет | |
| Начальное значение └️ | целое число | Значение, используемое в качестве семени для генерации образца. | нет | |
| └─ Температура | число/номер | Используемая температура выборки. | нет | |
| └️ top_p | число/номер | Значение top_p, используемое для выборки. | нет | |
| └─ использование | объект | Сведения об использовании токенов в качестве примера. | нет | |
| └ cached_tokens | целое число | Количество токенов, полученных из кэша. | нет | |
| └─ токены завершения | целое число | Количество созданных маркеров завершения. | нет | |
| └─ токены_запроса | целое число | Количество используемых токенов запроса. | нет | |
| └️ всего_токенов | целое число | Общее количество используемых токенов. | нет | |
| статус | струна | Состояние выполнения оценки. | Да |
OpenAI.EvalRunOutputItemList
Объект, представляющий список выходных элементов для выполнения оценки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Массив объектов элементов результата выполнения eval. | Да | |
| первый_идентификатор | струна | Идентификатор первого выходного элемента eval в массиве данных. | Да | |
| есть_еще | булевый | Указывает, доступны ли еще элементы вывода из оценки. | Да | |
| last_id | струна | Идентификатор последнего элемента вывода eval в массиве данных. | Да | |
| объект | перечисление | Тип этого объекта. Для него всегда задано значение list. Возможные значения: list |
Да |
OpenAI.EvalRunResponsesDataContentSource
Объект EvalResponsesSource, описывающий конфигурацию источника данных запуска.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано после | целое число | Включайте только элементы, созданные после этого метки времени (включительно). Это параметр запроса, используемый для выбора ответов. | нет | |
| создано до | целое число | Включайте только элементы, созданные до этого метки времени (включительно). Это параметр запроса, используемый для выбора ответов. | нет | |
| instructions_search | струна | Необязательная строка для поиска в поле "инструкции". Это параметр запроса, используемый для выбора ответов. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| модель | струна | Имя модели для поиска ответов. Это параметр запроса, используемый для выбора ответов. | нет | |
| усилия на рассуждение | объект |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
нет | |
| Температура | число/номер | Температура выборки. Это параметр запроса, используемый для выбора ответов. | нет | |
| инструменты | массив | Список имен инструментов. Это параметр запроса, используемый для выбора ответов. | нет | |
| top_p | число/номер | Параметр выборки ядра. Это параметр запроса, используемый для выбора ответов. | нет | |
| type | перечисление | Тип источника данных запуска. Всегда responses.Возможные значения: responses |
Да | |
| users | массив | Список идентификаторов пользователей. Это параметр запроса, используемый для выбора ответов. | нет |
OpenAI.EvalRunStoredCompletionsDataContentSource
Конфигурация StoredCompletionsRunDataSource, описывающая набор фильтров
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано после | целое число | Необязательная метка времени Unix для фильтрации элементов, созданных после этого времени. | нет | |
| создано до | целое число | Необязательная метка времени Unix для фильтрации элементов, созданных до этого времени. | нет | |
| limit | целое число | Необязательное максимальное количество возвращаемых элементов. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| модель | струна | Необязательная модель для фильтрации (например, gpt-4o). | нет | |
| type | перечисление | Тип источника . Всегда stored_completions.Возможные значения: stored_completions |
Да |
OpenAI.EvalStoredCompletionsDataSourceConfigParams
Не рекомендуется использовать LogsDataSourceConfig.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| metadata | объект | Фильтры метаданных для источника данных хранимых завершений. | нет | |
| type | перечисление | Тип источника данных. Всегда stored_completions.Возможные значения: stored_completions |
Да |
OpenAI.EvalStoredCompletionsDataSourceConfigResource
Не рекомендуется использовать LogsDataSourceConfig.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| schema | объект | Схема JSON для элементов источника данных запуска. Узнайте, как создать схемы JSON здесь. |
Да | |
| type | перечисление | Тип источника данных. Всегда stored_completions.Возможные значения: stored_completions |
Да |
OpenAI.FileSearchTool
Средство, которое ищет соответствующее содержимое из отправленных файлов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| filters | объект | нет | ||
| максимальное_количество_результатов | целое число | Максимальное количество отображаемых результатов. Это число должно быть от 1 до 50 включительно. | нет | |
| опции рейтинга | объект | нет | ||
| Рангер └️ | перечисление | Рангер, используемый для поиска файлов. Возможные значения: auto, default-2024-11-15 |
нет | |
| └─ порог оценки | число/номер | Пороговое значение оценки для поиска файлов — от 0 до 1. Числа ближе к 1 будут пытаться вернуть только наиболее релевантные результаты, но могут возвращать меньше результатов. | нет | |
| type | перечисление | Тип средства поиска файлов. Всегда file_search.Возможные значения: file_search |
Да | |
| vector_store_ids | массив | Идентификаторы векторных хранилищ для поиска. | Да |
OpenAI.FileSearchToolCallItemParam
Результаты вызова средства поиска файлов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| queries | массив | Запросы, используемые для поиска файлов. | Да | |
| results | массив | Результаты вызова средства поиска файлов. | нет | |
| type | перечисление | Возможные значения: file_search_call |
Да |
OpenAI.FileSearchToolCallItemResource
Результаты вызова средства поиска файлов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| queries | массив | Запросы, используемые для поиска файлов. | Да | |
| results | массив | Результаты вызова средства поиска файлов. | нет | |
| статус | перечисление | Состояние вызова средства поиска файлов. Один из in_progress, searchingincomplete или failed.Возможные значения: in_progress, searching, completed, incomplete, failed |
Да | |
| type | перечисление | Возможные значения: file_search_call |
Да |
OpenAI.Фильтры
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| filters | массив | Массив фильтров для объединения. Элементы могут быть ComparisonFilter или CompoundFilter. |
Да | |
| ключ | струна | Ключ для сопоставления со значением. | Да | |
| type | перечисление | Тип операции: and или or.Возможные значения: and, or |
Да | |
| value | строка или число или логическое значение | Значение для сравнения с ключом атрибута; поддерживает типы строк, чисел или логических типов. | Да |
OpenAI.FineTuneDPOHyperparameters
Гиперпараметры, используемые для задания точной настройки DPO.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| размер пакета | перечисление | Возможные значения: auto |
нет | |
| Бета | перечисление | Возможные значения: auto |
нет | |
| множитель скорости обучения | перечисление | Возможные значения: auto |
нет | |
| количество эпох | перечисление | Возможные значения: auto |
нет |
OpenAI.FineTuneDPOMethod
Конфигурация для метода точной настройки DPO.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| гиперпараметры | OpenAI.FineTuneDPOHyperparameters | Гиперпараметры, используемые для задания точной настройки DPO. | нет |
OpenAI.FineTuneMethod
Метод, используемый для точной настройки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| dpo | OpenAI.FineTuneDPOMethod | Конфигурация для метода точной настройки DPO. | нет | |
| усиление | AzureFineTuneReinforcementMethod | нет | ||
| Под наблюдением | OpenAI.FineTuneSupervisedMethod | Настройка защищенного метода тонкой настройки. | нет | |
| type | перечисление | Тип метода.
supervisedЛибо , dpoлибо reinforcement.Возможные значения: supervised, dporeinforcement |
Да |
OpenAI.FineTuneReinforcementHyperparameters
Гиперпараметры, используемые для задания точной настройки с подкреплением.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| размер пакета | перечисление | Возможные значения: auto |
нет | |
| compute_multiplier | перечисление | Возможные значения: auto |
нет | |
| eval_interval | перечисление | Возможные значения: auto |
нет | |
| eval_samples | перечисление | Возможные значения: auto |
нет | |
| множитель скорости обучения | перечисление | Возможные значения: auto |
нет | |
| количество эпох | перечисление | Возможные значения: auto |
нет | |
| усилия на рассуждение | перечисление | Уровень усилий по рассуждениям. Возможные значения: default, , lowmediumhigh |
нет |
OpenAI.FineTuneSupervisedHyperparameters
Гиперпараметры, используемые для задания тонкой настройки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| размер пакета | перечисление | Возможные значения: auto |
нет | |
| множитель скорости обучения | перечисление | Возможные значения: auto |
нет | |
| количество эпох | перечисление | Возможные значения: auto |
нет |
OpenAI.FineTuneSupervisedMethod
Настройка защищенного метода тонкой настройки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| гиперпараметры | OpenAI.FineTuneSupervisedHyperparameters | Гиперпараметры, используемые для задания тонкой настройки. | нет |
OpenAI.FineTuningIntegration
Дискриминация для OpenAI.FineTuningIntegration
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
wandb |
OpenAI.FineTuningIntegrationWandb |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | строка (см. допустимые модели ниже) | Да |
OpenAI.FineTuningIntegrationWandb
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Тип интеграции, включаемой для задания тонкой настройки. Возможные значения: wandb |
Да | |
| wandb | объект | Параметры интеграции с весами и смещениями. Эта полезные данные указывает project, в которые будут отправляться метрики. При необходимости можно задать явное отображаемое имя для запуска, добавить теги в выполнение и задать сущность по умолчанию (команда, имя пользователя и т. д.), которая будет связана с выполнением. | Да | |
| Сущность └️ | струна | Сущность, используемая для выполнения. Это позволяет вам задать команду или имя пользователя WandB, которые вы хотите ассоциировать с запуском. Если не задано, используется сущность по умолчанию для зарегистрированного ключа API WandB. | нет | |
| └️ имя | струна | Отображаемое имя, заданное для выполнения. Если этот параметр не задан, в качестве имени будет использоваться идентификатор задания. | нет | |
| └️ project | струна | Имя project, в которую будет создан новый запуск. | нет | |
| Теги └️ | массив | Список тегов, присоединенных к созданному запуску. Эти теги передаются непосредственно в WandB. Некоторые теги по умолчанию создаются OpenAI: openai/finetune, openai/{base-model}, openai/{ftjob-abcdef}. | нет |
OpenAI.FineTuningJob
Объект fine_tuning.job представляет задание тонкой настройки, созданное с помощью API.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Метка времени Unix (в секундах) для создания задания тонкой настройки. | Да | |
| ошибка | объект | Для заданий тонкой настройки, имеющихся failed, это будет содержать дополнительные сведения о причине сбоя. |
Да | |
| └─ Код | струна | Код ошибки, доступный для чтения компьютером. | нет | |
| Сообщение └️ | струна | Сообщение об ошибке, доступное для чтения человеком. | нет | |
| └─ параметр | струна | Недопустимый параметр, обычно training_file или validation_file. Это поле будет иметь значение NULL, если сбой не был определенным параметром. |
нет | |
| предполагаемое завершение | целое число | Метка времени Unix (в секундах) для завершения задания тонкой настройки. Значение будет иметь значение NULL, если задание тонкой настройки не выполняется. | нет | |
| fine_tuned_model | струна | Имя созданной точно настроенной модели. Значение будет иметь значение NULL, если задание тонкой настройки по-прежнему выполняется. | Да | |
| завершено_в | целое число | Метка времени Unix (в секундах) для завершения задания тонкой настройки. Значение будет иметь значение NULL, если задание тонкой настройки по-прежнему выполняется. | Да | |
| гиперпараметры | объект | Гиперпараметры, используемые для задания тонкой настройки. Это значение будет возвращено только при выполнении supervised заданий. |
Да | |
| └batch_size | перечисление | Возможные значения: auto |
нет | |
| └learning_rate_multiplier learning_rate_multiplier | перечисление | Возможные значения: auto |
нет | |
| └️ n_epochs | перечисление | Возможные значения: auto |
нет | |
| id | струна | Идентификатор объекта, на который можно ссылаться в конечных точках API. | Да | |
| Интеграции | массив | Список интеграции для этого задания тонкой настройки. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| method | OpenAI.FineTuneMethod | Метод, используемый для точной настройки. | нет | |
| модель | струна | Базовая модель, которая настраивается. | Да | |
| объект | перечисление | Тип объекта, который всегда является "fine_tuning.job". Возможные значения: fine_tuning.job |
Да | |
| organization_id | струна | Организация, которая владеет заданием тонкой настройки. | Да | |
| файлы_результатов | массив | Скомпилированные идентификаторы файлов результатов для задания тонкой настройки. Результаты можно получить с помощью API файлов. | Да | |
| seed | целое число | Сид, используемый для задания тонкой настройки. | Да | |
| статус | перечисление | Текущее состояние задания тонкой настройки, которое может быть validating_filesлибо , , queued, runningsucceededfailedcancelledлибо .Возможные значения: validating_files, queued, running, succeeded, failed, cancelled |
Да | |
| обученные_токены | целое число | Общее количество оплачиваемых маркеров, обработанных этим заданием тонкой настройки. Значение будет иметь значение NULL, если задание тонкой настройки по-прежнему выполняется. | Да | |
| файл_обучения | струна | Идентификатор файла, используемый для обучения. Вы можете получить обучающие данные с помощью API файлов. | Да | |
| user_provided_suffix | струна | Описательный суффикс, примененный к заданию, как указано в запросе на создание задания. | нет | |
| Файл_валидации | струна | Идентификатор файла, используемый для проверки. Результаты проверки можно получить с помощью API файлов. | Да |
OpenAI.FineTuningJobCheckpoint
Объект fine_tuning.job.checkpoint представляет контрольную точку модели для задания тонкой настройки, готового к использованию.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Метка времени Unix (в секундах) для момента создания контрольной точки. | Да | |
| контрольная точка тонко настроенной модели | струна | Имя созданной модели точно настроенной контрольной точки. | Да | |
| идентификатор_задания_тончайшей_настройки | струна | Имя задания тонкой настройки, из которого был создан этот контрольный пункт. | Да | |
| id | струна | Идентификатор контрольной точки, на который можно ссылаться в конечных точках API. | Да | |
| metrics | объект | Метрики на номере шага во время задания тонкой настройки. | Да | |
| └️ full_valid_loss | число/номер | нет | ||
| └full_valid_mean_token_accuracy | число/номер | нет | ||
| Шаг └️ | число/номер | нет | ||
| └train_loss | число/номер | нет | ||
| └train_mean_token_accuracy | число/номер | нет | ||
| └️ valid_loss | число/номер | нет | ||
| └valid_mean_token_accuracy valid_mean_token_accuracy | число/номер | нет | ||
| объект | перечисление | Тип объекта, который всегда является "fine_tuning.job.checkpoint". Возможные значения: fine_tuning.job.checkpoint |
Да | |
| номер_шага | целое число | Номер шага, на который была создана контрольная точка. | Да |
OpenAI.FineTuningJobEvent
Объект события задания точной настройки
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Метка времени Unix (в секундах) для создания задания тонкой настройки. | Да | |
| данные | Данные, связанные с событием. | нет | ||
| id | струна | Идентификатор объекта. | Да | |
| уровень | перечисление | Уровень журнала события. Возможные значения: info, warnerror |
Да | |
| сообщение | струна | Сообщение события. | Да | |
| объект | перечисление | Тип объекта, который всегда является "fine_tuning.job.event". Возможные значения: fine_tuning.job.event |
Да | |
| type | перечисление | Тип события. Возможные значения: message, metrics |
нет |
OpenAI.FunctionObject
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| описание | струна | Описание того, что выполняет функция, используемая моделью для выбора времени и способа вызова функции. | нет | |
| имя | струна | Имя вызываемой функции. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. | Да | |
| параметры | Параметры, которые принимают функции, описаны как объект схемы JSON. | нет | ||
| строгий | булевый | Следует ли включить строгое соблюдение схемы при создании вызова функции. Если задано значение true, модель будет соответствовать точной схеме, определенной parameters в поле. Только подмножество схемы JSON поддерживается, если stricttrue. |
нет | Неправда |
OpenAI.FunctionTool
Определяет функцию в собственном коде, которую модель может вызвать.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| описание | струна | Описание функции. Используется моделью для определения того, следует ли вызывать функцию. | нет | |
| имя | струна | Имя вызываемой функции. | Да | |
| параметры | Объект схемы JSON, описывающий параметры функции. | Да | ||
| строгий | булевый | Следует ли применять строгую проверку параметров.
trueпо умолчанию. |
Да | |
| type | перечисление | Тип средства функции. Всегда function.Возможные значения: function |
Да |
OpenAI.FunctionToolCallItemParam
Вызов средства для запуска функции.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| arguments | струна | Строка JSON аргументов для передачи функции. | Да | |
| call_id | струна | Уникальный идентификатор вызова функции, созданного моделью. | Да | |
| имя | струна | Имя выполняемой функции. | Да | |
| type | перечисление | Возможные значения: function_call |
Да |
OpenAI.FunctionToolCallItemResource
Вызов средства для запуска функции.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| arguments | струна | Строка JSON аргументов для передачи функции. | Да | |
| call_id | струна | Уникальный идентификатор вызова функции, созданного моделью. | Да | |
| имя | струна | Имя выполняемой функции. | Да | |
| статус | перечисление | Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.Возможные значения: in_progress, completedincomplete |
Да | |
| type | перечисление | Возможные значения: function_call |
Да |
OpenAI.FunctionToolCallOutputItemParam
Выходные данные вызова инструмента функции.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| call_id | струна | Уникальный идентификатор вызова функции, созданного моделью. | Да | |
| output | струна | Строка JSON данных, полученных в результате вызова инструмента функции. | Да | |
| type | перечисление | Возможные значения: function_call_output |
Да |
OpenAI.FunctionToolCallOutputItemResource
Выходные данные вызова инструмента функции.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| call_id | струна | Уникальный идентификатор вызова функции, созданного моделью. | Да | |
| output | струна | Строка JSON данных, полученных в результате вызова инструмента функции. | Да | |
| статус | перечисление | Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.Возможные значения: in_progress, completedincomplete |
Да | |
| type | перечисление | Возможные значения: function_call_output |
Да |
OpenAI.Grader
Дискриминация для OpenAI.Grader
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
label_model |
OpenAI.GraderLabelModel |
text_similarity |
OpenAI.GraderTextSimilarity |
python |
OpenAI.GraderPython |
score_model |
OpenAI.GraderScoreModel |
multi |
OpenAI.GraderMulti |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.GraderType | Да |
OpenAI.GraderLabelModel
Объект LabelModelGrader, использующий модель для назначения меток каждому элементу в оценке.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | массив | Да | ||
| labels | массив | Метки, назначенные каждому элементу в оценке. | Да | |
| модель | струна | Модель, используемая для оценки. Должен поддерживать структурированные выходные данные. | Да | |
| имя | струна | Имя классировщика. | Да | |
| передача_меток | массив | Метки, указывающие на успешный результат. Должно быть подмножеством этих меток. | Да | |
| type | перечисление | Тип объекта, который всегда label_modelявляется .Возможные значения: label_model |
Да |
OpenAI.GraderMulti
Объект MultiGrader объединяет выходные данные нескольких классировщиков для создания одной оценки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| calculate_output | струна | Формула для вычисления выходных данных на основе результатов оценки. | Да | |
| Грейдеры | объект | Да | ||
| имя | струна | Имя классировщика. | Да | |
| type | перечисление | Тип объекта, который всегда multiявляется .Возможные значения: multi |
Да |
OpenAI.GraderPython
Объект PythonGrader, который запускает скрипт Python на входных данных.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| image_tag | струна | Тег изображения, используемый для скрипта Python. | нет | |
| имя | струна | Имя классировщика. | Да | |
| Источник | струна | Исходный код скрипта Python. | Да | |
| type | перечисление | Тип объекта, который всегда pythonявляется .Возможные значения: python |
Да |
OpenAI.GraderScoreModel
Объект ScoreModelGrader, использующий модель для назначения оценки входным данным.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | массив | Входной текст. Это может включать строки шаблона. | Да | |
| модель | струна | Модель, используемая для оценки. | Да | |
| имя | струна | Имя классировщика. | Да | |
| диапазон | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| параметры выборки | Параметры выборки для модели. | нет | ||
| type | перечисление | Тип объекта, который всегда score_modelявляется .Возможные значения: score_model |
Да |
OpenAI.GraderStringCheck
Объект StringCheckGrader, выполняющий сравнение строк между входами и ссылкой с помощью указанной операции.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ввод | струна | Входной текст. Это может включать строки шаблона. | Да | |
| имя | струна | Имя классировщика. | Да | |
| Операция | перечисление | Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.Возможные значения: eq, , nelikeilike |
Да | |
| Ссылка | струна | Текст ссылки. Это может включать строки шаблона. | Да | |
| type | перечисление | Тип объекта, который всегда string_checkявляется .Возможные значения: string_check |
Да |
OpenAI.GraderTextSimilarity
Объект TextSimilarityGrader, который классирует текст на основе метрик сходства.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| метрика оценки | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
Да | |
| ввод | струна | Текст, оцениваемый. | Да | |
| имя | струна | Имя классировщика. | Да | |
| Ссылка | струна | Текст, классируемый против. | Да | |
| type | перечисление | Тип классировщика. Возможные значения: text_similarity |
Да |
OpenAI.GraderType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | string_checktext_similarityscore_modellabel_modelpythonmulti |
OpenAI.ImageGenTool
Средство, которое создает изображения с помощью такой gpt-image-1.5модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | перечисление | Тип фона для созданного изображения. Один из transparent, opaque, или auto. По умолчанию: auto.Возможные значения: transparent, opaqueauto |
нет | |
| входная маска изображения | объект | Опциональная маска для инпейнтинга. Содержит image_url (строка, необязательно) и file_id (строка, необязательно). |
нет | |
| └ file_id | струна | Идентификатор файла для изображения маски. | нет | |
| └image_url | струна | Изображение маски в кодировке Base64. | нет | |
| модель | перечисление | Модель создания изображений, используемая. По умолчанию: gpt-image-1.Возможные значения: gpt-image-1, gpt-image-1.5 |
нет | |
| moderation | перечисление | Уровень модерации для созданного образа. По умолчанию: auto.Возможные значения: auto, low |
нет | |
| сжатие вывода | целое число | Уровень сжатия для выходного изображения. Значение по умолчанию: 100. | нет | 100 |
| формат_выходных_данных | перечисление | Формат выходных данных созданного изображения. Один из png, webp, или jpeg. По умолчанию: png.Возможные значения: png, webpjpeg |
нет | |
| частичные_изображения | целое число | Количество частичных образов для создания в режиме потоковой передачи от 0 (значение по умолчанию) до 3. | нет | 0 |
| качество | перечисление | Качество созданного изображения. Один из low, mediumhighили auto. По умолчанию: auto.Возможные значения: low, , mediumhighauto |
нет | |
| size | перечисление | Размер созданного изображения. Один из 1024x1024, 1024x15361536x1024или auto. По умолчанию: auto.Возможные значения: 1024x1024, , 1024x15361536x1024auto |
нет | |
| type | перечисление | Тип средства создания изображений. Всегда image_generation.Возможные значения: image_generation |
Да |
OpenAI.ImageGenToolCallItemParam
Запрос на создание изображения, сделанный моделью.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| результат | струна | Созданный образ, закодированный в base64. | Да | |
| type | перечисление | Возможные значения: image_generation_call |
Да |
OpenAI.ImageGenToolCallItemResource
Запрос на создание изображения, сделанный моделью.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| результат | струна | Созданный образ, закодированный в base64. | Да | |
| статус | перечисление | Возможные значения: in_progress, , completedgeneratingfailed |
Да | |
| type | перечисление | Возможные значения: image_generation_call |
Да |
OpenAI.ImplicitUserMessage
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | строка или массив | Да |
OpenAI.Includable
Укажите дополнительные выходные данные для включения в ответ модели. В настоящее время поддерживаются следующие значения:
-
code_interpreter_call.outputs: включает выходные данные выполнения кода Python в элементах вызова средства интерпретатора кода кода. -
computer_call_output.output.image_url: добавьте URL-адреса изображения из результата выполнения команды на компьютере. -
file_search_call.results: включите результаты поиска запроса средства поиска файлов. -
message.input_image.image_url: включите URL-адреса изображения из входного сообщения. -
message.output_text.logprobs: включите журналы с сообщениями помощника. -
reasoning.encrypted_content: включает зашифрованную версию токенов рассуждения в выходных данных элемента. Это позволяет использовать элементы рассуждений в многоэтапных беседах при статическом использовании API ответов (например, еслиstoreпараметр заданfalse, или когда организация зарегистрирована в программе нулевого хранения данных).
| Недвижимость | Ценность |
|---|---|
| Описание | Укажите дополнительные выходные данные для включения в ответ модели. В настоящее время поддерживаются следующие значения: - code_interpreter_call.outputs: включает выходные данные выполнения кода Python в элементах вызова средства интерпретатора.- computer_call_output.output.image_url: добавьте URL-адреса изображений из выходных данных компьютерного вызова.- file_search_call.results: включите результаты поиска вызова средства поиска файлов.- message.input_image.image_url: включите URL-адреса изображения из входного сообщения.- message.output_text.logprobs: включите журналы с сообщениями помощника.- reasoning.encrypted_content: включает зашифрованную версию токенов в элементах рассуждения на выходе. Это позволяет использовать элементы рассуждений в многоэтапных беседах при статическом использовании API ответов (например, если store параметр задан false, или когда организация зарегистрирована в программе нулевого хранения данных). |
| Тип | струна |
| Значения | code_interpreter_call.outputscomputer_call_output.output.image_urlfile_search_call.resultsmessage.input_image.image_urlmessage.output_text.logprobsreasoning.encrypted_content |
OpenAI.ItemContent
Дискриминатор для OpenAI.ItemContent
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
input_audio |
OpenAI.ItemContentInputAudio |
output_audio |
OpenAI.ItemContentOutputAudio |
refusal |
OpenAI.ItemContentRefusal |
input_text |
OpenAI.ItemContentInputText |
input_image |
OpenAI.ItemContentInputImage |
input_file |
OpenAI.ItemContentInputFile |
output_text |
OpenAI.ItemContentOutputText |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ItemContentType | Много модальное содержимое входных и выходных данных. | Да |
OpenAI.ItemContentInputAudio
Аудиовход для модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | струна | Звуковые данные в кодировке Base64. | Да | |
| format | перечисление | Формат звуковых данных. В настоящее время поддерживаются mp3 форматы и wav.Возможные значения: mp3, wav |
Да | |
| type | перечисление | Тип входного элемента. Всегда input_audio.Возможные значения: input_audio |
Да |
OpenAI.ItemContentInputFile
Файл в качестве входных данных для модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| file_data | струна | Содержимое файла, отправляемого в модель. | нет | |
| идентификатор_файла | струна | Идентификатор файла, отправляемого в модель. | нет | |
| filename | струна | Имя файла, отправляемого в модель. | нет | |
| type | перечисление | Тип входного элемента. Всегда input_file.Возможные значения: input_file |
Да |
OpenAI.ItemContentInputImage
Изображение в качестве входных данных для модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| detail | перечисление | Уровень детализации изображения, отправляемого в модель. Один из high, low, или auto. По умолчанию — auto.Возможные значения: low, highauto |
нет | |
| идентификатор_файла | струна | Идентификатор файла, отправляемого в модель. | нет | |
| ссылка_на_изображение | струна | URL-адрес изображения, отправляемого в модель. Полностью квалифицированный URL-адрес или изображение, закодированное в формате Base64 в URL-адресе данных. | нет | |
| type | перечисление | Тип входного элемента. Всегда input_image.Возможные значения: input_image |
Да |
OpenAI.ItemContentInputText
Текстовые входные данные модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| текст | струна | Текстовые входные данные модели. | Да | |
| type | перечисление | Тип входного элемента. Всегда input_text.Возможные значения: input_text |
Да |
OpenAI.ItemContentOutputAudio
Выходные данные звука из модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | струна | Звуковые данные в кодировке Base64 из модели. | Да | |
| transcript | струна | Расшифровка звуковых данных из модели. | Да | |
| type | перечисление | Тип выходного звука. Всегда output_audio.Возможные значения: output_audio |
Да |
OpenAI.ItemContentOutputText
Текстовые выходные данные модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| аннотации | массив | Заметки к выходным данным текста. | Да | |
| logprobs | массив | нет | ||
| текст | струна | Текстовые выходные данные модели. | Да | |
| type | перечисление | Тип выходного текста. Всегда output_text.Возможные значения: output_text |
Да |
OpenAI.ItemContentRefusal
Отказ модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| отказ | струна | Объяснение отказа от модели. | Да | |
| type | перечисление | Тип отказа. Всегда refusal.Возможные значения: refusal |
Да |
OpenAI.ItemContentType
Много модальное содержимое входных и выходных данных.
| Недвижимость | Ценность |
|---|---|
| Описание | Много модальное содержимое входных и выходных данных. |
| Тип | струна |
| Значения | input_textinput_audioinput_imageinput_fileoutput_textoutput_audiorefusal |
OpenAI.ItemParam
Элемент содержимого, используемый для создания ответа.
Дискриминатор для OpenAI.ItemParam
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
file_search_call |
OpenAI.FileSearchToolCallItemParam |
computer_call |
OpenAI.ComputerToolCallItemParam |
computer_call_output |
OpenAI.ComputerToolCallOutputItemParam |
web_search_call |
OpenAI.WebSearchToolCallItemParam |
function_call |
OpenAI.FunctionToolCallItemParam |
function_call_output |
OpenAI.FunctionToolCallOutputItemParam |
reasoning |
OpenAI.ReasoningItemParam |
item_reference |
OpenAI.ItemReferenceItemParam |
image_generation_call |
OpenAI.ImageGenToolCallItemParam |
code_interpreter_call |
OpenAI.CodeInterpreterToolCallItemParam |
local_shell_call |
OpenAI.LocalShellToolCallItemParam |
local_shell_call_output |
OpenAI.LocalShellToolCallOutputItemParam |
mcp_list_tools |
OpenAI.MCPListToolsItemParam |
mcp_approval_request |
OpenAI.MCPApprovalRequestItemParam |
mcp_approval_response |
OpenAI.MCPApprovalResponseItemParam |
mcp_call |
OpenAI.MCPCallItemParam |
message |
OpenAI.ResponsesMessageItemParam |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ItemType | Да |
OpenAI.ItemReferenceItemParam
Внутренний идентификатор для ссылки на элемент.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| id | струна | Идентификатор, созданный службой и присвоенный ранее сгенерированному элементу ответа. | Да | |
| type | перечисление | Возможные значения: item_reference |
Да |
OpenAI.ItemResource
Элемент содержимого, используемый для создания ответа.
Дискриминатор для OpenAI.ItemResource
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
file_search_call |
OpenAI.FileSearchToolCallItemResource |
computer_call |
OpenAI.ComputerToolCallItemResource |
computer_call_output |
OpenAI.ComputerToolCallOutputItemResource |
web_search_call |
OpenAI.WebSearchToolCallItemResource |
function_call |
OpenAI.FunctionToolCallItemResource |
function_call_output |
OpenAI.FunctionToolCallOutputItemResource |
reasoning |
OpenAI.ReasoningItemResource |
image_generation_call |
OpenAI.ImageGenToolCallItemResource |
code_interpreter_call |
OpenAI.CodeInterpreterToolCallItemResource |
local_shell_call |
OpenAI.LocalShellToolCallItemResource |
local_shell_call_output |
OpenAI.LocalShellToolCallOutputItemResource |
mcp_list_tools |
OpenAI.MCPListToolsItemResource |
mcp_approval_request |
OpenAI.MCPApprovalRequestItemResource |
mcp_approval_response |
OpenAI.MCPApprovalResponseItemResource |
mcp_call |
OpenAI.MCPCallItemResource |
message |
OpenAI.ResponsesMessageItemResource |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| id | струна | Да | ||
| type | OpenAI.ItemType | Да |
OpenAI.ItemType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | messagefile_search_callfunction_callfunction_call_outputcomputer_callcomputer_call_outputweb_search_callreasoningitem_referenceimage_generation_callcode_interpreter_calllocal_shell_calllocal_shell_call_outputmcp_list_toolsmcp_approval_requestmcp_approval_responsemcp_call |
OpenAI.ListFineTuningJobCheckpointsResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Да | ||
| первый_идентификатор | струна | нет | ||
| есть_еще | булевый | Да | ||
| last_id | струна | нет | ||
| объект | перечисление | Возможные значения: list |
Да |
OpenAI.ListFineTuningJobEventsResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Да | ||
| есть_еще | булевый | Да | ||
| объект | перечисление | Возможные значения: list |
Да |
OpenAI.ListModelsResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Да | ||
| объект | перечисление | Возможные значения: list |
Да |
OpenAI.ListPaginatedFineTuningJobsResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Да | ||
| есть_еще | булевый | Да | ||
| объект | перечисление | Возможные значения: list |
Да |
OpenAI.ListVectorStoreFilesFilter
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | in_progresscompletedfailedcancelled |
OpenAI.ListVectorStoreFilesResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Да | ||
| первый_идентификатор | струна | Да | ||
| есть_еще | булевый | Да | ||
| last_id | струна | Да | ||
| объект | перечисление | Возможные значения: list |
Да |
OpenAI.ListVectorStoresResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Да | ||
| первый_идентификатор | струна | Да | ||
| есть_еще | булевый | Да | ||
| last_id | струна | Да | ||
| объект | перечисление | Возможные значения: list |
Да |
OpenAI.LocalShellExecAction
Выполните команду оболочки на сервере.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| command | массив | Выполняемая команда | Да | |
| окружение | объект | Переменные среды, заданные для команды. | Да | |
| таймаут_мс | целое число | Необязательное время ожидания в миллисекундах для команды. | нет | |
| type | перечисление | Тип действия локальной оболочки. Всегда exec.Возможные значения: exec |
Да | |
| Пользователь | струна | Необязательный пользователь для выполнения команды как. | нет | |
| working_directory | струна | Необязательный рабочий каталог для выполнения команды. | нет |
OpenAI.LocalShellTool
Средство, позволяющее модели выполнять команды оболочки в локальной среде.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Тип локального средства оболочки. Всегда local_shell.Возможные значения: local_shell |
Да |
OpenAI.LocalShellToolCallItemParam
Вызов средства для выполнения команды в локальной оболочке.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| действие | OpenAI.LocalShellExecAction | Выполните команду оболочки на сервере. | Да | |
| call_id | струна | Уникальный идентификатор вызова локального средства оболочки, созданного моделью. | Да | |
| type | перечисление | Возможные значения: local_shell_call |
Да |
OpenAI.LocalShellToolCallItemResource
Вызов средства для выполнения команды в локальной оболочке.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| действие | OpenAI.LocalShellExecAction | Выполните команду оболочки на сервере. | Да | |
| call_id | струна | Уникальный идентификатор вызова локального средства оболочки, созданного моделью. | Да | |
| статус | перечисление | Возможные значения: in_progress, completedincomplete |
Да | |
| type | перечисление | Возможные значения: local_shell_call |
Да |
OpenAI.LocalShellToolCallOutputItemParam
Выходные данные вызова локального средства оболочки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| output | струна | Строка JSON выходных данных вызова локального средства оболочки. | Да | |
| type | перечисление | Возможные значения: local_shell_call_output |
Да |
OpenAI.LocalShellToolCallOutputItemResource
Выходные данные вызова локального средства оболочки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| output | струна | Строка JSON выходных данных вызова локального средства оболочки. | Да | |
| статус | перечисление | Возможные значения: in_progress, completedincomplete |
Да | |
| type | перечисление | Возможные значения: local_shell_call_output |
Да |
OpenAI.Location
Дискриминатор для OpenAI.Location
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
approximate |
OpenAI.ApproximateLocation |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.LocationType | Да |
OpenAI.LocationType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | approximate |
OpenAI.LogProb
Вероятность использования маркера в журнале.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| байт | массив | Да | ||
| logprob | число/номер | Да | ||
| token | струна | Да | ||
| top_logprobs | массив | Да |
OpenAI.MCPApprovalRequestItemParam
Запрос на одобрение человеком вызова инструмента.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| arguments | струна | Строка JSON с аргументами для средства. | Да | |
| имя | струна | Имя запускаемого средства. | Да | |
| метка сервера | струна | Метка сервера MCP, выполняющего запрос. | Да | |
| type | перечисление | Возможные значения: mcp_approval_request |
Да |
OpenAI.MCPApprovalRequestItemResource
Запрос на одобрение человеком вызова инструмента.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| arguments | струна | Строка JSON с аргументами для средства. | Да | |
| имя | струна | Имя запускаемого средства. | Да | |
| метка сервера | струна | Метка сервера MCP, выполняющего запрос. | Да | |
| type | перечисление | Возможные значения: mcp_approval_request |
Да |
OpenAI.MCPApprovalResponseItemParam
Ответ на запрос на утверждение MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| approval_request_id | струна | Идентификатор запроса на утверждение, на который даётся ответ. | Да | |
| Утвердить | булевый | Будет ли утвержден запрос. | Да | |
| причина | струна | Необязательная причина решения. | нет | |
| type | перечисление | Возможные значения: mcp_approval_response |
Да |
OpenAI.MCPApprovalResponseItemResource
Ответ на запрос на утверждение MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| approval_request_id | струна | Идентификатор запроса на утверждение, на который даётся ответ. | Да | |
| Утвердить | булевый | Будет ли утвержден запрос. | Да | |
| причина | струна | Необязательная причина решения. | нет | |
| type | перечисление | Возможные значения: mcp_approval_response |
Да |
OpenAI.MCPCallItemParam
Вызов инструмента на сервере MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| arguments | струна | Строка JSON аргументов, переданных средству. | Да | |
| ошибка | струна | Ошибка при вызове инструмента, если таковая имеется. | нет | |
| имя | струна | Имя запущенного инструмента. | Да | |
| output | струна | Выходные данные вызова инструмента. | нет | |
| метка сервера | струна | Метка сервера MCP, на котором работает инструмент. | Да | |
| type | перечисление | Возможные значения: mcp_call |
Да |
OpenAI.MCPCallItemResource
Вызов инструмента на сервере MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| arguments | струна | Строка JSON аргументов, переданных средству. | Да | |
| ошибка | струна | Ошибка при вызове инструмента, если таковая имеется. | нет | |
| имя | струна | Имя запущенного инструмента. | Да | |
| output | струна | Выходные данные вызова инструмента. | нет | |
| метка сервера | струна | Метка сервера MCP, на котором работает инструмент. | Да | |
| type | перечисление | Возможные значения: mcp_call |
Да |
OpenAI.MCPListToolsItemParam
Список средств, доступных на сервере MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ошибка | струна | Сообщение об ошибке, если сервер не смог перечислить инструменты. | нет | |
| метка сервера | струна | Метка сервера MCP. | Да | |
| инструменты | массив | Средства, доступные на сервере. | Да | |
| type | перечисление | Возможные значения: mcp_list_tools |
Да |
OpenAI.MCPListToolsItemResource
Список средств, доступных на сервере MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| ошибка | струна | Сообщение об ошибке, если сервер не смог перечислить инструменты. | нет | |
| метка сервера | струна | Метка сервера MCP. | Да | |
| инструменты | массив | Средства, доступные на сервере. | Да | |
| type | перечисление | Возможные значения: mcp_list_tools |
Да |
OpenAI.MCPListToolsTool
Средство, доступное на сервере MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| аннотации | Дополнительные заметки о инструменте. | нет | ||
| описание | струна | Описание средства. | нет | |
| input_schema | Схема JSON, описывающая входные данные средства. | Да | ||
| имя | струна | Имя средства. | Да |
OpenAI.MCPTool
Предоставьте модели access дополнительным средствам через удаленные серверы протокола контекста модели (MCP).
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| разрешённые_инструменты | объект | нет | ||
| └tool_names | массив | Список разрешенных имен инструментов. | нет | |
| headers | объект | Необязательные заголовки HTTP для отправки на сервер MCP. Используется для проверки подлинности или других целей. | нет | |
| требовать_одобрение | object (см. допустимые модели ниже) | Укажите, какие средства сервера MCP требуют утверждения. | нет | |
| метка сервера | струна | Метка для этого сервера MCP, используемая для идентификации его в вызовах инструментов. | Да | |
| URL сервера | струна | URL-адрес сервера MCP. | Да | |
| type | перечисление | Тип средства MCP. Всегда mcp.Возможные значения: mcp |
Да |
OpenAI.MetadataPropertyForRequest
Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга.
Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет |
OpenAI.Model
Описывает предложение модели OpenAI, которое можно использовать с API.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано | целое число | Метка времени Unix (в секундах) при создании модели. | Да | |
| id | струна | Идентификатор модели, на который можно ссылаться в конечных точках API. | Да | |
| объект | перечисление | Тип объекта, который всегда является моделью. Возможные значения: model |
Да | |
| owned_by | струна | Организация, которая владеет моделью. | Да |
OpenAI.OtherChunkingStrategyResponseParam
Это возвращается, когда стратегия блокирования неизвестна. Как правило, это связано с тем, что файл был индексирован до chunking_strategy появления концепции в API.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Всегда other.Возможные значения: other |
Да |
OpenAI.ParallelToolCalls
Следует ли включить параллельные вызовы функций во время использования средства.
Тип: логический
OpenAI.Prompt
Ссылка на шаблон запроса и его переменные.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| id | струна | Уникальный идентификатор используемого шаблона запроса. | Да | |
| переменные | объект | Необязательная карта значений для замены переменных в запросе. Значения подстановки могут быть строками или другими типами входных данных ответа, такими как изображения или файлы. | нет | |
| version | струна | Необязательная версия шаблона запроса. | нет |
OpenAI.RankingOptions
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| офицер | перечисление | Рангер, используемый для поиска файлов. Возможные значения: auto, default-2024-11-15 |
нет | |
| порог оценки | число/номер | Пороговое значение оценки для поиска файлов — от 0 до 1. Числа ближе к 1 будут пытаться вернуть только наиболее релевантные результаты, но могут возвращать меньше результатов. | нет |
OpenAI.Reasoning
Только модели o-серии
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| effort | объект |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
нет | |
| generate_summary | перечисление |
Не рекомендуется: используйте summary вместо этого.Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| summary | перечисление | Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет |
OpenAI.ReasoningEffort
Только модели o-серии
Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе.
| Недвижимость | Ценность |
|---|---|
| Описание |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
| Тип | струна |
| Значения | lowmediumhigh |
OpenAI.ReasoningItemParam
Описание цепочки мысли, используемой моделью причин при создании ответа. Не забудьте включить эти элементы в input API ответов для последующих поворотов беседы, если вы вручную управляете контекстом.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| encrypted_content | струна | Зашифрованное содержимое элемента логики — заполняется при создании ответа с помощью reasoning.encrypted_content в параметре include. |
нет | |
| summary | массив | Обоснование содержимого текста. | Да | |
| type | перечисление | Возможные значения: reasoning |
Да |
OpenAI.ReasoningItemResource
Описание цепочки мысли, используемой моделью причин при создании ответа. Не забудьте включить эти элементы в input API ответов для последующих поворотов беседы, если вы вручную управляете контекстом.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| encrypted_content | струна | Зашифрованное содержимое элемента логики — заполняется при создании ответа с помощью reasoning.encrypted_content в параметре include. |
нет | |
| summary | массив | Обоснование содержимого текста. | Да | |
| type | перечисление | Возможные значения: reasoning |
Да |
OpenAI.ReasoningItemSummaryPart
Дискриминатор для OpenAI.ReasoningItemSummaryPart
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
summary_text |
OpenAI.ReasoningItemSummaryTextPart |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ReasoningItemSummaryPartType | Да |
OpenAI.ReasoningItemSummaryPartType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | summary_text |
OpenAI.ReasoningItemSummaryTextPart
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| текст | струна | Да | ||
| type | перечисление | Возможные значения: summary_text |
Да |
OpenAI.Response
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| создано_в | целое число | Метка времени в формате Unix (в секундах), когда был создан этот ответ. | Да | |
| ошибка | объект | Объект ошибки, возвращаемый, когда модель не сможет создать ответ. | Да | |
| └─ Код | OpenAI.ResponseErrorCode | Код ошибки для ответа. | нет | |
| Сообщение └️ | струна | Описание ошибки, доступной для чтения человеком. | нет | |
| id | струна | Уникальный идентификатор для этого ответа. | Да | |
| incomplete_details | объект | Сведения о том, почему ответ неполный. | Да | |
| └─ Причина | перечисление | Причина, по которой ответ является неполным. Возможные значения: max_output_tokens, content_filter |
нет | |
| instructions | строка или массив | Да | ||
| max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| объект | перечисление | Тип объекта этого ресурса — всегда установлено response.Возможные значения: response |
Да | |
| output | массив | Массив элементов контента, созданных моделью. — длина и порядок элементов в массиве output зависит от ответа модели.— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK. |
Да | |
| output_text | струна | Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.Поддерживается в пакетах SDK для Python и JavaScript. |
нет | |
| вызовы инструмента в параллельном режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | Да | True |
| previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| prompt | объект | Ссылка на шаблон запроса и его переменные. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор используемого шаблона запроса. | нет | |
| Переменные └️ | OpenAI.ResponsePromptVariables | Необязательная карта значений для замены переменных в запросе. Значения подстановки могут быть строками или другими типами входных данных ответа, такими как изображения или файлы. | нет | |
| Версия └️ | струна | Необязательная версия шаблона запроса. | нет | |
| reasoning | объект |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| - усилия | OpenAI.ReasoningEffort |
Только модели o-серии Ограничивает усилия по рассуждениям моделей. В настоящее время поддерживаются lowзначения , mediumи high. Сокращение усилий по поводу может привести к более быстрым откликам и меньшем количестве маркеров, используемых при рассуждениях в ответе. |
нет | |
| └─generate_summary | перечисление |
Не рекомендуется: используйте summary вместо этого.Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| └️ сводка | перечисление | Сводка умозаключений, сделанных моделью. Это может быть полезно для отладки и понимания процесса рассуждений модели. Один из auto, concise, или detailed.Возможные значения: auto, concisedetailed |
нет | |
| статус | перечисление | Статус формирования ответа. Один из completed, failed, in_progress, cancelled, queued, incomplete или .Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete |
нет | |
| Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
Да | |
| текст | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| выбор инструмента | объект | Определяет, какое средство (если таковое) вызывается моделью.none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.required означает, что модель должна вызывать один или несколько инструментов. |
нет | |
| └─ Тип | OpenAI.ToolChoiceObjectType | Указывает, что модель должна использовать встроенное средство для создания ответа. | нет | |
| инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели. |
нет | |
| top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
Да | |
| truncation | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| использование | OpenAI.ResponseUsage | Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры. | нет | |
| Пользователь | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | Да |
OpenAI.ResponseCodeInterpreterCallCodeDeltaEvent
Создается при потоковой передаче фрагмента частичного кода интерпретатором кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| delta | струна | Фрагмент частичного кода, передаваемый интерпретатором кода. | Да | |
| item_id | струна | Уникальный идентификатор элемента вызова средства интерпретатора кода. | Да | |
| output_index | целое число | Индекс выходного элемента в ответе, для которого выполняется потоковая передача кода. | Да | |
| type | перечисление | тип события; Всегда response.code_interpreter_call_code.delta.Возможные значения: response.code_interpreter_call_code.delta |
Да |
OpenAI.ResponseCodeInterpreterCallCodeDoneEvent
Создается при завершении фрагмента кода интерпретатором кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | струна | Окончательный фрагмент кода выводится интерпретатором кода. | Да | |
| item_id | струна | Уникальный идентификатор элемента вызова средства интерпретатора кода. | Да | |
| output_index | целое число | Индекс выходного элемента в ответе, для которого завершен код. | Да | |
| type | перечисление | тип события; Всегда response.code_interpreter_call_code.done.Возможные значения: response.code_interpreter_call_code.done |
Да |
OpenAI.ResponseCodeInterpreterCallCompletedEvent
Эмитируется при завершении вызова интерпретатора кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор элемента вызова средства интерпретатора кода. | Да | |
| output_index | целое число | Индекс выходного элемента в ответе, для которого выполняется вызов интерпретатора кода. | Да | |
| type | перечисление | тип события; Всегда response.code_interpreter_call.completed.Возможные значения: response.code_interpreter_call.completed |
Да |
OpenAI.ResponseCodeInterpreterCallInProgressEvent
Срабатывает при выполнении вызова интерпретатора кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор элемента вызова средства интерпретатора кода. | Да | |
| output_index | целое число | Индекс выходного элемента в ответе, для которого выполняется вызов интерпретатора кода. | Да | |
| type | перечисление | тип события; Всегда response.code_interpreter_call.in_progress.Возможные значения: response.code_interpreter_call.in_progress |
Да |
OpenAI.ResponseCodeInterpreterCallInterpretingEvent
Создается, когда интерпретатор кода активно интерпретирует фрагмент кода.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор элемента вызова средства интерпретатора кода. | Да | |
| output_index | целое число | Индекс выходного элемента в ответе, для которого интерпретатор кода интерпретирует код. | Да | |
| type | перечисление | тип события; Всегда response.code_interpreter_call.interpreting.Возможные значения: response.code_interpreter_call.interpreting |
Да |
OpenAI.ResponseCompletedEvent
Выдается при завершении ответа модели.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| response | объект | Да | ||
| └─ Фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| └️ created_at | целое число | Метка времени в формате Unix (в секундах), когда был создан этот ответ. | нет | |
| └─ Ошибка | OpenAI.ResponseError | Объект ошибки, возвращаемый, когда модель не сможет создать ответ. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор для этого ответа. | нет | |
| └️ incomplete_details | объект | Сведения о том, почему ответ неполный. | нет | |
| └─ Причина | перечисление | Причина, по которой ответ является неполным. Возможные значения: max_output_tokens, content_filter |
нет | |
| └ Инструкции | строка или массив | Сообщение системы (или разработчика), вставленное в контекст модели. При использовании вместе с previous_response_id инструкциями из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах. |
нет | |
| └️ max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| └️ max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| └─ Метаданные | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| └─ Объект | перечисление | Тип объекта этого ресурса — всегда установлено response.Возможные значения: response |
нет | |
| вывод └─ | массив | Массив элементов контента, созданных моделью. — длина и порядок элементов в массиве output зависит от ответа модели.— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK. |
нет | |
| └️ output_text | струна | Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.Поддерживается в пакетах SDK для Python и JavaScript. |
нет | |
| └─ вызовы_инструментов_в_параллельном_режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | нет | True |
| └previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| └─ Запрос | OpenAI.Prompt | Ссылка на шаблон запроса и его переменные. | нет | |
| └─ рассуждения | OpenAI.Reasoning |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| └─ Состояние | перечисление | Статус формирования ответа. Один из completed, failed, in_progress, cancelled, queued, incomplete или .Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete |
нет | |
| └─ Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | |
| Текст └️ | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| └─ выбор_инструмента | OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceObject | Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать. |
нет | |
| └─ Инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели. |
нет | |
| └️ top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| └️ top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | |
| └️ усечение | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| └─ использование | OpenAI.ResponseUsage | Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры. | нет | |
| Пользователь └️ | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет | |
| type | перечисление | тип события; Всегда response.completed.Возможные значения: response.completed |
Да |
OpenAI.ResponseContentPartAddedEvent
Вызывается при добавлении новой части содержимого.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| content_index | целое число | Индекс добавленной части содержимого. | Да | |
| item_id | струна | Идентификатор выходного элемента, к которому была добавлена часть содержимого. | Да | |
| output_index | целое число | Индекс выходного элемента, к которому была добавлена часть содержимого. | Да | |
| part | объект | Да | ||
| └─ Тип | OpenAI.ItemContentType | Много модальное содержимое входных и выходных данных. | нет | |
| type | перечисление | тип события; Всегда response.content_part.added.Возможные значения: response.content_part.added |
Да |
OpenAI.ResponseContentPartDoneEvent
Выдается при завершении части содержимого.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| content_index | целое число | Индекс завершенной части содержимого. | Да | |
| item_id | струна | Идентификатор выходного элемента, к которому была добавлена часть содержимого. | Да | |
| output_index | целое число | Индекс выходного элемента, к которому была добавлена часть содержимого. | Да | |
| part | объект | Да | ||
| └─ Тип | OpenAI.ItemContentType | Много модальное содержимое входных и выходных данных. | нет | |
| type | перечисление | тип события; Всегда response.content_part.done.Возможные значения: response.content_part.done |
Да |
OpenAI.ResponseCreatedEvent
Событие, которое эмитируется при создании ответа.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| response | объект | Да | ||
| └─ Фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| └️ created_at | целое число | Метка времени в формате Unix (в секундах), когда был создан этот ответ. | нет | |
| └─ Ошибка | OpenAI.ResponseError | Объект ошибки, возвращаемый, когда модель не сможет создать ответ. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор для этого ответа. | нет | |
| └️ incomplete_details | объект | Сведения о том, почему ответ неполный. | нет | |
| └─ Причина | перечисление | Причина, по которой ответ является неполным. Возможные значения: max_output_tokens, content_filter |
нет | |
| └ Инструкции | строка или массив | Сообщение системы (или разработчика), вставленное в контекст модели. При использовании вместе с previous_response_id инструкциями из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах. |
нет | |
| └️ max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| └️ max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| └─ Метаданные | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| └─ Объект | перечисление | Тип объекта этого ресурса — всегда установлено response.Возможные значения: response |
нет | |
| вывод └─ | массив | Массив элементов контента, созданных моделью. — длина и порядок элементов в массиве output зависит от ответа модели.— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK. |
нет | |
| └️ output_text | струна | Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.Поддерживается в пакетах SDK для Python и JavaScript. |
нет | |
| └─ вызовы_инструментов_в_параллельном_режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | нет | True |
| └previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| └─ Запрос | OpenAI.Prompt | Ссылка на шаблон запроса и его переменные. | нет | |
| └─ рассуждения | OpenAI.Reasoning |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| └─ Состояние | перечисление | Статус формирования ответа. Один из completed, failedin_progress, cancelled, queued или incomplete.Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete |
нет | |
| └─ Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | |
| Текст └️ | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| └─ выбор_инструмента | OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceObject | Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать. |
нет | |
| └─ Инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели. |
нет | |
| └️ top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| └️ top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | |
| └️ усечение | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| └─ использование | OpenAI.ResponseUsage | Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры. | нет | |
| Пользователь └️ | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет | |
| type | перечисление | тип события; Всегда response.created.Возможные значения: response.created |
Да |
OpenAI.ResponseError
Объект ошибки, возвращаемый, когда модель не сможет создать ответ.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | OpenAI.ResponseErrorCode | Код ошибки для ответа. | Да | |
| сообщение | струна | Описание ошибки, доступной для чтения человеком. | Да |
OpenAI.ResponseErrorCode
Код ошибки для ответа.
| Недвижимость | Ценность |
|---|---|
| Описание | Код ошибки для ответа. |
| Тип | струна |
| Значения | server_errorrate_limit_exceededinvalid_promptvector_store_timeoutinvalid_imageinvalid_image_formatinvalid_base64_imageinvalid_image_urlimage_too_largeimage_too_smallimage_parse_errorimage_content_policy_violationinvalid_image_modeimage_file_too_largeunsupported_image_media_typeempty_image_filefailed_to_download_imageimage_file_not_found |
OpenAI.ResponseErrorEvent
Эмитируется при возникновении ошибки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| код | струна | Код ошибки. | Да | |
| сообщение | струна | Сообщение об ошибке. | Да | |
| параметр | струна | Параметр ошибки. | Да | |
| type | перечисление | тип события; Всегда error.Возможные значения: error |
Да |
OpenAI.ResponseFailedEvent
Событие, которое возникает при сбое ответа.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| response | объект | Да | ||
| └─ Фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| └️ created_at | целое число | Метка времени в формате Unix (в секундах), когда был создан этот ответ. | нет | |
| └─ Ошибка | OpenAI.ResponseError | Объект ошибки, возвращаемый, когда модель не сможет создать ответ. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор для этого ответа. | нет | |
| └️ incomplete_details | объект | Сведения о том, почему ответ неполный. | нет | |
| └─ Причина | перечисление | Причина, по которой ответ является неполным. Возможные значения: max_output_tokens, content_filter |
нет | |
| └ Инструкции | строка или массив | Сообщение системы (или разработчика), вставленное в контекст модели. При использовании вместе с previous_response_id инструкциями из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах. |
нет | |
| └️ max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| └️ max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| └─ Метаданные | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| └─ Объект | перечисление | Тип объекта этого ресурса — всегда установлено response.Возможные значения: response |
нет | |
| вывод └─ | массив | Массив элементов контента, созданных моделью. — длина и порядок элементов в массиве output зависит от ответа модели.— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK. |
нет | |
| └️ output_text | струна | Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.Поддерживается в пакетах SDK для Python и JavaScript. |
нет | |
| └─ вызовы_инструментов_в_параллельном_режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | нет | True |
| └previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| └─ Запрос | OpenAI.Prompt | Ссылка на шаблон запроса и его переменные. | нет | |
| └─ рассуждения | OpenAI.Reasoning |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| └─ Состояние | перечисление | Статус формирования ответа. Один из completed, failed, in_progress, cancelled, queued, incomplete или .Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete |
нет | |
| └─ Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | |
| Текст └️ | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| └─ выбор_инструмента | OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceObject | Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать. |
нет | |
| └─ Инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели. |
нет | |
| └️ top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| └️ top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | |
| └️ усечение | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| └─ использование | OpenAI.ResponseUsage | Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры. | нет | |
| Пользователь └️ | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет | |
| type | перечисление | тип события; Всегда response.failed.Возможные значения: response.failed |
Да |
OpenAI.ResponseFileSearchCallCompletedEvent
Создается при завершении вызова поиска файлов (найденные результаты).
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Идентификатор выходного элемента, инициируемого вызовом поиска файлов. | Да | |
| output_index | целое число | Индекс выходного элемента, инициируемого вызовом поиска файлов. | Да | |
| type | перечисление | тип события; Всегда response.file_search_call.completed.Возможные значения: response.file_search_call.completed |
Да |
OpenAI.ResponseFileSearchCallInProgressEvent
Срабатывает при инициализации вызова поиска файлов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Идентификатор выходного элемента, инициируемого вызовом поиска файлов. | Да | |
| output_index | целое число | Индекс выходного элемента, инициируемого вызовом поиска файлов. | Да | |
| type | перечисление | тип события; Всегда response.file_search_call.in_progress.Возможные значения: response.file_search_call.in_progress |
Да |
OpenAI.ResponseFileSearchCallSearchingEvent
Генерируется во время текущего поиска файла.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Идентификатор выходного элемента, инициируемого вызовом поиска файлов. | Да | |
| output_index | целое число | Индекс выходного элемента, вызываемого вызовом поиска файлов. | Да | |
| type | перечисление | тип события; Всегда response.file_search_call.searching.Возможные значения: response.file_search_call.searching |
Да |
OpenAI.ResponseFormat
Дискриминация для OpenAI.ResponseFormat
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
text |
OpenAI.ResponseFormatText |
json_object |
OpenAI.ResponseFormatJsonObject |
json_schema |
OpenAI.ResponseFormatJsonSchema |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: text, json_objectjson_schema |
Да |
OpenAI.ResponseFormatJsonObject
Формат отклика объекта JSON. Старый метод создания ответов JSON.
Рекомендуется использовать json_schema для моделей, поддерживающих его. Обратите внимание, что модель не будет создавать JSON без системного или пользовательского сообщения, в результате чего оно to do.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Тип определяемого формата ответа. Всегда json_object.Возможные значения: json_object |
Да |
OpenAI.ResponseFormatJsonSchema
Формат ответа схемы JSON. Используется для создания структурированных ответов JSON.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| JSON-схема | объект | Параметры конфигурации структурированных выходных данных, включая схему JSON. | Да | |
| └─ Описание | струна | Описание формата ответа, которое используется моделью для определения того, как отвечать в этом формате. | нет | |
| └️ имя | струна | Имя формата ответа. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. | нет | |
| └─ Схема | OpenAI.ResponseFormatJsonSchema | Схема формата ответа, описанная как объект схемы JSON. Узнайте, как создать схемы JSON здесь. |
нет | |
| └─ строгий | булевый | Следует ли включить строгое соблюдение схемы при создании выходных данных. Если задано значение true, модель всегда будет соответствовать точной схеме, определенной schema в поле. Только подмножество схемы JSON поддерживается, если stricttrue. |
нет | Неправда |
| type | перечисление | Тип определяемого формата ответа. Всегда json_schema.Возможные значения: json_schema |
Да |
OpenAI.ResponseFormatJsonSchema
Схема формата ответа, описанная как объект схемы JSON. Узнайте, как создать схемы JSON здесь.
Тип: объект
OpenAI.ResponseFormatText
Формат ответа по умолчанию. Используется для создания текстовых ответов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Тип определяемого формата ответа. Всегда text.Возможные значения: text |
Да |
OpenAI.ResponseFunctionCallArgumentsDeltaEvent
Создается при наличии разностных аргументов вызова функции.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| delta | струна | Добавлен аргумент вызова функции, представляющий дельту. | Да | |
| item_id | струна | Идентификатор выходного элемента, к которому добавляется дельта аргументов вызова функции. | Да | |
| output_index | целое число | Индекс выходного элемента, к которому добавляется разность аргументов вызова функции. | Да | |
| type | перечисление | тип события; Всегда response.function_call_arguments.delta.Возможные значения: response.function_call_arguments.delta |
Да |
OpenAI.ResponseFunctionCallArgumentsDoneEvent
Вызывается, когда аргументы вызова функции завершены.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| arguments | струна | Аргументы вызова функции. | Да | |
| item_id | струна | Идентификатор элемента. | Да | |
| output_index | целое число | Индекс выходного элемента. | Да | |
| type | перечисление | Возможные значения: response.function_call_arguments.done |
Да |
OpenAI.ResponseImageGenCallCompletedEvent
Сигнализируется при завершении вызова инструмента генерации изображений и доступности окончательного изображения.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор обрабатываемого элемента создания изображения. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| type | перечисление | тип события; Всегда "response.image_generation_call.completed". Возможные значения: response.image_generation_call.completed |
Да |
OpenAI.ResponseImageGenCallGeneratingEvent
При вызове средства генерации изображений происходит генерация изображения (промежуточное состояние).
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор обрабатываемого элемента создания изображения. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| type | перечисление | тип события; Всегда «response.image_generation_call.generating». Возможные значения: response.image_generation_call.generating |
Да |
OpenAI.ResponseImageGenCallInProgressEvent
Излучается, когда происходит вызов средства создания изображений.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор обрабатываемого элемента создания изображения. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| type | перечисление | тип события; Всегда «response.image_generation_call.in_progress». Возможные значения: response.image_generation_call.in_progress |
Да |
OpenAI.ResponseImageGenCallPartialImageEvent
Создается при наличии частичного образа во время потоковой передачи изображений.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор обрабатываемого элемента создания изображения. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| partial_image_b64 | струна | Данные частичного изображения в кодировке Base64, которые могут быть отображены как изображение. | Да | |
| partial_image_index | целое число | 0-й индекс для частичного изображения (серверная часть использует индекс, начинающийся с 1, но для пользователя это начинается с 0). | Да | |
| type | перечисление | тип события; Всегда "response.image_generation_call.partial_image". Возможные значения: response.image_generation_call.partial_image |
Да |
OpenAI.ResponseInProgressEvent
Генерируется во время обработки ответа.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| response | объект | Да | ||
| └─ Фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| └️ created_at | целое число | Метка времени в формате Unix (в секундах), когда был создан этот ответ. | нет | |
| └─ Ошибка | OpenAI.ResponseError | Объект ошибки, возвращаемый, когда модель не сможет создать ответ. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор для этого ответа. | нет | |
| └️ incomplete_details | объект | Сведения о том, почему ответ неполный. | нет | |
| └─ Причина | перечисление | Причина, по которой ответ является неполным. Возможные значения: max_output_tokens, content_filter |
нет | |
| └ Инструкции | строка или массив | Сообщение системы (или разработчика), вставленное в контекст модели. При использовании вместе с previous_response_id инструкциями из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах. |
нет | |
| └️ max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| └️ max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| └─ Метаданные | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| └─ Объект | перечисление | Тип объекта этого ресурса — всегда установлено response.Возможные значения: response |
нет | |
| вывод └─ | массив | Массив элементов контента, созданных моделью. — длина и порядок элементов в массиве output зависит от ответа модели.— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK. |
нет | |
| └️ output_text | струна | Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.Поддерживается в пакетах SDK для Python и JavaScript. |
нет | |
| └─ вызовы_инструментов_в_параллельном_режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | нет | True |
| └previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| └─ Запрос | OpenAI.Prompt | Ссылка на шаблон запроса и его переменные. | нет | |
| └─ рассуждения | OpenAI.Reasoning |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| └─ Состояние | перечисление | Статус формирования ответа. Один из completed, failed, in_progress, cancelled, queued, incomplete или .Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete |
нет | |
| └─ Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | |
| Текст └️ | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| └─ выбор_инструмента | OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceObject | Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать. |
нет | |
| └─ Инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели. |
нет | |
| └️ top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| └️ top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | |
| └️ усечение | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| └─ использование | OpenAI.ResponseUsage | Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры. | нет | |
| Пользователь └️ | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет | |
| type | перечисление | тип события; Всегда response.in_progress.Возможные значения: response.in_progress |
Да |
OpenAI.ResponseIncompleteEvent
Событие, которое возникает, когда ответ завершается неполным.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| response | объект | Да | ||
| └─ Фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| └️ created_at | целое число | Метка времени в формате Unix (в секундах), когда был создан этот ответ. | нет | |
| └─ Ошибка | OpenAI.ResponseError | Объект ошибки, возвращаемый, когда модель не сможет создать ответ. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор для этого ответа. | нет | |
| └️ incomplete_details | объект | Сведения о том, почему ответ неполный. | нет | |
| └─ Причина | перечисление | Причина, по которой ответ является неполным. Возможные значения: max_output_tokens, content_filter |
нет | |
| └ Инструкции | строка или массив | Сообщение системы (или разработчика), вставленное в контекст модели. При использовании вместе с previous_response_id инструкциями из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах. |
нет | |
| └️ max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| └️ max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| └─ Метаданные | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| └─ Объект | перечисление | Тип объекта этого ресурса — всегда установлено response.Возможные значения: response |
нет | |
| вывод └─ | массив | Массив элементов контента, созданных моделью. — длина и порядок элементов в массиве output зависит от ответа модели.— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK. |
нет | |
| └️ output_text | струна | Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.Поддерживается в пакетах SDK для Python и JavaScript. |
нет | |
| └─ вызовы_инструментов_в_параллельном_режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | нет | True |
| └previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| └─ Запрос | OpenAI.Prompt | Ссылка на шаблон запроса и его переменные. | нет | |
| └─ рассуждения | OpenAI.Reasoning |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| └─ Состояние | перечисление | Статус формирования ответа. Один из completed, failed, in_progress, cancelled, queued, incomplete или .Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete |
нет | |
| └─ Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | |
| Текст └️ | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| └─ выбор_инструмента | OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceObject | Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать. |
нет | |
| └─ Инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели. |
нет | |
| └️ top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| └️ top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | |
| └️ усечение | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| └─ использование | OpenAI.ResponseUsage | Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры. | нет | |
| Пользователь └️ | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет | |
| type | перечисление | тип события; Всегда response.incomplete.Возможные значения: response.incomplete |
Да |
OpenAI.ResponseItemList
Список элементов ответа.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Список элементов, используемых для создания этого ответа. | Да | |
| первый_идентификатор | струна | Идентификатор первого элемента в списке. | Да | |
| есть_еще | булевый | Доступны ли дополнительные элементы. | Да | |
| last_id | струна | Идентификатор последнего элемента в списке. | Да | |
| объект | перечисление | Тип возвращаемого объекта должен быть list.Возможные значения: list |
Да |
OpenAI.ResponseMCPCallArgumentsDeltaEvent
Выдается, когда происходит разностное (частичное) обновление аргументов вызова средства MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| delta | Частичное обновление аргументов для вызова средства MCP. | Да | ||
| item_id | струна | Уникальный идентификатор обрабатываемого элемента вызова средства MCP. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| type | перечисление | тип события; Всегда «response.mcp_call.arguments_delta». Возможные значения: response.mcp_call.arguments_delta |
Да |
OpenAI.ResponseMCPCallArgumentsDoneEvent
Генерируется, когда аргументы для вызова инструмента MCP завершены.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| arguments | Окончательные аргументы для вызова инструмента MCP. | Да | ||
| item_id | струна | Уникальный идентификатор обрабатываемого элемента вызова средства MCP. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| type | перечисление | тип события; Всегда "response.mcp_call.arguments_done". Возможные значения: response.mcp_call.arguments_done |
Да |
OpenAI.ResponseMCPCallCompletedEvent
Срабатывает при успешном выполнении вызова средства MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | тип события; Всегда «response.mcp_call.completed». Возможные значения: response.mcp_call.completed |
Да |
OpenAI.ResponseMCPCallFailedEvent
Создается при сбое вызова средства MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | тип события; Всегда "response.mcp_call.failed". Возможные значения: response.mcp_call.failed |
Да |
OpenAI.ResponseMCPCallInProgressEvent
Испускается в процессе выполнения вызова средства MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор обрабатываемого элемента вызова средства MCP. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| type | перечисление | тип события; Всегда "response.mcp_call.in_progress". Возможные значения: response.mcp_call.in_progress |
Да |
OpenAI.ResponseMCPListToolsCompletedEvent
Инициируется при успешном получении списка доступных средств MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | тип события; Всегда "response.mcp_list_tools.completed". Возможные значения: response.mcp_list_tools.completed |
Да |
OpenAI.ResponseMCPListToolsFailedEvent
Возникает при сбое попытки перечисления доступных средств MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | тип события; Всегда "response.mcp_list_tools.failed". Возможные значения: response.mcp_list_tools.failed |
Да |
OpenAI.ResponseMCPListToolsInProgressEvent
Подается сигнал, когда система находится в процессе получения списка доступных инструментов MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | тип события; Всегда "response.mcp_list_tools.in_progress". Возможные значения: response.mcp_list_tools.in_progress |
Да |
OpenAI.ResponseOutputItemAddedEvent
Создается при добавлении нового выходного элемента.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item | объект | Элемент содержимого, используемый для создания ответа. | Да | |
| Идентификатор └️ | струна | нет | ||
| └─ Тип | OpenAI.ItemType | нет | ||
| output_index | целое число | Индекс добавленного выходного элемента. | Да | |
| type | перечисление | тип события; Всегда response.output_item.added.Возможные значения: response.output_item.added |
Да |
OpenAI.ResponseOutputItemDoneEvent
Излучается, когда выходной элемент помечен как завершенный.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item | объект | Элемент содержимого, используемый для создания ответа. | Да | |
| Идентификатор └️ | струна | нет | ||
| └─ Тип | OpenAI.ItemType | нет | ||
| output_index | целое число | Индекс выходного элемента, помеченного как выполненный. | Да | |
| type | перечисление | тип события; Всегда response.output_item.done.Возможные значения: response.output_item.done |
Да |
OpenAI.ResponsePromptVariables
Необязательная карта значений для замены переменных в запросе. Значения подстановки могут быть строками или другими типами входных данных ответа, такими как изображения или файлы.
Тип: объект
OpenAI.ResponseQueuedEvent
Возникает, когда ответ поставлен в очередь и ожидает обработки.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| response | объект | Да | ||
| └─ Фон | булевый | Запускать ли ответ модели в фоновом режиме. | нет | Неправда |
| └️ created_at | целое число | Метка времени в формате Unix (в секундах), когда был создан этот ответ. | нет | |
| └─ Ошибка | OpenAI.ResponseError | Объект ошибки, возвращаемый, когда модель не сможет создать ответ. | нет | |
| Идентификатор └️ | струна | Уникальный идентификатор для этого ответа. | нет | |
| └️ incomplete_details | объект | Сведения о том, почему ответ неполный. | нет | |
| └─ Причина | перечисление | Причина, по которой ответ является неполным. Возможные значения: max_output_tokens, content_filter |
нет | |
| └ Инструкции | строка или массив | Сообщение системы (или разработчика), вставленное в контекст модели. При использовании вместе с previous_response_id инструкциями из предыдущего ответа не будут перенесены в следующий ответ. Это упрощает замену системных сообщений (или сообщений разработчиками) в новых ответах. |
нет | |
| └️ max_output_tokens | целое число | Верхняя граница для числа маркеров, которые можно создать для ответа, включая видимые выходные маркеры и маркеры причин | нет | |
| └️ max_tool_calls | целое число | Максимальное количество общих вызовов встроенных инструментов, которые могут обрабатываться в ответе. Это максимальное число применяется ко всем встроенным вызовам инструментов, а не для каждого отдельного средства. Любые дальнейшие попытки вызова средства моделью будут игнорироваться. | нет | |
| └─ Метаданные | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| └─ Объект | перечисление | Тип объекта этого ресурса — всегда установлено response.Возможные значения: response |
нет | |
| вывод └─ | массив | Массив элементов контента, созданных моделью. — длина и порядок элементов в массиве output зависит от ответа модели.— Вместо доступа к первому элементу output массива и предположения, что это assistant сообщение с содержимым, созданным моделью, попробуйте использовать свойство output_text, где это поддержано в пакетах SDK. |
нет | |
| └️ output_text | струна | Доступное только для пакета SDK свойство, содержащее агрегированные текстовые выходные данные всех output_text элементов в массиве output , если они присутствуют.Поддерживается в пакетах SDK для Python и JavaScript. |
нет | |
| └─ вызовы_инструментов_в_параллельном_режиме | булевый | Следует ли разрешить модели запускать вызовы инструментов параллельно. | нет | True |
| └previous_response_id | струна | Уникальный идентификатор предыдущего ответа на модель. Используйте эту функцию для создания многоэтапных бесед. | нет | |
| └─ Запрос | OpenAI.Prompt | Ссылка на шаблон запроса и его переменные. | нет | |
| └─ рассуждения | OpenAI.Reasoning |
Только модели o-серии Параметры конфигурации для моделей рассуждений. |
нет | |
| └─ Состояние | перечисление | Статус формирования ответа. Один из completed, failed, in_progress, cancelled, queued, incomplete или .Возможные значения: completed, failed, in_progress, cancelled, queued, incomplete |
нет | |
| └─ Температура | число/номер | Какая температура выборки используется в диапазоне от 0 до 2. Более высокие значения, такие как 0,8, делают выходные данные более случайными, а более низкие значения, такие как 0,2, делают его более ориентированным и детерминированным. Как правило, мы рекомендуем изменить это или top_p не оба. |
нет | |
| Текст └️ | объект | Параметры конфигурации для текстового ответа модели. Можно использовать обычный текст или структурированные данные JSON. | нет | |
| └─ Формат | OpenAI.ResponseTextFormatConfiguration | нет | ||
| └─ выбор_инструмента | OpenAI.ToolChoiceOptions или OpenAI.ToolChoiceObject | Как модель должна выбрать средство (или инструменты), которое следует использовать при создании ответа. Просмотрите tools параметр, чтобы узнать, как указать, какие средства модель может вызывать. |
нет | |
| └─ Инструменты | массив | Массив инструментов, которые модель может вызывать при создании ответа. Можно указать, какое средство следует использовать, задав tool_choice параметр.Ниже приведены две категории инструментов, которые можно предоставить модели: - Встроенные средства: средства, предоставляемые OpenAI, которые расширяют возможности модели. |
нет | |
| └️ top_logprobs | целое число | Целое число от 0 до 20, указывающее число наиболее вероятных маркеров, возвращаемых по каждой позиции маркера, каждый из которых имеет связанную вероятность журнала. | нет | |
| └️ top_p | число/номер | Альтернативой выборке с температурой является так называемая выборка ядра, где модель рассматривает результаты маркеров с top_p всего массива значений вероятности. Таким образом, 0,1 означает, что учитываются только маркеры, входящие в верхние 10% массива значений вероятности. Как правило, мы рекомендуем изменить это или temperature не оба. |
нет | |
| └️ усечение | перечисление | Стратегия усечения, которую следует использовать для генерирования ответа модели. - auto: если контекст этого ответа и предыдущих превышает размер окна контекста модели, модель усечет ответ, чтобы он соответствовал этому окну, удаляя элементы ввода в середине беседы.- disabled (по умолчанию): если ответ модели превысит размер окна контекста для модели, запрос завершится ошибкой 400.Возможные значения: auto, disabled |
нет | |
| └─ использование | OpenAI.ResponseUsage | Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры. | нет | |
| Пользователь └️ | струна | Уникальный идентификатор, представляющий пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления. | нет | |
| type | перечисление | тип события; Всегда «response.queued». Возможные значения: response.queued |
Да |
OpenAI.ResponseReasoningDeltaEvent
Генерируется при изменении (частичном обновлении) содержимого рассуждений.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| content_index | целое число | Индекс содержательного аспекта рассуждений в выходном элементе. | Да | |
| delta | Частичное обновление содержания рассуждения. | Да | ||
| item_id | струна | Уникальный идентификатор элемента, по которому обновляется обоснование. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| type | перечисление | тип события; Всегда "response.reasoning.delta". Возможные значения: response.reasoning.delta |
Да |
OpenAI.ResponseReasoningDoneEvent
Генерируется при завершении логического содержимого для элемента.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| content_index | целое число | Индекс содержательного аспекта рассуждений в выходном элементе. | Да | |
| item_id | струна | Уникальный идентификатор элемента, по которому завершается обоснование. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| текст | струна | Завершенный текст обоснования. | Да | |
| type | перечисление | тип события; Всегда "response.reasoning.done". Возможные значения: response.reasoning.done |
Да |
OpenAI.ResponseReasoningSummaryDeltaEvent
Выдается при неполном обновлении содержания резюме рассуждений.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| delta | Частичное обновление содержимого сводки причин. | Да | ||
| item_id | струна | Уникальный идентификатор элемента, для которого обновляется сводка по причинам. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| summary_index | целое число | Индекс сводной части в выходном элементе. | Да | |
| type | перечисление | тип события; Всегда "response.reasoning_summary.delta". Возможные значения: response.reasoning_summary.delta |
Да |
OpenAI.ResponseReasoningSummaryDoneEvent
Испускается, когда завершено содержимое сводки рассуждений для элемента.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор элемента, для которого завершается сводка причин. | Да | |
| output_index | целое число | Индекс выходного элемента в выходном массиве ответа. | Да | |
| summary_index | целое число | Индекс сводной части в выходном элементе. | Да | |
| текст | струна | Завершенный текст резюме рассуждений. | Да | |
| type | перечисление | тип события; Всегда "response.reasoning_summary.готово". Возможные значения: response.reasoning_summary.done |
Да |
OpenAI.ResponseReasoningSummaryPartAddedEvent
Выдается при добавлении нового раздела резюме рассуждений.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Идентификатор элемента, с которым связана эта сводная часть. | Да | |
| output_index | целое число | Индекс выходного элемента, с которым связана сводная часть. | Да | |
| part | объект | Да | ||
| └─ Тип | OpenAI.ReasoningItemSummaryPartType | нет | ||
| summary_index | целое число | Индекс сводной части в обобщении рассуждений. | Да | |
| type | перечисление | тип события; Всегда response.reasoning_summary_part.added.Возможные значения: response.reasoning_summary_part.added |
Да |
OpenAI.ResponseReasoningSummaryPartDoneEvent
Испускается при завершении части обоснования.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Идентификатор элемента, с которым связана эта сводная часть. | Да | |
| output_index | целое число | Индекс выходного элемента, с которым связана сводная часть. | Да | |
| part | объект | Да | ||
| └─ Тип | OpenAI.ReasoningItemSummaryPartType | нет | ||
| summary_index | целое число | Индекс сводной части в обобщении рассуждений. | Да | |
| type | перечисление | тип события; Всегда response.reasoning_summary_part.done.Возможные значения: response.reasoning_summary_part.done |
Да |
OpenAI.ResponseReasoningSummaryTextDeltaEvent
Создается при добавлении разностного изменения в текст сводной информации.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| delta | струна | Изменения текста, добавленные в сводку. | Да | |
| item_id | струна | Идентификатор элемента, с которым связана разность текста сводки. | Да | |
| output_index | целое число | Индекс выходного элемента, с которым связана дельта сводного текста. | Да | |
| summary_index | целое число | Индекс сводной части в обобщении рассуждений. | Да | |
| type | перечисление | тип события; Всегда response.reasoning_summary_text.delta.Возможные значения: response.reasoning_summary_text.delta |
Да |
OpenAI.ResponseReasoningSummaryTextDoneEvent
Генерируется при завершении сводного текста аргументирования.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Идентификатор элемента, с которым связан текст сводки. | Да | |
| output_index | целое число | Индекс выходного элемента, с которым связан сводный текст. | Да | |
| summary_index | целое число | Индекс сводной части в обобщении рассуждений. | Да | |
| текст | струна | Полный текст завершенной сводки об обосновании. | Да | |
| type | перечисление | тип события; Всегда response.reasoning_summary_text.done.Возможные значения: response.reasoning_summary_text.done |
Да |
OpenAI.ResponseRefusalDeltaEvent
Срабатывает при наличии частичного текста отказа.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| content_index | целое число | Индекс части содержимого, в которую добавляется текст отказа. | Да | |
| delta | струна | Добавлен текст отказа. | Да | |
| item_id | струна | Идентификатор выходного элемента, к которому добавляется текст отказа. | Да | |
| output_index | целое число | Индекс выходного элемента, к которому добавляется текст отказа. | Да | |
| type | перечисление | тип события; Всегда response.refusal.delta.Возможные значения: response.refusal.delta |
Да |
OpenAI.ResponseRefusalDoneEvent
Воспроизводится, когда текст отказа окончательно сформирован.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| content_index | целое число | Индекс части содержимого, завершаемой текстом отказа. | Да | |
| item_id | струна | Идентификатор выходного элемента, имеющего окончательный текст отказа. | Да | |
| output_index | целое число | Индекс выходного элемента, для которого текст отказа завершён. | Да | |
| отказ | струна | Текст отказа, завершенный. | Да | |
| type | перечисление | тип события; Всегда response.refusal.done.Возможные значения: response.refusal.done |
Да |
OpenAI.ResponseStreamEvent
Дискриминатор для OpenAI.ResponseStreamEvent
Этот компонент использует свойство type для дискриминации между различными типами:
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| sequence_number | целое число | Порядковый номер для этого события. | Да | |
| type | OpenAI.ResponseStreamEventType | Да |
OpenAI.ResponseStreamEventType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | response.audio.deltaresponse.audio.doneresponse.audio_transcript.deltaresponse.audio_transcript.doneresponse.code_interpreter_call_code.deltaresponse.code_interpreter_call_code.doneresponse.code_interpreter_call.completedresponse.code_interpreter_call.in_progressresponse.code_interpreter_call.interpretingresponse.completedresponse.content_part.addedresponse.content_part.doneresponse.createderrorresponse.file_search_call.completedresponse.file_search_call.in_progressresponse.file_search_call.searchingresponse.function_call_arguments.deltaresponse.function_call_arguments.doneresponse.in_progressresponse.failedresponse.incompleteresponse.output_item.addedresponse.output_item.doneresponse.refusal.deltaresponse.refusal.doneresponse.output_text.annotation.addedresponse.output_text.deltaresponse.output_text.doneresponse.reasoning_summary_part.addedresponse.reasoning_summary_part.doneresponse.reasoning_summary_text.deltaresponse.reasoning_summary_text.doneresponse.web_search_call.completedresponse.web_search_call.in_progressresponse.web_search_call.searchingresponse.image_generation_call.completedresponse.image_generation_call.generatingresponse.image_generation_call.in_progressresponse.image_generation_call.partial_imageresponse.mcp_call.arguments_deltaresponse.mcp_call.arguments_doneresponse.mcp_call.completedresponse.mcp_call.failedresponse.mcp_call.in_progressresponse.mcp_list_tools.completedresponse.mcp_list_tools.failedresponse.mcp_list_tools.in_progressresponse.queuedresponse.reasoning.deltaresponse.reasoning.doneresponse.reasoning_summary.deltaresponse.reasoning_summary.done |
OpenAI.ResponseTextDeltaEvent
Создается при наличии дополнительного разностного текста.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| content_index | целое число | Индекс части содержимого, в которую была добавлена текстовая дельта. | Да | |
| delta | струна | Добавлена разностная строка текста. | Да | |
| item_id | струна | Идентификатор выходного элемента, к которому была добавлена текстовая дельта. | Да | |
| output_index | целое число | Индекс выходного элемента, к которому был добавлен разностный текст. | Да | |
| type | перечисление | тип события; Всегда response.output_text.delta.Возможные значения: response.output_text.delta |
Да |
OpenAI.ResponseTextDoneEvent
Излучается при завершении работы с текстовым содержимым.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| content_index | целое число | Индекс части содержимого, где завершается текстовое содержимое. | Да | |
| item_id | струна | Идентификатор выходного элемента, для которого завершается текстовое содержимое. | Да | |
| output_index | целое число | Индекс выходного элемента, в котором завершается текстовое содержимое. | Да | |
| текст | струна | Текстовое содержимое, завершенное. | Да | |
| type | перечисление | тип события; Всегда response.output_text.done.Возможные значения: response.output_text.done |
Да |
OpenAI.ResponseTextFormatConfiguration
Дискриминатор для OpenAI.ResponseTextFormatConfiguration
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
text |
OpenAI.ResponseTextFormatConfigurationText |
json_object |
OpenAI.ResponseTextFormatConfigurationJsonObject |
json_schema |
Конфигурация текстового формата ответа OpenAI (OpenAI.ResponseTextFormatConfigurationJsonSchema) |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ResponseTextFormatConfigurationType | Объект, указывающий формат, который должен выводить модель. Настройка { "type": "json_schema" } включает структурированные выходные данные, что гарантирует, что модель будет соответствовать предоставленной схеме JSON. Формат по умолчанию — это { "type": "text" } без дополнительных параметров.Не рекомендуется использовать для gpt-4o и более новых моделей: Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его. |
Да |
OpenAI.ResponseTextFormatConfigurationJsonObject (формат конфигурации объекта JSON ответа)
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: json_object |
Да |
OpenAI.ResponseTextFormatConfigurationJsonSchema
Формат ответа схемы JSON. Используется для создания структурированных ответов JSON.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| описание | струна | Описание формата ответа, которое используется моделью для определения того, как отвечать в этом формате. | нет | |
| имя | струна | Имя формата ответа. Должен быть a-z, A-Z, 0-9 или содержать символы подчеркивания и дефисы с максимальной длиной 64. | Да | |
| schema | OpenAI.ResponseFormatJsonSchema | Схема формата ответа, описанная как объект схемы JSON. Узнайте, как создать схемы JSON здесь. |
Да | |
| строгий | булевый | Следует ли включить строгое соблюдение схемы при создании выходных данных. Если задано значение true, модель всегда будет соответствовать точной схеме, определенной schema в поле. Только подмножество схемы JSON поддерживается, если stricttrue. |
нет | Неправда |
| type | перечисление | Тип определяемого формата ответа. Всегда json_schema.Возможные значения: json_schema |
Да |
OpenAI.ResponseTextFormatConfigurationText
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: text |
Да |
OpenAI.ResponseTextFormatConfigurationType
Объект, указывающий формат, который должен выводить модель.
Настройка { "type": "json_schema" } включает структурированные выходные данные, что гарантирует, что модель будет соответствовать предоставленной схеме JSON.
Формат по умолчанию — это { "type": "text" } без дополнительных параметров.
Не рекомендуется использовать для gpt-4o и более новых моделей:
Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schema предпочтительнее для моделей, поддерживающих его.
| Недвижимость | Ценность |
|---|---|
| Описание | Объект, указывающий формат, который должен выводить модель. |
Настройка { "type": "json_schema" } включает структурированные выходные данные, что гарантирует, что модель будет соответствовать предоставленной схеме JSON.
Формат по умолчанию — это { "type": "text" } без дополнительных параметров.
Не рекомендуется использовать для gpt-4o и более новых моделей:
Настройка для { "type": "json_object" } включает старый режим JSON, который гарантирует, что создаваемое моделью сообщение является допустимым JSON. Использование json_schemaпредпочтительнее для моделей, поддерживающих его.
OpenAI.ResponseUsage
Представляет сведения об использовании маркеров, включая входные маркеры, выходные маркеры, разбивку выходных маркеров и общие используемые маркеры.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| input_tokens | целое число | Количество входных токенов. | Да | |
| input_tokens_details | объект | Подробная разбивка входных токенов. | Да | |
| └ cached_tokens | целое число | Количество токенов, полученных из кэша. | нет | |
| output_tokens | целое число | Количество выходных токенов. | Да | |
| output_tokens_details | объект | Подробная разбивка выходных маркеров. | Да | |
| └️ reasoning_tokens | целое число | Количество токенов рассуждения. | нет | |
| общее количество токенов | целое число | Общее количество используемых токенов. | Да |
OpenAI.ResponseWebSearchCallCompletedEvent
Примечание. web_search еще не доступна через Azure OpenAI.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор выходного элемента, связанного с вызовом веб-поиска. | Да | |
| output_index | целое число | Индекс выходного элемента, с которым связан вызов веб-поиска. | Да | |
| type | перечисление | тип события; Всегда response.web_search_call.completed.Возможные значения: response.web_search_call.completed |
Да |
OpenAI.ResponseWebSearchCallInProgressEvent
Примечание. web_search еще не доступна через Azure OpenAI.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор выходного элемента, связанного с вызовом веб-поиска. | Да | |
| output_index | целое число | Индекс выходного элемента, с которым связан вызов веб-поиска. | Да | |
| type | перечисление | тип события; Всегда response.web_search_call.in_progress.Возможные значения: response.web_search_call.in_progress |
Да |
OpenAI.ResponseWebSearchCallSearchingEvent
Примечание. web_search еще не доступна через Azure OpenAI.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| item_id | струна | Уникальный идентификатор выходного элемента, связанного с вызовом веб-поиска. | Да | |
| output_index | целое число | Индекс выходного элемента, с которым связан вызов веб-поиска. | Да | |
| type | перечисление | тип события; Всегда response.web_search_call.searching.Возможные значения: response.web_search_call.searching |
Да |
OpenAI.ResponsesAssistantMessageItemParam
Элемент параметра сообщения с ролью assistant .
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое, связанное с сообщением. | Да | |
| роль | перечисление | Роль сообщения, которая всегда assistant.Возможные значения: assistant |
Да |
OpenAI.ResponsesAssistantMessageItemResource
Элемент сообщения из ресурса с ролью assistant.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое, связанное с сообщением. | Да | |
| роль | перечисление | Роль сообщения, которая всегда assistant.Возможные значения: assistant |
Да |
OpenAI.ResponsesDeveloperMessageItemParam
Элемент параметра сообщения с ролью developer .
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое, связанное с сообщением. | Да | |
| роль | перечисление | Роль сообщения, которая всегда developer.Возможные значения: developer |
Да |
OpenAI.ResponsesDeveloperMessageItemResource
Элемент сообщения из ресурса с ролью developer.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое, связанное с сообщением. | Да | |
| роль | перечисление | Роль сообщения, которая всегда developer.Возможные значения: developer |
Да |
OpenAI.ResponsesMessageItemParam
Элемент сообщения ответа, представляющий роль и содержимое, как указано в параметрах запроса клиента.
Дискриминатор для OpenAI.ResponsesMessageItemParam
Этот компонент использует свойство role для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
user |
OpenAI.ResponsesUserMessageItemParam |
system |
OpenAI.ResponsesSystemMessageItemParam |
developer |
OpenAI.ResponsesDeveloperMessageItemParam |
assistant |
OpenAI.ResponsesAssistantMessageItemParam |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| роль | объект | Коллекция допустимых ролей для элементов сообщений, связанных с ответами. | Да | |
| type | перечисление | Тип элемента ответа, который всегда является сообщением. Возможные значения: message |
Да |
OpenAI.ResponsesMessageItemResource
Элемент ресурса ответа, представляющий роль и содержимое сообщения ответа, как указано в ответах службы.
Дискриминатор для OpenAI.ResponsesMessageItemResource
Этот компонент использует свойство role для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
user |
OpenAI.ResponsesUserMessageItemResource |
system |
OpenAI.ResponsesSystemMessageItemResource |
developer |
OpenAI.ResponsesDeveloperMessageItemResource |
assistant |
OpenAI.ResponsesAssistantMessageItemResource |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| роль | объект | Коллекция допустимых ролей для элементов сообщений, связанных с ответами. | Да | |
| статус | перечисление | Состояние элемента. Один из in_progress, completed, или incomplete. Заполняется, когда элементы возвращаются через API.Возможные значения: in_progress, completedincomplete |
Да | |
| type | перечисление | Тип элемента ответа, который всегда является сообщением. Возможные значения: message |
Да |
OpenAI.ResponsesMessageRole
Коллекция допустимых ролей для элементов сообщений, связанных с ответами.
| Недвижимость | Ценность |
|---|---|
| Описание | Коллекция допустимых ролей для элементов сообщений, связанных с ответами. |
| Тип | струна |
| Значения | systemdeveloperuserassistant |
OpenAI.ResponsesSystemMessageItemParam
Элемент параметра сообщения с ролью system .
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое, связанное с сообщением. | Да | |
| роль | перечисление | Роль сообщения, которая всегда system.Возможные значения: system |
Да |
OpenAI.ResponsesSystemMessageItemResource
Элемент сообщения из ресурса с ролью system.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое, связанное с сообщением. | Да | |
| роль | перечисление | Роль сообщения, которая всегда system.Возможные значения: system |
Да |
OpenAI.ResponsesUserMessageItemParam
Элемент параметра сообщения с ролью user .
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое, связанное с сообщением. | Да | |
| роль | перечисление | Роль сообщения, которая всегда user.Возможные значения: user |
Да |
OpenAI.ResponsesUserMessageItemResource
Элемент сообщения из ресурса с ролью user.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| содержимое | массив | Содержимое, связанное с сообщением. | Да | |
| роль | перечисление | Роль сообщения, которая всегда user.Возможные значения: user |
Да |
OpenAI.RunGraderRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| грейдер | объект | Объект StringCheckGrader, выполняющий сравнение строк между входами и ссылкой с помощью указанной операции. | Да | |
| └calculate_output calculate_output | струна | Формула для вычисления выходных данных на основе результатов оценки. | нет | |
| └️ evaluation_metric | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
нет | |
| └️ классировщиков | объект | нет | ||
| └image_tag | струна | Тег изображения, используемый для скрипта Python. | нет | |
| └─ Входные данные | массив | Входной текст. Это может включать строки шаблона. | нет | |
| └─ Модель | струна | Модель, используемая для оценки. | нет | |
| └️ имя | струна | Имя классировщика. | нет | |
| Операция └️ | перечисление | Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.Возможные значения: eq, , nelikeilike |
нет | |
| Диапазон └️ | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| Справочник по └️ | струна | Текст, классируемый против. | нет | |
| └─sampling_params | Параметры выборки для модели. | нет | ||
| └─ Источник | струна | Исходный код скрипта Python. | нет | |
| └─ Тип | перечисление | Тип объекта, который всегда multiявляется .Возможные значения: multi |
нет | |
| item | Элемент набора данных, предоставленный классировщику. Это будет использоваться для заполнения item пространства имен. |
нет | ||
| model_sample | струна | Пример модели, который необходимо оценить. Это значение будет использоваться для заполнения sample пространства имен. Переменная output_json будет заполнена, если пример модели является допустимой строкой JSON. |
Да |
OpenAI.RunGraderResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| metadata | объект | Да | ||
| Ошибки └️ | объект | нет | ||
| └formula_parse_error | булевый | нет | ||
| └️ invalid_variable_error | булевый | нет | ||
| └model_grader_parse_error | булевый | нет | ||
| └model_grader_refusal_error model_grader_refusal_error | булевый | нет | ||
| └model_grader_server_error | булевый | нет | ||
| └model_grader_server_error_details | струна | нет | ||
| └️ other_error | булевый | нет | ||
| └python_grader_runtime_error | булевый | нет | ||
| └️ python_grader_runtime_error_details | струна | нет | ||
| └python_grader_server_error | булевый | нет | ||
| └️ python_grader_server_error_type | струна | нет | ||
| └sample_parse_error | булевый | нет | ||
| └truncated_observation_error | булевый | нет | ||
| └unresponsive_reward_error | булевый | нет | ||
| └execution_time execution_time | число/номер | нет | ||
| └️ имя | струна | нет | ||
| └️ sampled_model_name | струна | нет | ||
| Оценки └️ | нет | |||
| └token_usage | целое число | нет | ||
| └─ Тип | струна | нет | ||
| model_grader_token_usage_per_model | Да | |||
| награда | число/номер | Да | ||
| sub_rewards | Да |
OpenAI.StaticChunkingStrategy
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| chunk_overlap_tokens | целое число | Количество маркеров, перекрывающихся между блоками. Значение по умолчанию — 400.Обратите внимание, что перекрытие не должно превышать половину max_chunk_size_tokens. |
Да | |
| max_chunk_size_tokens | целое число | Максимальное количество токенов в каждом блоке. Значение по умолчанию — 800. Минимальное значение равно 100 , а максимальное — 4096. |
Да |
OpenAI.StaticChunkingStrategyRequestParam
Настройте собственную стратегию блокирования, задав размер блока и перекрытие блоков.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| статичный | OpenAI.StaticChunkingStrategy | Да | ||
| type | перечисление | Всегда static.Возможные значения: static |
Да |
OpenAI.StaticChunkingStrategyResponseParam
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| статичный | OpenAI.StaticChunkingStrategy | Да | ||
| type | перечисление | Всегда static.Возможные значения: static |
Да |
OpenAI.StopConfiguration
Не поддерживается с последними моделями рассуждений o3 и o4-mini.
До 4 последовательностей, в которых API перестанет создавать дополнительные маркеры. Возвращенный текст не будет содержать последовательность остановки.
Эта схема принимает один из следующих типов:
- string
- array
OpenAI.Tool
Дискриминатор для OpenAI.Инструмент
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
function |
OpenAI.FunctionTool |
file_search |
OpenAI.FileSearchTool |
computer_use_preview |
OpenAI.ComputerUsePreviewTool |
web_search_preview |
OpenAI.WebSearchPreviewTool |
code_interpreter |
OpenAI.CodeInterpreterTool |
image_generation |
OpenAI.ImageGenTool |
local_shell |
OpenAI.LocalShellTool |
mcp |
OpenAI.MCPTool |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ToolType | Средство, которое можно использовать для создания ответа. | Да |
OpenAI.ToolChoiceObject
Дискриминация для OpenAI.ToolChoiceObject
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
file_search |
OpenAI.ToolChoiceObjectFileSearch |
computer_use_preview |
OpenAI.ToolChoiceObjectComputer |
web_search_preview |
OpenAI.ToolChoiceObjectWebSearch |
image_generation |
OpenAI.ToolChoiceObjectImageGen |
code_interpreter |
OpenAI.ToolChoiceObjectCodeInterpreter |
function |
OpenAI.ToolChoiceObjectFunction |
mcp |
OpenAI.ToolChoiceObjectMCP |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.ToolChoiceObjectType | Указывает, что модель должна использовать встроенное средство для создания ответа. | Да |
OpenAI.ToolChoiceObjectCodeInterpreter
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: code_interpreter |
Да |
OpenAI.ToolChoiceObjectComputer
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: computer_use_preview |
Да |
OpenAI.ToolChoiceObjectFileSearch
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: file_search |
Да |
OpenAI.ToolChoiceObjectFunction
Используйте этот параметр, чтобы принудительно вызвать определенную функцию.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| имя | струна | Имя вызываемой функции. | Да | |
| type | перечисление | Для вызова функции тип всегда function.Возможные значения: function |
Да |
OpenAI.ToolChoiceObjectImageGen
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: image_generation |
Да |
OpenAI.ToolChoiceObjectMCP
Используйте этот параметр, чтобы принудительно вызвать определенное средство на удаленном сервере MCP.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| имя | струна | Имя средства для вызова на сервере. | нет | |
| метка сервера | струна | Метка используемого сервера MCP. | Да | |
| type | перечисление | Для инструментов MCP всегда используется mcpтип.Возможные значения: mcp |
Да |
OpenAI.ToolChoiceObjectType
Указывает, что модель должна использовать встроенное средство для создания ответа.
| Недвижимость | Ценность |
|---|---|
| Описание | Указывает, что модель должна использовать встроенное средство для создания ответа. |
| Тип | струна |
| Значения | file_searchfunctioncomputer_use_previewweb_search_previewimage_generationcode_interpretermcp |
OpenAI.ToolChoiceObjectWebSearch
Примечание. web_search еще не доступна через Azure OpenAI.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Возможные значения: web_search_preview |
Да |
OpenAI.ToolChoiceOptions
Определяет, какое средство (если таковое) вызывается моделью.
none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.
auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.
required означает, что модель должна вызывать один или несколько инструментов.
| Недвижимость | Ценность |
|---|---|
| Описание | Определяет, какое средство (если таковое) вызывается моделью.none означает, что модель не будет вызывать какое-либо средство и вместо этого создает сообщение.auto означает, что модель может выбирать между созданием сообщения или вызовом одного или нескольких инструментов.required означает, что модель должна вызывать один или несколько инструментов. |
| Тип | струна |
| Значения | noneautorequired |
OpenAI.ToolType
Средство, которое можно использовать для создания ответа.
| Недвижимость | Ценность |
|---|---|
| Описание | Средство, которое можно использовать для создания ответа. |
| Тип | струна |
| Значения | file_searchfunctioncomputer_use_previewweb_search_previewmcpcode_interpreterimage_generationlocal_shell |
OpenAI.TopLogProb
Верхняя вероятность использования маркера в журнале.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| байт | массив | Да | ||
| logprob | число/номер | Да | ||
| token | струна | Да |
OpenAI.TranscriptionAudioResponseFormat
Ссылки: OpenAI.AudioResponseFormat
OpenAI.TranscriptionInclude
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | logprobs |
OpenAI.TranscriptionSegment
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| avg_logprob | число/номер | Среднее значение logprob сегмента. Если значение меньше -1, рассмотрите сбой логарифмов. | Да | |
| коэффициент сжатия | число/номер | Коэффициент сжатия сегмента. Если значение больше 2,4, рассмотрите сбой сжатия. | Да | |
| конец | число/номер | Время окончания сегмента в секундах. | Да | |
| id | целое число | Уникальный идентификатор сегмента. | Да | |
| вероятность_отсутствия_речи | число/номер | Вероятность отсутствия речи в сегменте. Если значение выше 1,0 и avg_logprob ниже -1, рассмотрите этот сегмент безмолвно. |
Да | |
| seek | целое число | Поиск смещения сегмента. | Да | |
| начало | число/номер | Время начала сегмента в секундах. | Да | |
| Температура | число/номер | Параметр температуры, используемый для создания сегмента. | Да | |
| текст | струна | Текстовое содержимое сегмента. | Да | |
| tokens | массив | Массив идентификаторов маркеров для текстового содержимого. | Да |
OpenAI.TranscriptionWord
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| конец | число/номер | Время окончания слова в секундах. | Да | |
| начало | число/номер | Время начала слова в секундах. | Да | |
| word | струна | Текстовое содержимое слова. | Да |
OpenAI.TranslationAudioResponseFormat
Ссылки: OpenAI.AudioResponseFormat
OpenAI.UpdateVectorStoreFileAttributesRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| attributes | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами. | Да |
OpenAI.UpdateVectorStoreRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| истекает через | объект | Политика истечения срока действия для хранилища векторов. | нет | |
| Привязка └️ | перечисление | Метка времени привязки, после которой применяется политика истечения срока действия. Поддерживаемые привязки: last_active_at.Возможные значения: last_active_at |
нет | |
| └️ дней | целое число | Количество дней после истечения срока действия привязки хранилища векторов. | нет | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
нет | |
| имя | струна | Имя векторного хранилища. | нет |
OpenAI.VadConfig
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| prefix_padding_ms (предварительное заполнение в миллисекундах) | целое число | Длительность звука, которую нужно включить до речи, обнаруженной VAD (в миллисекундах). | нет | 300 |
| длительность_тишины_мс | целое число | Длительность молчания для обнаружения остановки речи (в миллисекундах). С более короткими значениями модель будет реагировать быстрее, но может вмешиваться при коротких паузах пользователя. |
нет | 200 |
| threshold | число/номер | Порог чувствительности (от 0.0 до 1.0) для обнаружения голосовой активности. Более высокий пороговый уровень потребует более громкого звука для активации модели, и таким образом модель может работать лучше в шумных средах. | нет | 0,5 |
| type | перечисление | Необходимо установить значение server_vad, чтобы включить ручное фрагментирование с использованием серверного VAD.Возможные значения: server_vad |
Да |
OpenAI.ValidateGraderRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| грейдер | объект | Объект StringCheckGrader, выполняющий сравнение строк между входами и ссылкой с помощью указанной операции. | Да | |
| └calculate_output calculate_output | струна | Формула для вычисления выходных данных на основе результатов оценки. | нет | |
| └️ evaluation_metric | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
нет | |
| └️ классировщиков | объект | нет | ||
| └image_tag | струна | Тег изображения, используемый для скрипта Python. | нет | |
| └─ Входные данные | массив | Входной текст. Это может включать строки шаблона. | нет | |
| └─ Модель | струна | Модель, используемая для оценки. | нет | |
| └️ имя | струна | Имя классировщика. | нет | |
| Операция └️ | перечисление | Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.Возможные значения: eq, , nelikeilike |
нет | |
| Диапазон └️ | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| Справочник по └️ | струна | Текст, классируемый против. | нет | |
| └─sampling_params | Параметры выборки для модели. | нет | ||
| └─ Источник | струна | Исходный код скрипта Python. | нет | |
| └─ Тип | перечисление | Тип объекта, который всегда multiявляется .Возможные значения: multi |
нет |
OpenAI.ValidateGraderResponse
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| грейдер | объект | Объект StringCheckGrader, выполняющий сравнение строк между входами и ссылкой с помощью указанной операции. | нет | |
| └calculate_output calculate_output | струна | Формула для вычисления выходных данных на основе результатов оценки. | нет | |
| └️ evaluation_metric | перечисление | Используемая метрика оценки. Один из fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, или rouge_l.Возможные значения: fuzzy_match, bleu, gleu, meteor, rouge_1, rouge_2, rouge_3, rouge_4, rouge_5, rouge_l |
нет | |
| └️ классировщиков | объект | нет | ||
| └image_tag | струна | Тег изображения, используемый для скрипта Python. | нет | |
| └─ Входные данные | массив | Входной текст. Это может включать строки шаблона. | нет | |
| └─ Модель | струна | Модель, используемая для оценки. | нет | |
| └️ имя | струна | Имя классировщика. | нет | |
| Операция └️ | перечисление | Операция проверки строки, которую нужно выполнить. Один из eq, nelikeили ilike.Возможные значения: eq, , nelikeilike |
нет | |
| Диапазон └️ | массив | Диапазон оценки. По умолчанию — [0, 1]. |
нет | |
| Справочник по └️ | струна | Текст, классируемый против. | нет | |
| └─sampling_params | Параметры выборки для модели. | нет | ||
| └─ Источник | струна | Исходный код скрипта Python. | нет | |
| └─ Тип | перечисление | Тип объекта, который всегда multiявляется .Возможные значения: multi |
нет |
OpenAI.VectorStoreExpirationAfter
Политика истечения срока действия для хранилища векторов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| anchor | перечисление | Метка времени привязки, после которой применяется политика истечения срока действия. Поддерживаемые привязки: last_active_at.Возможные значения: last_active_at |
Да | |
| Дни | целое число | Количество дней после истечения срока действия привязки хранилища векторов. | Да |
OpenAI.VectorStoreFileAttributes
Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами.
Тип: объект
OpenAI.VectorStoreFileBatchObject
Пакет файлов, присоединенных к хранилищу векторов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Метка времени Unix (в секундах) для создания пакета файлов векторного хранилища. | Да | |
| file_counts | объект | Да | ||
| └️ отменено | целое число | Количество файлов, которые были отменены. | нет | |
| └️ завершено | целое число | Количество обработанных файлов. | нет | |
| └─ Ошибка | целое число | Количество файлов, которые не удалось обработать. | нет | |
| └─ в процессе | целое число | Количество обрабатываемых файлов. | нет | |
| └─ всего | целое число | Общее количество файлов. | нет | |
| id | струна | Идентификатор, на который можно ссылаться в конечных точках API. | Да | |
| объект | перечисление | Тип объекта, который всегда vector_store.file_batchявляется .Возможные значения: vector_store.files_batch |
Да | |
| статус | перечисление | Состояние пакета векторного хранилища файлов, которые могут быть либо in_progress, completedcancelled либо failed.Возможные значения: in_progress, , completedcancelledfailed |
Да | |
| vector_store_id | струна | Идентификатор векторного хранилища, к которому подключен файл. | Да |
OpenAI.VectorStoreFileObject
Список файлов, подключенных к хранилищу векторов.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| attributes | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения могут быть строками с максимальной длиной 512 символов, логическими значениями или числами. | нет | |
| chunking_strategy | объект | нет | ||
| └─ Тип | перечисление | Возможные значения: static, other |
нет | |
| создано_в | целое число | Метка времени Unix (в секундах) для момента создания файла векторного хранилища. | Да | |
| id | струна | Идентификатор, на который можно ссылаться в конечных точках API. | Да | |
| last_error | объект | Последняя ошибка, связанная с этим файлом хранилища векторов.
null Если ошибок нет. |
Да | |
| └─ Код | перечисление | Один из server_error или rate_limit_exceeded.Возможные значения: server_error, unsupported_fileinvalid_file |
нет | |
| Сообщение └️ | струна | Описание ошибки, доступной для чтения человеком. | нет | |
| объект | перечисление | Тип объекта, который всегда vector_store.fileявляется .Возможные значения: vector_store.file |
Да | |
| статус | перечисление | Состояние файла векторного хранилища, который может быть либо in_progress, completedcancelledлибо failed.
completed Состояние указывает, что файл векторного хранилища готов к использованию.Возможные значения: in_progress, , completedcancelledfailed |
Да | |
| usage_bytes | целое число | Общее использование векторного хранилища в байтах. Обратите внимание, что это может отличаться от исходного размера файла. | Да | |
| vector_store_id | струна | Идентификатор векторного хранилища, к которому подключен файл. | Да |
OpenAI.VectorStoreObject
Векторное хранилище — это коллекция обработанных файлов, которые можно использовать file_search средством.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Метка времени Unix (в секундах) для создания векторного хранилища. | Да | |
| истекает через | OpenAI.VectorStoreExpirationAfter | Политика истечения срока действия для хранилища векторов. | нет | |
| срок_действия_до | целое число | Метка времени Unix (в секундах) для истечения срока действия хранилища векторов. | нет | |
| file_counts | объект | Да | ||
| └️ отменено | целое число | Количество отмененных файлов. | нет | |
| └️ завершено | целое число | Количество успешно обработанных файлов. | нет | |
| └─ Ошибка | целое число | Количество файлов, которые не удалось обработать. | нет | |
| └─ в процессе | целое число | Количество обрабатываемых файлов. | нет | |
| └─ всего | целое число | Общее количество файлов. | нет | |
| id | струна | Идентификатор, на который можно ссылаться в конечных точках API. | Да | |
| last_active_at | целое число | Метка времени Unix (в секундах) для последнего активного хранилища векторов. | Да | |
| metadata | объект | Набор из 16 пар "ключ-значение", которые могут быть присоединены к объекту. Это может быть полезно для хранения дополнительных сведений об объекте в структурированном формате и запроса на объекты через API или панель мониторинга. Ключи — это строки с максимальной длиной 64 символов. Значения — это строки с максимальной длиной 512 символов. |
Да | |
| имя | струна | Имя векторного хранилища. | Да | |
| объект | перечисление | Тип объекта, который всегда vector_storeявляется .Возможные значения: vector_store |
Да | |
| статус | перечисление | Состояние векторного хранилища, которое может быть либо expired, in_progressлибо completed. Состояние указывает, что хранилище векторов completed готово для использования.Возможные значения: expired, in_progresscompleted |
Да | |
| usage_bytes | целое число | Общее количество байтов, используемых файлами в хранилище векторов. | Да |
OpenAI.VoiceIdsShared
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | alloyashballadcoralechofableonyxnovasageshimmerverse |
OpenAI.WebSearchAction
Дискриминация для OpenAI.WebSearchAction
Этот компонент использует свойство type для дискриминации между различными типами:
| Значение типа | Схема |
|---|---|
find |
OpenAI.WebSearchActionFind |
open_page |
OpenAI.WebSearchActionOpenPage |
search |
OpenAI.WebSearchActionSearch |
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | OpenAI.WebSearchActionType | Да |
OpenAI.WebSearchActionFind
Тип действия "find": выполняет поиск шаблона на загруженной странице.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| шаблон | струна | Шаблон или текст для поиска на странице. | Да | |
| type | перечисление | Тип действия. Возможные значения: find |
Да | |
| URL-адрес | струна | URL-адрес страницы, найдите шаблон. | Да |
OpenAI.WebSearchActionOpenPage
Тип действия "open_page" — открывает определенный URL-адрес из результатов поиска.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| type | перечисление | Тип действия. Возможные значения: open_page |
Да | |
| URL-адрес | струна | URL-адрес, открытый моделью. | Да |
OpenAI.WebSearchActionSearch
Тип действия "поиск" — выполняет запрос веб-поиска.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| query | струна | Поисковый запрос. | Да | |
| type | перечисление | Тип действия. Возможные значения: search |
Да |
OpenAI.WebSearchActionType
| Недвижимость | Ценность |
|---|---|
| Тип | струна |
| Значения | searchopen_pagefind |
OpenAI.WebSearchPreviewTool
Примечание. web_search еще не доступна через Azure OpenAI.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| размер_контекста_поиска | перечисление | Рекомендации высокого уровня для объема пространства контекстного окна, используемого для поиска. Один из low, medium, или high.
medium — это значение по умолчанию.Возможные значения: low, mediumhigh |
нет | |
| type | перечисление | Тип средства поиска в Интернете. Один из web_search_preview или web_search_preview_2025_03_11.Возможные значения: web_search_preview |
Да | |
| местоположение пользователя | объект | нет | ||
| └─ Тип | OpenAI.LocationType | нет |
OpenAI.WebSearchToolCallItemParam
Примечание. web_search еще не доступна через Azure OpenAI.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| действие | объект | Да | ||
| └─ Тип | OpenAI.WebSearchActionType | нет | ||
| type | перечисление | Возможные значения: web_search_call |
Да |
OpenAI.WebSearchToolCallItemResource
Примечание. web_search еще не доступна через Azure OpenAI.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| действие | объект | Да | ||
| └─ Тип | OpenAI.WebSearchActionType | нет | ||
| статус | перечисление | Состояние вызова функции средства поиска в Интернете. Возможные значения: in_progress, , searchingcompletedfailed |
Да | |
| type | перечисление | Возможные значения: web_search_call |
Да |
PineconeChatDataSource
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| параметры | объект | Сведения о параметрах для управления использованием источника данных Pinecone. | Да | |
| └️ allow_partial_result | булевый | Если установлено значение true, система позволит использовать частичные результаты поиска, и запрос будет считаться неуспешным, если все частичные запросы окажутся неудачными. Если запрос не указан или указан как false, запрос завершится ошибкой, если любой поисковый запрос завершается ошибкой. | нет | Неправда |
| └─ проверка подлинности | объект | нет | ||
| └─ Ключ | струна | нет | ||
| └─ Тип | перечисление | Возможные значения: api_key |
нет | |
| └─ встраивание_зависимости | объект | Представление источника векторизации данных, который можно использовать как ресурс внедрения с источником данных. | нет | |
| └─ Тип | AzureChatDataSourceVectorizationSourceType | Идентификатор, различающий конкретный источник векторизации. | нет | |
| └─ среда | струна | Имя среды, используемое с Pinecone. | нет | |
| └─ сопоставление_полей | объект | Сопоставления полей для применения к данным, используемым источником данных Pinecone. Обратите внимание, что сопоставления полей содержимого необходимы для Pinecone. |
нет | |
| └─ поля_контента | массив | нет | ||
| └─content_fields_separator | струна | нет | ||
| └filepath_field | струна | нет | ||
| └─ название_поля | струна | нет | ||
| └─ поле_ссылки | струна | нет | ||
| └in_scope | булевый | Следует ли ограничить запросы использованием индексированных данных. | нет | |
| └─ включить_контексты | массив | Свойства контекста выходных данных, которые необходимо включить в ответ. По умолчанию запрашивается ссылка и намерение. |
нет | ['цитаты', 'намерение'] |
| └– index_name | струна | Имя используемого индекса базы данных Pinecone. | нет | |
| └max_search_queries | целое число | Максимальное количество перезаписанных запросов, которые должны отправляться поставщику поиска для одного сообщения пользователя. По умолчанию система сделает автоматическое определение. |
нет | |
| └️ строгость | целое число | Настроенная строгость фильтрации релевантности поиска. Более строгие критерии увеличат точность, но снизят полноту ответа. |
нет | |
| └top_n_documents | целое число | Настроено количество документов, которые нужно выделить в запросе. | нет | |
| type | перечисление | Идентификатор различаемого типа, который всегда является "pinecone". Возможные значения: pinecone |
Да |
Качество
Качество извлекаемого видео. Это указывает качество содержимого видео, которое должно быть возвращено.
| Недвижимость | Ценность |
|---|---|
| Описание | Качество извлекаемого видео. Это указывает качество содержимого видео, которое должно быть возвращено. |
| Тип | струна |
| Значения | highlow |
ResponseFormatJSONSchemaRequest
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| JSON-схема | объект | Схема JSON для формата ответа | Да | |
| type | перечисление | Тип формата ответа Возможные значения: json_schema |
Да |
ResponseModalities
Типы выходных данных, которые вы хотите, чтобы модель генерировала. Большинство моделей могут создавать текст, который по умолчанию:
["text"]
Модель gpt-4o-audio-preview также может использоваться для создания звука. Чтобы запросить, что эта модель создает как текстовые, так и звуковые ответы, можно использовать:
["text", "audio"]
Массив строк
SpeechGenerationResponseFormat
Поддерживаемые форматы выходных данных звука для преобразования текста в речь.
Этот компонент может быть одним из следующих компонентов:
VideoGeneration
Результат создания видео.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Время генерации видео. | Да | |
| height | целое число | Высота видео. | Да | |
| id | струна | Идентификатор поколения видео. | Да | |
| job_id | струна | Идентификатор задания по созданию видео для этого видео. | Да | |
| n_seconds | целое число | Длительность создания видео. | Да | |
| объект | перечисление | Возможные значения: video.generation |
Да | |
| prompt | струна | Запрос для создания видео. | Да | |
| Ширина | целое число | Ширина видео. | Да |
VideoGenerationJob
Задание создания видео.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| создано_в | целое число | Время создания задания. | Да | |
| срок_действия_до | целое число | Время автоматического удаления задания из службы. Содержимое видео и метаданные задания должны храниться до этой даты, чтобы избежать потери данных. | нет | |
| failure_reason | строка (см. допустимые модели ниже) | нет | ||
| завершено_в | целое число | Время завершения работы со всеми видеогенерациями. | нет | |
| Поколений | массив | Созданные видео для этого задания. Число зависит от заданного n_variants и успешности создания поколений. | нет | |
| height | целое число | Высота видео. | Да | |
| id | струна | Идентификатор задания. | Да | |
| inpaint_items | массив | Необязательные элементы для этого задания создания видео. | нет | |
| модель | струна | Имя развертывания, используемого для этого задания по созданию видео. | Да | |
| n_seconds | целое число | Длительность задания создания видео. | Да | |
| n_variants | целое число | Количество видео для создания в качестве вариантов для этого задания создания видео. | Да | |
| объект | перечисление | Возможные значения: video.generation.job |
Да | |
| prompt | струна | Запрос для задания создания видео. | Да | |
| статус | объект | Состояние задания создания видео. | Да | |
| Ширина | целое число | Высота видео. | Да |
VideoGenerationJobList
Список заданий создания видео.
| Имя. | Тип | Description | Обязательно | По умолчанию |
|---|---|---|---|---|
| данные | массив | Список заданий создания видео. | Да | |
| первый_идентификатор | струна | Идентификатор первого задания на текущей странице, если он доступен. | нет | |
| есть_еще | булевый | Флаг, указывающий, есть ли больше заданий после списка. | Да | |
| last_id | струна | Идентификатор последнего задания на текущей странице, если он доступен. | нет | |
| объект | перечисление | Возможные значения: list |
Да |
Дальнейшие шаги
Узнайте о моделях и тонкой настройке с помощью REST API. Узнайте больше о недоумение моделей, которые Azure OpenAI.