Skip to main content
POST
OpenAI-compatible Responses

Authorizations

Authorization
string
header
required

Your Nugen API key, sent as a Bearer token

Body

application/json

A request in the Responses format.

model
string
required

Model ID to use for the response

Example:

"model_01kmqm4nrn9fw6r"

input
required

Input text or array of message dicts

instructions
string | null

System-level instructions (maps to system message)

max_output_tokens
integer | null

Maximum tokens to generate

temperature
number | null
default:1

Sampling temperature

Required range: 0 <= x <= 2
top_p
number | null

Nucleus sampling parameter

stream
boolean | null
default:true

Stream partial output as server-sent events. Defaults to true. Set false for one JSON response.

metadata
Metadata · object | null

Optional metadata, ignored by the model

Response

Successful Response

A response in the Responses format.

id
string
required

Unique identifier of the response

Example:

"resp_9f2c1a7b3d4e5f60718293a4"

created_at
integer
required

Unix time in seconds when the response was created

model
string
required

Model used for the response

output
ResponsesOutputMessage · object[]
required

Generated output messages

usage
ResponsesUsage · object
required

Token usage

object
string
default:response

Always "response".

Allowed value: "response"