Responses API — POST /v1/responses

Эндпоинт /v1/responses реализует OpenAI Responses API, который поддерживает многоходовые диалоги с сохранением состояния и встроенным управлением историей разговора. Это альтернатива /v1/chat/completions для рабочих процессов, требующих нового формата ответов OpenAI. Передайте previous_response_id, чтобы продолжить диалог без повторной отправки полной истории сообщений.

Эндпоинт

POST https://router.flatkey.ai/v1/responses

Когда использовать этот эндпоинт

Используйте /v1/responses, если:

Ваше приложение построено на OpenAI Responses API
Вам нужно управление диалогом с сохранением состояния
Вы используете параметр previous_response_id для многоходовых диалогов

Для большинства новых интеграций /v1/chat/completions является рекомендуемым эндпоинтом и имеет более широкую поддержку моделей.

Запрос

Заголовки

Заголовок	Значение
`Authorization`	`Bearer $FLATKEY_API_KEY`
`Content-Type`	`application/json`

Параметры тела запроса

string

обязательно

Идентификатор модели для использования. Здесь допустимы только модели, поддерживающие формат Responses API.

string | array

обязательно

Пользовательский ввод для данного хода. Может быть строкой или массивом объектов содержимого.

string

Инструкции системного уровня для модели (эквивалент сообщения system в chat completions).

string

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

integer

Максимальное количество токенов для генерации.

boolean

Если true, возвращает поток событий, отправляемых сервером. По умолчанию: false.

Пример запроса

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

response = client.responses.create(
    model="gpt-4o",
    input="What is the capital of Japan?",
    instructions="Answer concisely.",
)

print(response.output_text)

Многоходовой диалог с previous_response_id

python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

# First turn
response1 = client.responses.create(
    model="gpt-4o",
    input="My name is Alice.",
)

# Second turn — continue from the first
response2 = client.responses.create(
    model="gpt-4o",
    input="What is my name?",
    previous_response_id=response1.id,
)

print(response2.output_text)  # "Your name is Alice."

Ответ

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1710000000,
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {"type": "output_text", "text": "The capital of Japan is Tokyo."}
      ]
    }
  ],
  "usage": {
    "input_tokens": 15,
    "output_tokens": 9,
    "total_tokens": 24
  }
}

Поля ответа

string

Уникальный идентификатор данного ответа. Передайте его как previous_response_id для продолжения диалога.

string

Всегда "response".

integer

Unix-временная метка момента создания ответа.

string

Модель, сгенерировавшая ответ.

array

Массив объектов вывода, созданных моделью.

Показать свойства элемента output

string

Тип вывода. "message" для текстовых ответов.

string

Всегда "assistant" для сгенерированного вывода.

array

Массив блоков содержимого. Каждый блок имеет type ("output_text") и строку text.

object

Количество токенов для тарификации.

Показать свойства usage

integer

Количество обработанных входных токенов.

integer

Количество сгенерированных выходных токенов.

integer

Сумма входных и выходных токенов.

Обзор

Эндпоинты

Responses API — POST /v1/responses

Эндпоинт

Когда использовать этот эндпоинт

Запрос

Заголовки

Параметры тела запроса

Пример запроса

Многоходовой диалог с previous_response_id

Ответ

Поля ответа

​Эндпоинт

​Когда использовать этот эндпоинт

​Запрос

​Заголовки

​Параметры тела запроса

​Пример запроса

​Многоходовой диалог с previous_response_id

​Ответ

​Поля ответа

Эндпоинт

Когда использовать этот эндпоинт

Запрос

Заголовки

Параметры тела запроса

Пример запроса

Многоходовой диалог с previous_response_id

Ответ

Поля ответа