Skip to main content
POST
Responses API

Authorizations

Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token.

Headers

X-Opper-Name
string

Function name for tracing and project-level guardrail function-scope filtering.

X-Opper-Parent-Span-Id
string<uuid>

Parent span ID for distributed tracing context.

X-Opper-Tags
string

Comma-separated key:value usage-attribution tags (e.g. tenant:acme,project:demo, max 8). Recorded on the generation's billing/metrics rows; group spend by any key via GET /v2/analytics/usage?group_by=. Header-borne twin of the /v3/session URL prefix tags (which win per key when both are present); opper.-prefixed keys and session_id are reserved. Malformed values return 400.

Body

application/json
cache_control
object

Opt in to automatic prompt caching for Anthropic-family models: {"type":"ephemeral"} (optionally "ttl":"1h"). Places one moving cache breakpoint on the largest cacheable prefix. Caching is off unless set; no-op on providers with automatic server-side caching (OpenAI

frequency_penalty
number
include
string[]
input
object
instructions
string
max_output_tokens
integer
metadata
object
model
string
parallel_tool_calls
boolean
presence_penalty
number
previous_response_id
string
reasoning
object
service_tier
string
store
boolean
stream
boolean
temperature
number
text
object
tool_choice
any

Any value

tools
object[]
top_p
number
truncation
string
user
string

Response

Successful response

created_at
number
required
error
object
required
id
string
required
incomplete_details
any
required

Any value

model
string
required
object
string
required
output
object[]
required
status
string
required
tool_choice
any
required

Any value

completed_at
integer
cost
number
frequency_penalty
number
instructions
string
max_output_tokens
integer
metadata
object
output_text
string
parallel_tool_calls
boolean
presence_penalty
number
previous_response_id
string
reasoning
object
service_tier
string
temperature
number
text
object
tools
object[]
top_p
number
truncation
string
usage
object
user
string