Chat completions

The chat completions endpoint takes standard OpenAI-format requests and returns text. Point any OpenAI-compatible client at the Kyara base URL to use it. The endpoint is text-only. See Unsupported Features for the capabilities, such as tool calling, that are not available.

Request

POST https://api.kyara-intelligence.com/v1/chat/completions

curl https://api.kyara-intelligence.com/v1/chat/completions \
  -H "Authorization: Bearer $KYARA_INTELLIGENCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "Hello!" }
    ]
  }'

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.kyara-intelligence.com/v1",
  apiKey: process.env.KYARA_INTELLIGENCE_API_KEY,
});

const response = await client.chat.completions.create({
  model: "deepseek/deepseek-v4-flash",
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(response.choices[0].message.content);

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kyara-intelligence.com/v1",
    api_key=os.environ.get("KYARA_INTELLIGENCE_API_KEY"),
)

response = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

string

required

The model ID to use for the request. Find available model IDs in the catalog.

array

required

An array of message objects forming the conversation. Each object requires a role (system, developer, user, or assistant) and a content string. Content must be plain text. Multimodal arrays are rejected.

number

Sampling temperature between 0 and 2. Higher values produce more varied output; lower values produce more focused, deterministic output. Support varies per model.

number

Nucleus sampling probability mass. The model considers only the tokens comprising the top top_p probability mass. Support varies per model.

integer

Kyara extension. Limits sampling to the top k most likely tokens. Accepted by many models beyond the OpenAI standard.

integer

Maximum number of tokens to generate. You can use max_completion_tokens interchangeably.

integer

Alias for max_tokens. Maximum number of tokens to generate in the completion.

boolean

Set to true to receive the response as Server-Sent Events, token by token. Defaults to false.

object

Controls reasoning behaviour for models that support it. Pass an object with either or both of:

effort (string), for example "low", "medium", or "high"
max_tokens (integer), the maximum tokens to spend on reasoning

The top-level reasoning_effort is also accepted and is folded into reasoning.effort. If you set both, reasoning.effort takes precedence.

integer

Number of completion choices to generate. Only 1 is supported; any other value returns a 400 error. Defaults to 1.

string | array

Up to four sequences where the model will stop generating further tokens.

integer

A seed for deterministic sampling. Passing the same seed and request parameters should produce the same result, though determinism is not guaranteed.

Response

A successful request returns a JSON object matching the OpenAI chat completions schema.

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "deepseek/deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! How can I help you today?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 9, "total_tokens": 18 }
}

string

A unique identifier for the completion, prefixed with chatcmpl-.

string

Always "chat.completion" for non-streaming responses.

string

The model ID that was used to generate the response.

array

An array of completion choices.

Show Choice object

integer

Zero-based index of this choice in the array.

object

The generated message. Contains role ("assistant") and content (string).

string

The reason generation stopped. Common values: "stop", "length".

object

Token usage for the request.

Show Usage object

integer

Number of tokens in the input messages.

integer

Number of tokens in the generated output.

integer

Total tokens consumed (prompt_tokens + completion_tokens).

Streaming

Set "stream": true to receive the response as Server-Sent Events. Kyara sends one data: event per token and terminates the stream with data: [DONE].

curl

curl https://api.kyara-intelligence.com/v1/chat/completions \
  -H "Authorization: Bearer $KYARA_INTELLIGENCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Hello!" }
    ]
  }'

To include token usage in the final stream event, add "stream_options": { "include_usage": true } to your request.

Model IDs and pricing can change during early access. Use the models page as the current source of truth for available models.

Features such as tool calling, structured outputs, vision, and embeddings are not supported. See Unsupported Features for the complete list.

Get Started

Integrations

API Reference

Reference

Request

Response

Streaming

​Request

​Response

​Streaming

Request

Response

Streaming