Skip to main content
POST
/
v1
/
messages
curl --request POST \
  --url 'https://api.elkapi.com/v1/messages' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "claude-sonnet-4-6",
  "messages": [
    {
      "role": "user",
      "content": "Hello, please introduce yourself"
    }
  ],
  "max_tokens": 1024,
  "temperature": 1,
  "stream": false,
  "metadata": {
    "user_id": "user_id"
  }
}'

{
  "id": "id",
  "type": "message",
  "role": "user",
  "content": "Hello, please introduce yourself",
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "cache_creation_input_tokens": 1,
    "cache_read_input_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/messages' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "claude-sonnet-4-6",
  "messages": [
    {
      "role": "user",
      "content": "Hello, please introduce yourself"
    }
  ],
  "max_tokens": 1024,
  "temperature": 1,
  "stream": false,
  "metadata": {
    "user_id": "user_id"
  }
}'

{
  "id": "id",
  "type": "message",
  "role": "user",
  "content": "Hello, please introduce yourself",
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "cache_creation_input_tokens": 1,
    "cache_read_input_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:"claude-sonnet-4-6"
required
Example: claude-sonnet-4-6
​
messages
array<object>
required
​
messages.role
string
required
Allowed values: user, assistant
​
messages.content
string or array<object>
required
​
system
string or array<object>
​
max_tokens
integer
required
​
temperature
number
​
top_p
number
​
top_k
integer
​
stream
boolean
​
stop_sequences
array<string>
​
tools
array<object>
​
tools.name
string
​
tools.description
string
​
tools.input_schema
object
​
tool_choice
object
​
tool_choice.type
string
Allowed values: auto, any, tool
​
tool_choice.name
string
​
thinking
object
​
thinking.type
string
Allowed values: enabled, disabled
​
thinking.budget_tokens
integer
​
metadata
object
​
metadata.user_id
string

​
Response

​
id
string
​
type
string
Example: message
​
role
string
Example: assistant
​
content
array<object>
​
content.type
string
​
content.text
string
​
model
string
default:"claude-sonnet-4-6"
Example: claude-sonnet-4-6
​
stop_reason
string
Allowed values: end_turn, max_tokens, stop_sequence, tool_use
​
usage
object
​
usage.input_tokens
integer
​
usage.output_tokens
integer
​
usage.cache_creation_input_tokens
integer
​
usage.cache_read_input_tokens
integer