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

{
  "id": "id",
  "object": "chat.completion",
  "created": 1,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "user",
        "content": "Hello, please introduce yourself",
        "name": "name",
        "tool_calls": [
          {
            "id": {},
            "type": {},
            "function": {}
          }
        ],
        "tool_call_id": "tool_call_id",
        "reasoning_content": "reasoning_content"
      },
      "finish_reason": "stop"
    }
  ],
  "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
    }
  },
  "system_fingerprint": "system_fingerprint"
}

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/chat/completions' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Hello, please introduce yourself"
    }
  ],
  "temperature": 1,
  "stream": false,
  "max_tokens": 1024,
  "response_format": "json"
}'

{
  "id": "id",
  "object": "chat.completion",
  "created": 1,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "user",
        "content": "Hello, please introduce yourself",
        "name": "name",
        "tool_calls": [
          {
            "id": {},
            "type": {},
            "function": {}
          }
        ],
        "tool_call_id": "tool_call_id",
        "reasoning_content": "reasoning_content"
      },
      "finish_reason": "stop"
    }
  ],
  "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
    }
  },
  "system_fingerprint": "system_fingerprint"
}

​
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
Model IDExample: gpt-5.5
​
messages
array<object>
required
List of chat messages
​
messages.role
string
required
Message roleAllowed values: system, user, assistant, tool, developer
​
messages.content
string or array<object>
required
Message content
​
messages.name
string
Sender name
​
messages.tool_calls
array<object>
​
messages.tool_calls.id
string
​
messages.tool_calls.type
string
Example: function
​
messages.tool_calls.function
object
​
messages.tool_calls.function.name
string
​
messages.tool_calls.function.arguments
string
​
messages.tool_call_id
string
Tool call ID (for tool role messages)
​
messages.reasoning_content
string
Reasoning content
​
temperature
number
default:"1"
Sampling temperature
​
top_p
number
default:"1"
Nucleus sampling parameter
​
n
integer
default:"1"
Generation count
​
stream
boolean
default:"false"
Whether to stream the response
​
stream_options
object
​
stream_options.include_usage
boolean
​
stop
string or array<string>
Stop sequences
​
max_tokens
integer
Maximum generated tokens
​
max_completion_tokens
integer
Maximum completion tokens
​
presence_penalty
number
default:"0"
​
frequency_penalty
number
default:"0"
​
logit_bias
object
​
user
string
​
tools
array<object>
​
tools.type
string
Example: function
​
tools.function
object
​
tools.function.name
string
​
tools.function.description
string
​
tools.function.parameters
object
Parameter definition in JSON Schema format
​
tool_choice
string or object
​
tool_choice.type
string
​
tool_choice.function
object
​
tool_choice.function.name
string
​
response_format
object
​
response_format.type
string
Allowed values: text, json_object, json_schema
​
response_format.json_schema
object
JSON Schema definition
​
seed
integer
​
reasoning_effort
string
Reasoning effort (for models that support reasoning)Allowed values: low, medium, high
​
modalities
array<string>
​
audio
object
​
audio.voice
string
​
audio.format
string

​
Response

​
id
string
​
object
string
Example: chat.completion
​
created
integer
​
model
string
default:"gpt-5.5"
Example: gpt-5.5
​
choices
array<object>
​
choices.index
integer
​
choices.message
object
​
choices.message.role
string
required
Message roleAllowed values: system, user, assistant, tool, developer
​
choices.message.content
string or array<object>
required
Message content
​
choices.message.name
string
Sender name
​
choices.message.tool_calls
array<object>
​
choices.message.tool_calls.id
string
​
choices.message.tool_calls.type
string
Example: function
​
choices.message.tool_calls.function
object
​
choices.message.tool_call_id
string
Tool call ID (for tool role messages)
​
choices.message.reasoning_content
string
Reasoning content
​
choices.finish_reason
string
Allowed values: stop, length, tool_calls, content_filter
​
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
​
system_fingerprint
string