responses

Create a response

Creates a model response using the Responses API. Supports streaming (stream: true, server-sent events) and background mode (background: true). When streaming, each frame carries a named event: and a JSON data: payload, and the stream ends on a terminal event, one of response.completed, response.failed or response.incomplete; there is no [DONE] sentinel. OpenAI-compatible, so existing Responses API code runs unmodified.

post/responses

Headers

Authorizationstring required

Bearer authentication

Request body

modelstring required

The ASI:One model to use.

instructionsstring

System/developer instructions inserted ahead of the input.

streamboolean

If true, response events are streamed as server-sent events.

backgroundboolean

If true, run the response as a background task; poll it with the retrieve endpoint or stop it with cancel.

storeboolean

Whether to persist the response so it can be retrieved by id.

previous_response_idstring

The id of a previous response to continue from.

max_output_tokensinteger

Upper bound on tokens generated for the response.

temperaturenumber double

Sampling temperature.

top_pnumber double

Nucleus sampling probability mass.

parallel_tool_callsboolean

Whether the model may call several tools in one turn.

enable_thinkingboolean

ASI:One extension. Whether the model reasons before answering. Used when reasoning.effort is absent.

thinking_budgetinteger

ASI:One extension. Maximum tokens the model may spend reasoning.

metadataobject

Up to 16 key-value string pairs attached to the response.

Response

A response object, or an SSE stream of response events when stream is true.

idstring

objectstring

Lifecycle status. queued and in_progress mean the run is still going; completed, failed, cancelled and incomplete are terminal.

modelstring

outputResponseObjectOutputItems[]

Changes

No recorded changes to this endpoint across all 1 revision of this API.