Skip to main content
POST
Create a response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

model ID

Available options:
gpt-5.5
Example:

"gpt-5.5"

input
object[]
required

Text or image content used by the model to generate a response.

Minimum array length: 1
Example:
stream
boolean
default:false

When true, response deltas are streamed via SSE.

temperature
number
default:1

Sampling temperature. Higher values make the output more random.

Required range: 0 <= x <= 2
Example:

1

frequency_penalty
number
default:0

Penalize tokens based on how often they appear in the text.

Required range: -2 <= x <= 2
presence_penalty
number
default:0

Penalize tokens that have already appeared in the text.

Required range: -2 <= x <= 2
max_output_tokens
integer

Maximum number of output tokens.

Required range: x >= 16
stop
string

Sequences that stop generation.

n
integer
default:1

Number of response candidates to generate.

Required range: x >= 1
text
object

Configuration options for the model's text response.

reasoning
object

Model reasoning/thinking configuration.

tools
object[]

A list of tools the model can call.

tool_choice
string

Controls which tool the model calls, if any.

store
boolean
default:true

Whether to store the generated response for later retrieval via API. Defaults to true.

user
string

A unique identifier representing the end user.

Response

Response generated successfully

id
string
required
Example:

"resp_0ed94fe7ec73cf560169afd97bba648194b8661d445cfa4244"

object
string
required
Example:

"response"

created_at
integer
required

Unix timestamp when the response was created.

Example:

1773132155

model
string
required
Example:

"gpt-5.5"

status
enum<string>
required
Available options:
completed,
failed,
in_progress,
incomplete
Example:

"completed"

output
object[]
required
usage
object
required
completed_at
integer

Unix timestamp when the response was completed.

Example:

1773132156

reasoning
object
text
object