> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
> Use this file to discover all available pages before exploring further.

# AI features

> Generate, review, and create posts with AI — drawing on your workspace's brand profile.

## What's included

TryPost ships three AI flows in the post editor, all backed by your workspace's [brand profile](/knowledge-base/brand-profile) so generated content matches your voice:

| Flow | What it does | Where to find it |
| - | - | - |
| **Generate** | Draft or rewrite the post body from a short prompt and the current text | Post editor → AI button |
| **Review** | Read the current content and surface concrete, actionable suggestions before you publish | Post editor → Review button |
| **Create** | Wizard that builds an end-to-end post — picks a content\_type, drafts the caption, and generates images — from a single prompt | Calendar → "Create with AI" |

## Generate

`POST` your prompt and the current content; the AI returns a refined draft.

| Field | Required | Notes |
| - | - | - |
| `prompt` | Yes | Up to 2 000 chars. What you want changed or written. |
| `current_content` | No | Up to 10 000 chars. The existing post body, if any. |

Use it for:

* Turning rough notes into a polished caption
* Tightening a long draft
* Swapping tone (e.g. "make this more conversational")

## Review

Submit your draft and get a structured review back — strengths, weaknesses, and concrete edits.

| Field | Required | Notes |
| - | - | - |
| `content` | Yes | Up to 10 000 chars |

The review is shown side-by-side with the editor so you can apply suggestions one by one.

## Create (wizard)

The wizard creates a draft post from scratch — including selecting media — based on a target format and prompt.

| Field | Required | Notes |
| - | - | - |
| `format` | Yes | AI-supported values: `instagram_feed`, `instagram_carousel` (wizard-only; draft is saved as `instagram_feed`), `instagram_story`, `linkedin_post`, `linkedin_page_post`, `x_post`, `threads_post`, `bluesky_post`, `mastodon_post`, `facebook_post`, `pinterest_pin`, `pinterest_carousel` |
| `social_account_id` | No | Pre-select which account to publish to |
| `image_count` | No | 0–10 images to generate alongside the caption (multi-image / carousel formats) |
| `prompt` | Yes | Up to 2 000 chars describing what the post is about |

Reels, Shorts, TikTok video, Facebook Story, and similar video-only formats are not in the AI Create wizard yet — the wizard intentionally only generates text + images.

## How brand profile is used

Each AI call is wrapped with your workspace's [brand profile](/knowledge-base/brand-profile): website, description, tone, voice notes, and content language. The prompt the model actually sees is your input plus those guardrails — that's why generated posts read in your voice and language without you having to spell it out every time.

## Cloud access

There is no monthly AI quota. Copilot, Generate, Review, and Create stay available on both Cloud plans. You still need an [active subscription](/knowledge-base/plans-and-billing) on Cloud — without one, those actions return `402 Payment Required`.

## Self-hosted

AI features require an OpenAI (or compatible) API key configured in your `.env`:

```bash theme={null}
AI_TEXT_PROVIDER=openai
OPENAI_API_KEY=sk-...
```

Without those, the AI buttons stay disabled. Pin a model and pick a provider in [AI Providers](/self-hosting/ai). Self-hosted instances skip the Cloud subscription check (`SELF_HOSTED=true` in `.env`).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.