---
title: "Create chat completion"
method: POST
path: "/v1/chat/completions"
tags: ["Chat"]
---

# Create chat completion

`POST /v1/chat/completions`

OpenAI-compatible chat completion endpoint with streaming support.

## Request body

- ChatCompletionRequest
  - `model` string, required
  - `messages` object[], required
    - `role` 'system' | 'user' | 'assistant' | 'function' | 'tool', required
    - `content` union
      - string
      - unknown[]
        - unknown
    - `name` string
    - `function_call` unknown
    - `tool_calls` unknown
  - `temperature` number
  - `top_p` number
  - `n` integer
  - `stream` boolean
  - `stop` union
    - string
    - string[]
  - `max_tokens` integer
  - `presence_penalty` number
  - `frequency_penalty` number
  - `logit_bias` object
  - `user` string
  - `top_k` number
  - `repetition_penalty` number

## Response `200`

Chat completion response

- ChatCompletionResponse
  - `id` string, required
  - `object` 'chat.completion', required
  - `created` number, required
  - `model` string, required
  - `choices` object[], required
    - `index` number, required
    - `message` object, required
      - `role` string, required
      - `content` string, nullable, required
      - `function_call` unknown
      - `tool_calls` unknown
    - `finish_reason` string, nullable, required
    - `logprobs` unknown
  - `usage` object
    - `prompt_tokens` number, required
    - `completion_tokens` number, required
    - `total_tokens` number, required
  - `system_fingerprint` string

## Other responses

- `400` — Invalid request
- `401` — API key missing or invalid

---

[API](https://skmtc.dev/generalcompute/apis/generalcompute-api.md) · [All operations](https://skmtc.dev/generalcompute/apis/generalcompute-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/generalcompute/generalcompute-api/revisions/ea7487e4f63a/schema)