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

# Chat Completions

`POST /v1/chat/completions`

## Headers

- `webapp-authorization` string, nullable

## Request body

- CompletionsPayload
  - `model` 'versa' | 'nexus' | 'eclipse', required
  - `messages` CompletionsMessage[], required
    - `role` 'system' | 'user' | 'assistant', required
    - `content` string, required
  - `stream` boolean
  - `persona` string, nullable

## Response `200`

Successful Response

- union
  - ChatCompletion
    - `id` string, required
    - `choices` Choice[], required
      - `finish_reason` 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'function_call', required
      - `index` integer, required
      - `logprobs` ChoiceLogprobs
        - `content` ChatCompletionTokenLogprob[], nullable
          - `token` string, required
          - `bytes` integer[], nullable
          - `logprob` number, required
          - `top_logprobs` TopLogprob[], required
            - `token` string, required
            - `bytes` integer[], nullable
            - `logprob` number, required
      - `message` ChatCompletionMessage, required
        - `content` string, nullable
        - `role` 'assistant', required
        - `function_call` FunctionCall
          - `arguments` string, required
          - `name` string, required
        - `tool_calls` ChatCompletionMessageToolCall[], nullable
          - `id` string, required
          - `function` Function, required
            - `arguments` string, required
            - `name` string, required
          - `type` 'function', required
    - `created` integer, required
    - `model` string, required
    - `object` 'chat.completion', required
    - `system_fingerprint` string, nullable
    - `usage` CompletionUsage
      - `completion_tokens` integer, required
      - `prompt_tokens` integer, required
      - `total_tokens` integer, required
  - string
  - ChatCompletion
    - `id` string, required
    - `choices` Choice[], required
      - `finish_reason` 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'function_call', required
      - `index` integer, required
      - `logprobs` ChoiceLogprobs
        - `content` ChatCompletionTokenLogprob[], nullable
          - `token` string, required
          - `bytes` integer[], nullable
          - `logprob` number, required
          - `top_logprobs` TopLogprob[], required
            - `token` string, required
            - `bytes` integer[], nullable
            - `logprob` number, required
      - `message` ChatCompletionMessage, required
        - `content` string, nullable
        - `role` 'assistant', required
        - `function_call` FunctionCall
          - `arguments` string, required
          - `name` string, required
        - `tool_calls` ChatCompletionMessageToolCall[], nullable
          - `id` string, required
          - `function` Function, required
            - `arguments` string, required
            - `name` string, required
          - `type` 'function', required
    - `created` integer, required
    - `model` string, required
    - `object` 'chat.completion', required
    - `system_fingerprint` string, nullable
    - `usage` CompletionUsage
      - `completion_tokens` integer, required
      - `prompt_tokens` integer, required
      - `total_tokens` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/alphakek-ai/apis/fastapi.md) · [All operations](https://skmtc.net/alphakek-ai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alphakek-ai/fastapi/versions/b003833f1f0c/schema)