Skip to content

Создание структурированного вывода

POST
/v1/chat/completions
  • Укажите JSON Schema через response_format, чтобы ограничить структуру вывода модели
  • Поддерживается режим json_schema с strict: true для строгого следования schema
  • Непотоковый ответ; полное завершение, соответствующее schema, в одном ответе
  • Официальная документация: Structured Outputs

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object

Используемая модель. См. таблицу совместимости моделей с Chat API.

object[]
Required

Список сообщений в диалоге на данный момент.

Температура выборки от 0 до 2. Более высокие значения (напр. 0.8) делают вывод более случайным; более низкие (напр. 0.2) — более сфокусированным. Обычно рекомендуется менять либо это, либо top_p, но не оба.

Nucleus sampling alternative to temperature. The model considers tokens with top_p probability mass (e.g. 0.1 = top 10%). We generally recommend changing this or temperature, but not both.

По умолчанию 1. Сколько вариантов завершения чата генерировать для каждого входного сообщения.

Default false. For structured outputs, omit or set false to receive the full schema-compliant completion in one response.

По умолчанию null. До 4 последовательностей, при которых API прекращает генерацию токенов.

Default inf. Maximum tokens to generate in the completion.

Total length of input + output tokens is limited by the model context length.

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

По умолчанию 0. Число от -2.0 до 2.0. Положительные значения штрафуют токены по частоте в тексте, снижая повторения.

Modify the likelihood of specified tokens appearing in the completion.
Accepts a JSON object mapping token IDs to bias values from -100 to 100. Applied to logits before sampling; effect varies by model.

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

Формат вывода. { "type": "json_object" } включает JSON-режим. При JSON-режиме нужно также указать модели генерировать JSON в system/user сообщениях. С json_schema укажите schema и при необходимости strict: true для Structured Outputs.

Бета. При указании система старается детерминированно сэмплировать; следите за изменениями через system_fingerprint в ответе.

Список инструментов, которые может вызывать модель. Сейчас поддерживаются только функции.

Какую функцию вызывать: none — не вызывать; auto — модель выбирает; принудительно — {"type": "function", "function": {"name": "my_function"}}. По умолчанию none без функций, иначе auto.

Responses

application/json
object
object[]
Required
object
Required

Playground

Authorization
Body

Samples