Skip to main content
POST
/
v1
/
responses
curl --request POST \
  --url 'https://api.elkapi.com/v1/responses' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.5",
  "input": "The weather is great today, perfect for a walk.",
  "temperature": 1,
  "stream": false
}'

{
  "id": "id",
  "object": "response",
  "created_at": 1,
  "status": "completed",
  "model": "gpt-5.5",
  "output": [
    {
      "type": "type",
      "id": "id",
      "status": "status",
      "role": "user",
      "content": "Hello, please introduce yourself"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "prompt_tokens_details": {
      "cached_tokens": 1,
      "text_tokens": 1,
      "audio_tokens": 1,
      "image_tokens": 1
    },
    "completion_tokens_details": {
      "text_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt

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

curl --request POST \
  --url 'https://api.elkapi.com/v1/responses' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.5",
  "input": "The weather is great today, perfect for a walk.",
  "temperature": 1,
  "stream": false
}'

{
  "id": "id",
  "object": "response",
  "created_at": 1,
  "status": "completed",
  "model": "gpt-5.5",
  "output": [
    {
      "type": "type",
      "id": "id",
      "status": "status",
      "role": "user",
      "content": "Hello, please introduce yourself"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "prompt_tokens_details": {
      "cached_tokens": 1,
      "text_tokens": 1,
      "audio_tokens": 1,
      "image_tokens": 1
    },
    "completion_tokens_details": {
      "text_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1
    }
  }
}

​
Authorizations

​
Authorization
string
required
All endpoints require Bearer Token authentication.Add it to the request headers:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"gpt-5.5"
required
Example: gpt-5.5
​
input
string or array<object>
Input content, either a string or an array of messages
​
instructions
string
​
max_output_tokens
integer
​
temperature
number
​
top_p
number
​
stream
boolean
​
tools
array<object>
​
tool_choice
string or object
​
reasoning
object
​
reasoning.effort
string
Allowed values: low, medium, high
​
reasoning.summary
string
​
previous_response_id
string
​
truncation
string
Allowed values: auto, disabled

​
Response

​
id
string
​
object
string
Example: response
​
created_at
integer
​
status
string
Allowed values: completed, failed, in_progress, incomplete
​
model
string
default:"gpt-5.5"
Example: gpt-5.5
​
output
array<object>
​
output.type
string
​
output.id
string
​
output.status
string
​
output.role
string
​
output.content
array<object>
​
output.content.type
string
​
output.content.text
string
​
usage
object
​
usage.prompt_tokens
integer
Prompt token count
​
usage.completion_tokens
integer
Completion token count
​
usage.total_tokens
integer
Total token count
​
usage.prompt_tokens_details
object
​
usage.prompt_tokens_details.cached_tokens
integer
​
usage.prompt_tokens_details.text_tokens
integer
​
usage.prompt_tokens_details.audio_tokens
integer
​
usage.prompt_tokens_details.image_tokens
integer
​
usage.completion_tokens_details
object
​
usage.completion_tokens_details.text_tokens
integer
​
usage.completion_tokens_details.audio_tokens
integer
​
usage.completion_tokens_details.reasoning_tokens
integer