Create Text Generator task (Streaming)

Streaming text generation endpoint. Authenticates via API token (X-API-KEY + X-API-ID), validates the request, checks credits, calls the Gemini streaming API, and returns an SSE stream of Gemini-native response chunks on the same connection.

The final SSE chunk includes a creatify object with the generation id and credits_used.

POST /sse/text_generator/stream

Text Generator (Streaming)

cURL

curl --request POST \
  --url https://api.creatify.ai/sse/text_generator/stream/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "model_name": "<string>",
  "messages": [
    {
      "content": ""
    }
  ],
  "system_instruction": "",
  "config": {
    "temperature": 123,
    "max_output_tokens": 123,
    "top_p": 123,
    "top_k": 123,
    "presence_penalty": 123,
    "frequency_penalty": 123,
    "seed": 123,
    "stop_sequences": [
      "<string>"
    ],
    "response_json_schema": "<unknown>"
  },
  "tools": [
    {
      "function_declarations": [
        {
          "name": "<string>",
          "description": "",
          "parameters": "<unknown>"
        }
      ]
    }
  ],
  "tool_config": {
    "function_calling_config": {
      "allowed_function_names": [
        "<string>"
      ]
    }
  },
  "webhook_url": "<string>",
  "sync": false
}
'

200

"<string>"

Authorizations

X-API-ID · string · header · required

API ID, from your settings page.

X-API-KEY · string · header · required

API Key, from your settings page.

Body

application/json

model_name · string · required

Name of the Gemini model (e.g. gemini-2.5-flash).

Maximum string length: 255

messages · object[] · required

List of messages with 'role' (user/model) and 'content'.

Show child attributes

system_instruction · string · default: ""

Optional system instruction for the model.

config · object

Generation config parameters.

Show child attributes

tools · object[]

List of tools (function declarations) the model may call.

Show child attributes

tool_config · object

Controls how the model uses the provided tools.

Show child attributes

webhook_url · string<uri>

Webhook URL for async status updates.

sync · boolean · default: false

If true, the request blocks until generation completes and returns the result directly. Default is false (async).

Response

200

text/event-stream

SSE stream of Gemini response chunks. Content-Type: text/event-stream.

The response is of type string.