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