---
title: "GET /api/text_generator/"
method: GET
path: "/api/text_generator/"
tags: ["text_generator"]
---

# GET /api/text_generator/

`GET /api/text_generator/`

## Request

- The document declares no server URL.
- Auth: API key in header `X-API-ID` and API key in header `X-API-KEY`

## Response `200`

- TextGenResponse[]
  - `id` string, uuid, required
  - `model_name` string, required
  - `messages` Message[], required
    - `role` 'user' | 'model', required: * `user` - user * `model` - model
    - `content` string: Message content. Either a plain text string, or a list of content parts for multimodal input. Each part is an object with 'type' ('text', 'image', or 'video'), and either 'text' (for text parts) or 'data' (base64) + 'mime_type' (for image/video parts).
    - `function_call` FunctionCallPart: A function call issued by the model.
      - `name` string, required: Name of the function to call.
      - `args` object: Arguments for the function call as a JSON object.
    - `function_response` FunctionResponsePart: A function response supplied by the caller.
      - `name` string, required: Name of the function that was called.
      - `response` object, required: The function's return value as a JSON object.
  - `system_instruction` string: Optional system instruction for the model.
  - `config` TextGenConfig, required: Structured config serializer for OpenAPI documentation.
    - `temperature` number, double: Controls randomness. Range: 0.0 - 2.0. Lower = more deterministic.
    - `max_output_tokens` integer: Maximum number of tokens to generate.
    - `top_p` number, double: Nucleus sampling threshold. Range: 0.0 - 1.0.
    - `top_k` integer: Top-k sampling. Only sample from top k tokens.
    - `presence_penalty` number, double: Penalize tokens already present in the text. Range: -2.0 - 2.0.
    - `frequency_penalty` number, double: Penalize tokens by frequency. Range: -2.0 - 2.0.
    - `seed` integer: Random seed for deterministic generation.
    - `stop_sequences` string[]: List of strings that stop generation when encountered.
    - `response_mime_type` 'text/plain' | 'application/json': * `text/plain` - text/plain * `application/json` - application/json
    - `response_json_schema` unknown
  - `status` 'pending' | 'running' | 'done' | 'failed': * `pending` - pending * `running` - running * `done` - done * `failed` - failed
  - `response_text` string: Generated text response from the model.
  - `response_function_calls` FunctionCallPart[], required
    - `name` string, required: Name of the function to call.
    - `args` object: Arguments for the function call as a JSON object.
  - `failed_reason` string: Reason for failure if status is failed.
  - `credits_used` number, double: Credits consumed for this generation.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Changes

- **2026-11-03** `8423ba73b422`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/creatify/apis/creatify-ai-api/changes/api/text_generator/get.md)

---

[API](https://skmtc.dev/creatify/apis/creatify-ai-api.md) - [All operations](https://skmtc.dev/creatify/apis/creatify-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/creatify/apis/creatify-ai-api/revisions/8423ba73b422?raw)