Skip to main content
POST
/
v1
/
responses
curl https://ai-gateway.helicone.ai/v1/responses \
  -H "Authorization: Bearer $HELICONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "input": "Say hello in one sentence."
  }'
This request schema applies when using the Helicone AI Gateway with pass‑through billing (credits). In BYOK mode, the standard OpenAI Responses API schema is allowed. The schema is defined based on fields that are stable across all provider-model mappings. Learn more about pass‑through billing vs BYOK. 
curl https://ai-gateway.helicone.ai/v1/responses \
  -H "Authorization: Bearer $HELICONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "input": "Say hello in one sentence."
  }'

Body

application/json
​
top_logprobs
integer
Required range: 0 <= x <= 20
​
temperature
​
top_p
​
user
string
​
safety_identifier
string
​
prompt_cache_key
string
​
service_tier
Available options:
auto,
default,
flex,
scale,
priority
​
model
​
reasoning
​
max_output_tokens
​
max_tool_calls
​
text
object
​
tools
object[]
  • Option 1
  • Option 2
  • Option 3
  • Option 4
  • Option 5
​
tool_choice
Available options:
none,
auto,
required
​
truncation
Available options:
auto,
disabled
​
input
​
include
​
parallel_tool_calls
​
instructions
​
stream
​
stream_options
​
{key}
any

Response

200

Request accepted