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

# POST /gemini/chat/completions

`POST /gemini/chat/completions`

## Request body

- GeminiRequest
  - `messages` object[], required
    - `role` string
    - `content` string
  - `model` string, required — Models supported by TTAPI, see [Gemini Supported Models](/grids/cn/start/pricing/llm)
  - `stream` boolean — Whether to use server-sent events for progressive response transmission

## Response `200`

Successful response (stream=false returns JSON, stream=true returns Gemini stream)

- object
  - `choices` object[] — List of response results
    - `finish_reason` string, required — Response stop reason
    - `index` integer, required — Result index
    - `message` object, required — Response message body
      - `content` string, required — Content generated by Gemini
      - `role` string, required — Message role
  - `created` integer — Response creation timestamp (seconds)
  - `id` string — Unique request identifier
  - `model` string — Gemini model version used
  - `object` string — Response object type
  - `usage` object — Token usage statistics
    - `completion_tokens` integer, required — Token count consumed by generated content
    - `prompt_tokens` integer, required — Token count consumed by prompt
    - `total_tokens` integer, required — Total token count consumed

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)