Sign in

v1

latestOpenAPI 3.1.02026-07-2676188241.3 KB
Responses

Create response

Creates a model response for the given input. This is the OpenAI Responses API. Supports instructions (system message equivalent), streaming, tool calling, JSON mode, and multi-turn conversations. When present, reasoning is returned as a structured output item with type: "reasoning", separate from the message output.

post/responses

Request body

model'corti-s1' | 'corti-s1-instant' | 'corti-s1-mini' | 'corti-s1-mini-instant' required
instructionsstring nullable

System-level instructions. Equivalent to a system message in chat completions.

streamboolean

If true, returns Server-Sent Events (SSE) with typed events (response.created, response.in_progress, response.output_item.added, response.output_text.delta, response.completed).

temperaturenumber float
top_pnumber float
max_output_tokensinteger

Maximum output tokens. If exceeded, the response status is incomplete with incomplete_details.reason: "max_output_tokens".

tool_choice'auto' | 'none'
presence_penaltynumber float
frequency_penaltynumber float

Response

Successful response. For non-streaming requests, returns a complete response object. For streaming requests, returns Server-Sent Events (SSE) with typed events.

idstring

Unique response ID (e.g. resp_88d5b93fd2e7b7b1).

object'response'
created_atinteger

Unix timestamp (seconds).

modelstring

The model name used for this response.

status'completed' | 'incomplete'

incomplete when max_output_tokens is hit before generation finishes.

instructionsstring nullable
temperaturenumber
top_pnumber
tool_choicestring
max_output_tokensinteger
previous_response_idstring nullable
service_tierstring nullable
truncationstring
backgroundboolean
parallel_tool_callsboolean
max_tool_callsinteger nullable
textstring nullable
top_logprobsinteger nullable
reasoningstring nullable

Reasoning is returned in output[] items.

promptstring nullable
metadataobject nullable
userstring nullable
presence_penaltynumber
frequency_penaltynumber
kv_transfer_paramsobject nullable