---
title: "OpenAI-compatible chat completion. Set `stream: true` for server-sent events."
method: POST
path: "/api/v1/chat/completions"
tags: ["LLM"]
---

# OpenAI-compatible chat completion. Set \`stream: true\` for server-sent events.

`POST /api/v1/chat/completions`

## Request

- Base URL: `https://api.api-stock.com`
- URL: `https://api.api-stock.com/api/v1/chat/completions`
- Auth: HTTP bearer

## Request body

- ChatCompletionRequestDto
  - `model` string, required: Model id
  - `messages` ChatMessageDto[], required: Conversation messages
    - `role` string, required: Role of the message author
    - `content` object, required: Message content. Either a string or an array of content parts (multimodal).
    - `name` string: Optional author name
  - `stream` boolean: Stream partial deltas as server-sent events
  - `temperature` number: Sampling temperature (0-2)
  - `top_p` number: Nucleus sampling probability
  - `max_tokens` number: Maximum tokens to generate
  - `max_completion_tokens` number: Alias for max_tokens; capped by API Stock
  - `n` number: Number of completions. API Stock currently supports one.

## Response `200`

Chat completion. When `stream` is true the response is a `text/event-stream` of deltas.

- ChatCompletionResponseDto
  - `id` string, required
  - `object` string, required
  - `created` number, required
  - `model` string, required
  - `choices` ChatCompletionChoiceDto[], required
    - `index` number, required
    - `message` object, required
    - `finish_reason` string, nullable, required
  - `usage` ChatCompletionUsageDto, required
    - `prompt_tokens` number, required
    - `completion_tokens` number, required
    - `total_tokens` number, required

## Other responses

- `400`: Bad Request - unknown model or invalid parameters
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient account balance
- `500`: Internal Server Error - Server error occurred

---

[API](https://skmtc.dev/api-stock/apis/api-stock-api.md) · [All operations](https://skmtc.dev/api-stock/apis/api-stock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/api-stock/apis/api-stock-api/revisions/f71e13198386?raw)