---
title: "Responses"
method: POST
path: "/v1/responses"
tags: ["openai-compat"]
---

# Responses

`POST /v1/responses`

Create one stateless, text-only OpenAI Responses result.

## Headers

- `X-SIE-MACHINE-PROFILE` string, nullable

## Request body

- OpenAIResponsesRequestModel — Strict stateless, text-only subset of the OpenAI Responses API.
  - `model` string, required — Generation model id
  - `input` union, required
    - string
    - OpenAIResponseInputMessageModel[]
      - `role` 'system' | 'user' | 'assistant' | 'developer', required
      - `content` union, required
        - string
        - OpenAIResponseInputContentPartModel[]
          - `type` 'text' | 'input_text' | 'output_text', required
          - `text` string, required
  - `max_output_tokens` integer, nullable — Maximum generated tokens
  - `temperature` number, nullable — Sampling temperature override
  - `top_p` number, nullable — Nucleus-sampling probability override
  - `seed` integer, nullable — Optional signed 64-bit sampling seed
  - `stream` false, nullable — Responses streaming is not supported

## Response `200`

Successful Response

- OpenAIResponsesResponseModel — One completed direct OpenAI Responses result.
  - `id` string, required
  - `object` 'response', required
  - `created_at` integer, required
  - `model` string, required
  - `status` 'completed', required
  - `output` OpenAIResponseOutputMessageModel[], required
    - `type` 'message', required
    - `id` string, required
    - `role` 'assistant', required
    - `status` 'completed', required
    - `content` OpenAIResponseOutputTextModel[], required
      - `type` 'output_text', required
      - `text` string, required
      - `annotations` object[], required
  - `usage` OpenAIResponseUsageModel, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `total_tokens` integer, required

## Other responses

- `400` — Invalid or unsupported request
- `404` — Model not found
- `413` — Request body or rendered input is too large
- `422` — Validation Error
- `500` — Generation failed
- `503` — Model loading or temporarily unavailable

## Changes

- **2026-08-06** `8eefbfaad8f2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/superlinked/apis/sie-server/changes/v1/responses/post.md)

---

[API](https://skmtc.dev/superlinked/apis/sie-server.md) · [All operations](https://skmtc.dev/superlinked/apis/sie-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superlinked/sie-server/revisions/26ac644915a4/schema)