Create Response
Create a response.
Generates an answer to the given input, grounded in live web research and
annotated with URL citations. Set model to parallel; reasoning.effort
(low/medium/high) controls how much research is performed, trading
response time for answer quality. Returns an OpenAI-format Response as
application/json, or a text/event-stream of OpenAI Responses SSE
events when stream=true.
Authorizations
Body
Request body for the Responses API (POST /v1/responses).
OpenAI-Responses-compatible: point a standard OpenAI client at
https://api.parallel.ai/v1 with your Parallel API key and set model to
parallel. The fields below are the ones Parallel acts on; other OpenAI
request fields (tools, tool_choice, temperature, top_p,
max_output_tokens, parallel_tool_calls, truncation, store, user,
include) are accepted for compatibility but have no effect.
The model to run. parallel is the only supported value (matched case-insensitively); any other value is rejected. To trade response time for answer quality, set reasoning.effort (low/medium/high) rather than changing the model name.
"parallel"
The input to generate a response for: a plain string, or a list of role/content messages that includes at least one user message. Must be non-empty, and only text content is supported. input and instructions together may total at most 20,000 characters.
"What are the latest developments in fusion energy?"
System instructions for the model.
ID of a previous response to use as conversation context.
Whether to stream the response.
Configuration for text output, including structured output.
Arbitrary key-value pairs, echoed back on the Response object. Useful for tagging requests. At most 16 keys; keys up to 64 characters, values up to 512 characters.
Reasoning configuration. effort (low/medium/high) controls how much research is performed; defaults to medium.
Background mode is not supported: requests with background=true are rejected with a 422 validation error. Use the Task API (POST /v1/tasks/runs) for long-running work.
Response
Returns a Response object for non-streaming requests (application/json), or a stream of OpenAI Responses streaming events (text/event-stream) when stream=true is set in the request.
A response from the parallel model. A completed response contains a
single assistant message whose text is annotated with URL citations
grounding the answer.
"response"Details of a failed response.
Details about why the response is incomplete.
"parallel"Moderation results for the response input and output, if moderated completions were requested.
in_memory, 24h Reasoning configuration (OpenAI-compatible subset).
auto, default, flex, scale, priority completed, failed, in_progress, cancelled, queued, incomplete Text output configuration. By default the response is plain text; for
structured output set format to
{"type": "json_schema", "name": ..., "schema": {...}}. The json_object
format is accepted for compatibility but produces plain text.
auto, disabled Estimated token usage, populated for OpenAI SDK compatibility. Counts are approximate; Parallel bills per request, not per token.