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."
  }'

Documentation Index

Fetch the complete documentation index at: https://docs.helicone.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
​
top_k
​
temperature
​
top_p
​
user
string
​
safety_identifier
string
​
prompt_cache_key
string
​
service_tier
Available options:
auto,
default,
flex,
scale,
priority
​
model
​
reasoning
​
reasoning_options
object
​
max_output_tokens
​
max_tool_calls
​
text
object
​
tools
object[]
​
tool_choice
Available options:
none,
auto,
required
​
truncation
Available options:
auto,
disabled
​
input
​
include
Available options:
message.input_image.image_url,
code_interpreter_call.outputs,
reasoning.encrypted_content,
message.output_text.logprobs
​
parallel_tool_calls
​
instructions
​
stream
​
stream_options
​
context_editing
object
​
image_generation
object

Response

200

Request accepted