Skip to main content
POST
/
v1
/
chat
/
completions
Create chat completion
curl --request POST \
  --url https://api.siray.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "frequency_penalty": 0,
  "max_tokens": 131072,
  "messages": [
    {
      "content": "example_value",
      "role": "system"
    }
  ],
  "model": "mistral/ministral-3-3b",
  "presence_penalty": 0,
  "stream": false,
  "temperature": 1,
  "top_p": 1
}
'
{
  "choices": [
    {
      "index": 123,
      "delta": {
        "content": "<string>",
        "reasoning": "<string>",
        "reasoning_content": "<string>",
        "role": "system",
        "tool_calls": [
          {
            "function": {
              "arguments": "<string>",
              "description": "<string>",
              "name": "<string>",
              "parameters": "<unknown>"
            },
            "id": "<string>",
            "index": 123,
            "type": "<unknown>"
          }
        ]
      },
      "finish_reason": "stop",
      "logprobs": "<unknown>"
    }
  ],
  "created": 123,
  "id": "<string>",
  "model": "<string>",
  "object": "<string>",
  "system_fingerprint": "<string>",
  "usage": {
    "completion_tokens": 123,
    "completion_tokens_details": {
      "audio_tokens": 123,
      "reasoning_tokens": 123,
      "text_tokens": 123
    },
    "input_tokens": 123,
    "output_tokens": 123,
    "prompt_tokens": 123,
    "prompt_tokens_details": {
      "audio_tokens": 123,
      "cached_tokens": 123,
      "image_tokens": 123,
      "text_tokens": 123
    },
    "total_tokens": 123,
    "input_tokens_details": {
      "audio_tokens": 123,
      "cached_tokens": 123,
      "image_tokens": 123,
      "text_tokens": 123
    },
    "prompt_cache_hit_tokens": 123
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication using API key

Body

application/json

Request payload

OpenAI-compatible chat completions API request format

messages
object[]
required

Array of conversation messages with roles

Minimum array length: 1
model
enum<string>
required

Model name to use for the request

Available options:
mistral/ministral-3-3b
frequency_penalty
number
default:0

Penalty for frequent tokens

Required range: -2 <= x <= 2
max_tokens
integer
default:131072

Maximum number of tokens to generate

Required range: 1 <= x <= 131072
presence_penalty
number
default:0

Penalty for new topics

Required range: -2 <= x <= 2
stream
boolean
default:false

Enable streaming response

temperature
number
default:1

Controls randomness in output (higher = more random)

Required range: 0 <= x <= 2
top_p
number
default:1

Nucleus sampling parameter (controls diversity)

Required range: 0 <= x <= 1

Response

200 - application/json

Successful response

Chat completion response

choices
object[]
required
created
integer
required

Unix timestamp of when the completion was created

id
string
required

Unique identifier for the chat completion

model
string
required

The model used for the completion

object
string
required

Object type, typically 'chat.completion.chunk'

system_fingerprint
string

System fingerprint for the completion

usage
object

Token usage information