---
title: "Создать response (beta)"
method: POST
path: "/v1/responses"
tags: ["Responses"]
---

# Создать response (beta)

`POST /v1/responses`

## Request

- Base URL: `https://api.hubris.pw`
- URL: `https://api.hubris.pw/v1/responses`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hubris.pw/oauth/authorize`, token URL `https://api.hubris.pw/oauth/token`, scopes: `chat:write`)

OpenAI-совместимый Responses API endpoint. **BETA** — schema нестабильна, поля могут меняться.

При `stream: true` возвращает Server-Sent Events стрим. Usage приходит в `response.completed` event.

## Request body

- ResponsesRequest
  - `model` string, required
  - `input` union, required: Строка или массив input-блоков (см. OpenAI Responses API).
    - string
    - object[]
  - `stream` boolean

## Response `200`

Успешный ответ. При `stream: false` — JSON. При `stream: true` — `text/event-stream`.

- ResponsesResponse
  - `id` string, required
  - `object` 'response', required
  - `created_at` integer, required
  - `model` string, required
  - `output` object[], required
  - `usage` Usage
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `total_tokens` integer, required
    - `completion_tokens_details` object
      - `reasoning_tokens` integer
    - `prompt_tokens_details` object
      - `cached_tokens` integer
  - `status` string

## Other responses

- `400`: Невалидное тело
- `401`: Невалидный API-ключ
- `402`: Недостаточно средств
- `404`: Модель не найдена
- `429`: Превышен дневной лимит ключа
- `502`: Ошибка апстрима
- `503`: Курс ЦБ РФ недоступен
- `504`: Таймаут апстрима

---

[API](https://skmtc.dev/hubris/apis/hubris-api.md) · [All operations](https://skmtc.dev/hubris/apis/hubris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hubris/apis/hubris-api/revisions/79ea91ed8f10?raw)