Skip to main content
POST
Pass-through to the OpenAI Responses API. Request and response bodies follow the standard OpenAI Responses schema. The gateway infers the provider from the model name.

Headers

X-Toolken-Key
string
required
Your Toolken API key. Validated by the gateway and stripped before forwarding.
Authorization
string
required
Your provider key in Bearer format (BYOK), e.g. Bearer sk-.... Forwarded untouched, never stored.
X-Toolken-Metadata
string
Primary attribution channel. JSON object of key-value pairs (e.g. {"agent":"research-agent","customer_id":"cust_abc"}). Each key becomes a groupable dimension in the dashboard.
X-Toolken-Metadata-*
string
Flat-header shorthand. X-Toolken-Metadata-Agent: research-agent writes metadata key agent. Equivalent to sending the same key in X-Toolken-Metadata.
X-Toolken-Metadata-Feature
string
Sets the feature metadata key. Use to group costs by agent name, workflow, UI surface, or job type.
X-Toolken-Metadata-Customer-Id
string
Sets the customer_id metadata key. Use to attribute costs to an end-customer, org slug, or account ID.

Body

model
string
required
Model identifier for the OpenAI Responses API (e.g. gpt-4o).
input
string or array
required
Input text or structured input array. Follows the standard OpenAI Responses schema.
stream
boolean
If true, the gateway streams Server-Sent Events back from the provider.

Response

id
string
Unique response ID.
object
string
Object type identifier.
output
array
The generated output. Shape depends on the model and input type.
usage
object
Token usage counts. Shape follows the standard OpenAI Responses API.