---
title: "Generate tokens if `stream == false` or a stream of token if `stream == true`"
method: POST
path: "/"
tags: ["Text Generation Inference"]
---

# Generate tokens if `stream == false` or a stream of token if `stream == true`

`POST /`

Generate tokens if `stream == false` or a stream of token if `stream == true`

## Request body

- CompatGenerateRequest — unresolved $ref

## Response `200`

Generated Text

- GenerateResponse
  - `details` Details
    - `best_of_sequences` BestOfSequence[], nullable
      - `finish_reason` 'length' | 'eos_token' | 'stop_sequence', required
      - `generated_text` string, required
      - `generated_tokens` integer, required
      - `prefill` PrefillToken[], required
        - `id` integer, required
        - `logprob` number, float, nullable, required
        - `text` string, required
      - `seed` integer, nullable
      - `tokens` Token[], required
        - `id` integer, required
        - `logprob` number, float, nullable, required
        - `special` boolean, required
        - `text` string, required
    - `finish_reason` 'length' | 'eos_token' | 'stop_sequence', required
    - `generated_tokens` integer, required
    - `prefill` PrefillToken[], required
      - `id` integer, required
      - `logprob` number, float, nullable, required
      - `text` string, required
    - `seed` integer, nullable
    - `tokens` Token[], required
      - `id` integer, required
      - `logprob` number, float, nullable, required
      - `special` boolean, required
      - `text` string, required
  - `generated_text` string, required

## Other responses

- `422` — Input validation error
- `424` — Generation Error
- `429` — Model is overloaded
- `500` — Incomplete generation

## Changes

- **2023-06-05** `e35edd53eed0` — 2 info
  - added the new optional request property `parameters/decoder_input_details`
  - the `stream` request property default value `false` was added
- **2023-05-09** `36489c7b42f0` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `text/event-stream` for the response with the status `200`
- **2023-04-18** `de34bec00da8` — 1 info
  - endpoint added
- **2023-02-03** `a9059df72b92` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/preemo-inc/apis/text-generation-inference/changes/post.md)

---

[API](https://skmtc.dev/preemo-inc/apis/text-generation-inference.md) · [All operations](https://skmtc.dev/preemo-inc/apis/text-generation-inference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/preemo-inc/text-generation-inference/revisions/12de8108e4dd/schema)