---
title: "Get Text Generator item by id"
method: GET
path: "/sse/text_generator/{id}/"
tags: ["text_generator"]
---

# Get Text Generator item by id

`GET /sse/text_generator/{id}/`

Retrieve a single text generation task by ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

Text generation task detail.

- 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

## Other responses

- `401` — Missing or invalid API credentials.
- `404` — Task not found.

---

[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-service-production.skmtc.workers.dev/v1/apis/creatify/creatify-ai-api/revisions/7ca3bf8077ba/schema)