Skip to main content
POST
Create a model 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.2-chat
Example:

"gpt-5.2-chat"

input
object[]
required

Text or image input for the model, used to generate a response.

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

When enabled, results are streamed back via SSE.

temperature
number
default:1

Sampling temperature. Higher values make the output more random.

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

1

top_p
number

Nucleus sampling threshold.

Required range: 0 <= x <= 1
frequency_penalty
number
default:0

Penalize repeated tokens based on frequency.

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

Penalize tokens that have already appeared.

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

Maximum number of output tokens.

Required range: x >= 1
stop
string

Character sequences that stop generation.

n
integer
default:1

How many response choices 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.

store
boolean
default:true

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

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.2-chat"

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