---
title: "Generate text"
method: POST
path: "/text_generations"
tags: ["text_generations"]
---

# Generate text

`POST /text_generations`

## Request

- Base URL: `https://www.socialfaktory.com/v1`
- URL: `https://www.socialfaktory.com/v1/text_generations`
- Auth: HTTP bearer

Write post variants for a brand from a brief, a link, a finished generation or a media item. Spends the user credits: 3 are reserved up front against the token monthly credit cap, and the write settles at what it used, which can land a little over the cap.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `brand_id` string, required
  - `brief` string
  - `source_url` string
  - `generation_id` string
  - `media_id` string
  - `platform` 'x' | 'linkedin'

## Response `201`

Generate text

- object
  - `text_generation_id` string, required
  - `status` string, required

## Other responses

- `default`: The error envelope

---

[API](https://skmtc.dev/socialfaktory/apis/socialfaktory-api.md) · [All operations](https://skmtc.dev/socialfaktory/apis/socialfaktory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialfaktory/apis/socialfaktory-api/revisions/aa1714ae1ba4?raw)