---
title: "Complete"
method: POST
path: "/chat/completions"
---

# Complete

`POST /chat/completions`

## Request body

- ChatCompletionRequest
  - `model` string, required
  - `messages` OpenAIMessageInput[], required
    - `role` 'system' | 'user' | 'assistant', required
    - `content` union, required
      - string
      - union[]
        - union
          - OpenAIContent
            - `type` string, required
            - `text` string, required
          - OpenAIImageContent
            - `type` string, required
            - `image_url` union, required
              - …
          - OpenAIFileContent
            - `type` 'file', required
            - `file` OpenAIFileDetails, required
              - …
  - `temperature` number, nullable
  - `top_p` number, nullable
  - `n` integer, nullable
  - `stream` boolean, nullable
  - `max_tokens` integer, nullable
  - `presence_penalty` number, nullable
  - `frequency_penalty` number, nullable
  - `user` string, nullable
  - `metadata` object, nullable

## Response `200`

Successful Response

- ChatCompletionResponse
  - `id` string, required
  - `object` string, required
  - `created` integer, required
  - `model` string, required
  - `choices` Choice[], required
    - `index` integer, required
    - `message` OpenAIMessageOutput, required
      - `role` 'system' | 'user' | 'assistant', required
      - `content` union, required
        - string
        - union[]
          - union
            - OpenAIContent
              - …
            - OpenAIImageContent
              - …
            - OpenAIFileContent
              - …
    - `finish_reason` string, required
  - `usage` OpenAIUsage, required
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `total_tokens` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/google/apis/sec-gemini.md) · [All operations](https://skmtc.net/google/apis/sec-gemini/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/sec-gemini/versions/cc76ee2bed1c/schema)