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

# Create Chat Completion

`POST /v1/completions/chat`

## Request body

- ChatCompletionRequest
  - `model` string, required
  - `messages` ChatMessage[], required
    - `role` string, required
    - `content` string, required
    - `name` string, nullable
  - `frequency_penalty` number, nullable
  - `presence_penalty` number, nullable
  - `logit_bias` object, nullable
  - `temperature` number, nullable
  - `n` integer, nullable
  - `seed` integer, nullable
  - `stop` string[], nullable
  - `stream` boolean, nullable
  - `top_p` number, nullable
  - `max_tokens` integer, nullable
  - `tools` Tool[], nullable
    - `type` 'function'
    - `function` Function, required
      - `name` string, required
      - `description` string, nullable
      - `parameters` object, nullable
  - `tool_choice` string, nullable
  - `user` string, nullable
  - `extra_model_args` object, nullable

## Response `200`

Successful Response

- CompletionResponse
  - `content` string, required
  - `response_metadata` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ibm/apis/wxo-server-api.md) · [All operations](https://skmtc.net/ibm/apis/wxo-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibm/wxo-server-api/revisions/82c114c37196/schema)