---
title: "Responses"
method: POST
path: "/v1/responses"
---

# Responses

`POST /v1/responses`

## Request body

- object — Use this field according to the endpoint schema.
  - `model` string — Use this field according to the endpoint schema.
  - `input` union, required — Use this field according to the endpoint schema.
    - string
    - object[]
      - `role` string, required — Use this field according to the endpoint schema.
      - `content` union, required — Use this field according to the endpoint schema.
        - string
        - object[]
          - `type` string — Use this field according to the endpoint schema.
          - `text` string — Use this field according to the endpoint schema.
          - `image_url` string — Use this field according to the endpoint schema.
          - `file_url` string — Use this field according to the endpoint schema.
  - `instructions` string — Use this field according to the endpoint schema.
  - `stream` boolean — Use this field according to the endpoint schema.
  - `background` boolean — Use this field according to the endpoint schema.
  - `previous_response_id` string — Use this field according to the endpoint schema.
  - `conversation` unknown
  - `temperature` number — Use this field according to the endpoint schema.
  - `max_output_tokens` integer — Use this field according to the endpoint schema.
  - `top_p` number — Use this field according to the endpoint schema.
  - `reasoning` object — Use this field according to the endpoint schema.
    - `effort` 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' — Use this field according to the endpoint schema.
    - `generate_summary` 'auto' | 'concise' | 'detailed' — Use this field according to the endpoint schema.
    - `summary` 'auto' | 'concise' | 'detailed' — Use this field according to the endpoint schema.
  - `text` object — Use this field according to the endpoint schema.
    - `format` object — Use this field according to the endpoint schema.
      - `type` string — Use this field according to the endpoint schema.
      - `name` string — Use this field according to the endpoint schema.
      - `schema` object — Use this field according to the endpoint schema.
    - `verbosity` 'low' | 'medium' | 'high' — Use this field according to the endpoint schema.
  - `tools` object[] — Use this field according to the endpoint schema.
    - `type` string — Use this field according to the endpoint schema.
    - `name` string — Use this field according to the endpoint schema.
    - `description` string — Use this field according to the endpoint schema.
    - `parameters` object — Use this field according to the endpoint schema.
  - `tool_choice` unknown
  - `parallel_tool_calls` boolean — Use this field according to the endpoint schema.
  - `include` string[] — Use this field according to the endpoint schema.
  - `metadata` object — Use this field according to the endpoint schema.
  - `truncation` 'auto' | 'disabled' — Use this field according to the endpoint schema.
  - `store` boolean — Use this field according to the endpoint schema.
  - `prompt_cache_key` string — Use this field according to the endpoint schema.
  - `prompt_cache_retention` 'in-memory' | '24h' — Use this field according to the endpoint schema.
  - `max_tool_calls` integer — Use this field according to the endpoint schema.
  - `top_logprobs` integer — Use this field according to the endpoint schema.
  - `stream_options` object — Use this field according to the endpoint schema.
    - `include_obfuscation` boolean — Use this field according to the endpoint schema.
  - `prompt` object — Use this field according to the endpoint schema.
    - `id` string — Use this field according to the endpoint schema.
    - `variables` object — Use this field according to the endpoint schema.
    - `version` string — Use this field according to the endpoint schema.
  - `safety_identifier` string — Use this field according to the endpoint schema.
  - `service_tier` 'auto' | 'default' | 'flex' | 'priority' — Use this field according to the endpoint schema.
  - `user` string — Use this field according to the endpoint schema.

## Response `200`

Use this field according to the endpoint schema.

- object
  - `id` string, required — Use this field according to the endpoint schema.
  - `object` string, required — Use this field according to the endpoint schema.
  - `created_at` integer, required
  - `status` string, required
  - `background` boolean, required
  - `content_filters` unknown, required
  - `error` unknown, required
  - `incomplete_details` unknown, required
  - `instructions` unknown, required
  - `max_output_tokens` unknown, required
  - `max_tool_calls` unknown, required
  - `model` string, required — Use this field according to the endpoint schema.
  - `output` object[], required — Use this field according to the endpoint schema.
    - `id` string
    - `type` string
    - `status` string
    - `content` object[]
      - `type` string
      - `annotations` string[]
      - `logprobs` string[]
      - `text` string
    - `role` string
    - `phase` string — Use this field according to the endpoint schema.
  - `output_text` string, nullable — Use this field according to the endpoint schema.
  - `parallel_tool_calls` boolean, required
  - `previous_response_id` unknown, required
  - `prompt_cache_key` unknown, required
  - `reasoning` object, required
    - `effort` unknown, required
    - `summary` unknown, required
  - `safety_identifier` unknown, required
  - `service_tier` string, required
  - `store` boolean, required
  - `temperature` integer, required
  - `text` object, required
    - `format` object, required
      - `type` string, required
    - `verbosity` string, required
  - `tool_choice` string, required
  - `tools` string[], required
  - `top_logprobs` integer, required
  - `top_p` integer, required
  - `truncation` string, required
  - `usage` object, required — Use this field according to the endpoint schema.
    - `input_tokens` integer, required
    - `input_tokens_details` object, required
      - `cached_tokens` integer, required
    - `output_tokens` integer, required
    - `output_tokens_details` object, required
      - `reasoning_tokens` integer, required
    - `total_tokens` integer, required — Use this field according to the endpoint schema.
  - `user` unknown, required
  - `metadata` object, required

---

[API](https://skmtc.net/deerapi/apis/text-to-audio-api.md) · [All operations](https://skmtc.net/deerapi/apis/text-to-audio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deerapi/text-to-audio-api/versions/b6265ced74a1/schema)