Skip to main content
POST
/
responses
Create a response
curl --request POST \
  --url https://api.orcarouter.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "openai/gpt-4.1",
  "input": "<string>",
  "instructions": "<string>",
  "previous_response_id": "<string>",
  "tools": [
    {
      "type": "<string>"
    }
  ],
  "tool_choice": "<string>",
  "temperature": 123,
  "top_p": 123,
  "max_output_tokens": 123,
  "stream": true,
  "reasoning": {},
  "store": true,
  "metadata": {}
}
'

Authorizations

​
Authorization
string
header
required

OrcaRouter API keys look like sk-orca-.... Pass them in the Authorization: Bearer sk-orca-... header.

Body

application/json
​
model
string
required
Example:

"openai/gpt-4.1"

​
input
required
​
instructions
string
​
previous_response_id
string

ID of a prior response, to continue a multi-turn conversation without resending the full message history.

​
tools
object[]

Free-form array of Responses-API tool entries. Each entry's type selects the tool. Common values include function (a custom function tool, same shape as Chat Completions), web_search (built-in web grounding), mcp (Model Context Protocol), and code_interpreter. Built-in tool calls (web_search_call, etc.) are billed per call — see Operations / Billing & Usage.

​
tool_choice
​
temperature
number
​
top_p
number
​
max_output_tokens
integer
​
stream
boolean
​
reasoning
object

OpenAI Responses-API reasoning configuration.

​
store
boolean

Whether the upstream may store the request/response. Allowed by default; channel setting disable_store can override.

​
metadata
object

Response

200

OK