POST /v1/responses

OpenAI Responses-compatible shim, including background job polling and cancellation.

OpenAI Responses compatible — a shim that converts the request into a chat request internally. Anything like previous_response_id is stateful storage, which is not supported.

Parameters

Parameter	Type	Required	Description
`model`	string	Yes	Model ID
`input`	string \| array	Yes	A string, or an array of message / `function_call` / `function_call_output` items
`instructions`	string	No	system instructions
`max_output_tokens`	integer	No	Maximum output tokens
`temperature`	number	No	0–2
`top_p`	number	No	0–1
`stream`	boolean	No	Stream events token by token
`background`	boolean	No	If `true`, submits as an async job and returns `queued` immediately
`tools` / `tool_choice`	array / string\|object	No	Same format as chat
`reasoning_effort`	string	No	`none` / `low` / `medium` / `high`
`user`	string	No	End-user identifier
`everyais`	object	No	Gateway caching options

Request

{
  "model": "everyais/claude-opus-5",
  "input": "Hello!",
  "instructions": "Be concise."
}

GET /v1/responses/{id}

Poll the status of a job submitted with background: true.

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1709884800,
  "model": "everyais/claude-opus-5",
  "status": "queued",
  "output": [],
  "error": null,
  "incomplete_details": null,
  "usage": null
}

status transitions queued → in_progress → completed / incomplete / failed / cancelled. Once it completes, the full stored Response body is returned.

Returns 404 if the job does not exist, has expired, or belongs to another key or user.

POST /v1/responses/{id}/cancel

Transitions a job in queued or in_progress state to cancelled and refunds the reserved credit. A job that has already finished is returned as its current Response with no status change.