Chat completions

POST /chat/completions

Create a model response for a conversation. OpenAI-compatible.

POST https://api.heyaskr.ai/chat/completions

Request body

model · string · required

The model id, e.g. gpt-5.5, claude-sonnet-4.6. Add routing suffixes like :nitro or :online where supported.

messages · array · required

The conversation so far. Each item has role (system | user | assistant) and content.

stream · boolean · default: "false"

If true, returns Server-Sent Events as tokens are generated.

temperature · number · default: "1"

Sampling temperature, 0–2.

max_tokens · integer

Maximum tokens in the completion.

plugins · array

Optional plugins, e.g. [{"id":"web","max_results":5}] for web search.

Response

id · string

Unique id for the completion.

choices · array

The generated choices. Each has a message (role, content) and a finish_reason.

usage · object

Token counts: prompt_tokens, completion_tokens, total_tokens.

{
  "id": "chatcmpl-...",
  "choices": [
    { "message": { "role": "assistant", "content": "Hello!" }, "finish_reason": "stop" }
  ],
  "usage": { "prompt_tokens": 12, "completion_tokens": 3, "total_tokens": 15 }
}