Skip to main content
POST
Создать ответ модели
Параметры запроса и поля ответа соответствуют формату официального Responses API. Полную спецификацию см. в официальной документации OpenAI.
Эндпоинт поддерживает текст, изображения и файлы, структурированный вывод, вызовы инструментов, многошаговые диалоги, фоновую обработку и потоковые ответы.

Авторизации

Authorization
string
header
обязательно

Вы можете получить API-ключ в панель управления TTAPI.

Тело

application/json

Тело запроса для OpenAI-совместимого Responses API.

model
string

Идентификатор модели для генерации ответа. См. Поддерживаемые модели.

Пример:

"gpt-5.4-mini"

input

Текст, изображение или файл для модели. Строка интерпретируется как сообщение пользователя.

Пример:

"Объясни квантовые вычисления простыми словами."

instructions
string

Инструкция system или developer, добавляемая в контекст модели. При использовании previous_response_id инструкция прошлого ответа не наследуется.

previous_response_id
string

Идентификатор предыдущего ответа для многошагового диалога. Нельзя использовать вместе с conversation.

conversation

Диалог, к которому относится этот ответ.

background
boolean
по умолчанию:false

Запускать ли генерацию ответа в фоновом режиме.

include
enum<string>[]

Дополнительные данные, которые нужно включить в ответ.

Доступные опции:
file_search_call.results,
web_search_call.results,
web_search_call.action.sources,
message.input_image.image_url,
computer_call_output.output.image_url,
code_interpreter_call.outputs,
reasoning.encrypted_content,
message.output_text.logprobs
max_output_tokens
integer

Максимальное число сгенерированных токенов, включая видимый вывод и токены рассуждений.

Требуемый диапазон: x >= 1
max_tool_calls
integer

Максимальное общее число вызовов встроенных инструментов в этом ответе.

Требуемый диапазон: x >= 1
metadata
object

До 16 строковых пар ключ-значение, прикреплённых к ответу.

parallel_tool_calls
boolean
по умолчанию:true

Разрешены ли параллельные вызовы инструментов.

prompt
object

Ссылка на многократно используемый шаблон промпта.

prompt_cache_key
string

Стабильный ключ для повышения вероятности попадания в кэш промпта.

prompt_cache_retention
enum<string>

Политика хранения кэша промпта.

Доступные опции:
in-memory,
24h
reasoning
object

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

safety_identifier
string

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

service_tier
enum<string>
Доступные опции:
auto,
default,
flex,
scale,
priority
store
boolean

Сохранять ли сгенерированный ответ для последующего получения через API.

stream
boolean
по умолчанию:false

Передавать ли события ответа потоково через Server-Sent Events.

stream_options
object

Параметры потоковой передачи. Указывайте только при stream=true.

temperature
number

Температура сэмплирования. Обычно изменяют temperature или top_p, но не оба параметра одновременно.

Требуемый диапазон: 0 <= x <= 2
text
object
tool_choice

Управляет выбором инструментов моделью.

Доступные опции:
none,
auto,
required
tools
object[]

Функции и поддерживаемые встроенные инструменты, доступные модели.

top_logprobs
integer
Требуемый диапазон: 0 <= x <= 20
top_p
number
Требуемый диапазон: 0 <= x <= 1
truncation
enum<string>
по умолчанию:disabled
Доступные опции:
auto,
disabled

Ответ

Успешный ответ. При stream=true возвращается поток Server-Sent Events.

id
string
обязательно
Пример:

"resp_67ccd2bed1ec8190b14f964abc0542670bb6a6b452d3795b"

object
string
обязательно
Allowed value: "response"
created_at
number
обязательно
Пример:

1741476542

status
enum<string>
обязательно
Доступные опции:
completed,
failed,
in_progress,
cancelled,
queued,
incomplete
model
string
обязательно
output
object[]
обязательно
error
object | null
incomplete_details
object | null
output_text
string
read-only

Вспомогательное поле SDK с объединённым текстовым выводом.

previous_response_id
string | null
store
boolean
usage
object
metadata
object
Последнее изменение 15 июля 2026 г.