Saltar para o conteúdo principal
POST
/
responses
Cria uma resposta
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": {}
}
'

Autorizações

Authorization
string
header
obrigatório

As chaves de API do OrcaRouter têm o formato sk-orca-.... Passe-as no cabeçalho Authorization: Bearer sk-orca-....

Corpo

application/json
model
string
obrigatório
Exemplo:

"openai/gpt-4.1"

input
obrigatório
instructions
string
previous_response_id
string

ID de uma resposta anterior, para continuar uma conversa multi-turno sem reenviar todo o histórico de mensagens.

tools
object[]

Array de forma livre de entradas de ferramentas da Responses-API. O type de cada entrada seleciona a ferramenta. Valores comuns incluem function (uma ferramenta de função personalizada, mesmo formato que Chat Completions), web_search (grounding web integrado), mcp (Model Context Protocol) e code_interpreter. Chamadas de ferramentas integradas (web_search_call, etc.) são faturadas por chamada — veja Operações / Faturamento e uso.

tool_choice
temperature
number
top_p
number
max_output_tokens
integer
stream
boolean
reasoning
object

Configuração de raciocínio da Responses-API da OpenAI.

store
boolean

Se o upstream pode armazenar a requisição/resposta. Permitido por padrão; a configuração de canal disable_store pode sobrescrever.

metadata
object

Resposta

200

OK