AI images for posts
Make up to 4 AI images for a post from a description or its caption. Each one is saved to your media library.
Describe an image, or use the post's caption, pick a shape for your platforms, and get up to 4 options. Each image is stored and added to your media library, so you can use it in any post.
Making an image never posts anything. AI images are on the Studio, Pro and Agency plans.
Credits
Each image costs 5 AI credits from your plan's monthly credits. Credits for an image that fails are refunded. If you don't have enough credits for every image you ask for, nothing is made and you get credits_exhausted. Settings → Billing shows your credits left and how many images you made this month. AI images are not included in AppSumo lifetime plans.
Shapes
aspect | Size | Suits |
|---|---|---|
square | 1024 × 1024 | Instagram, Facebook, Threads, Bluesky |
portrait | 1024 × 1536 | Pinterest, TikTok |
landscape | 1536 × 1024 | X, LinkedIn, YouTube |
From your AI or the CLI
| Tool | What it does |
|---|---|
generate_post_image | Makes 1 to 4 images from prompt or caption and returns their URLs. |
To use an image in a post, pass its url as media of type image to create_scheduled_post.
REST API
| Method | Path | Scope |
|---|---|---|
POST | /api/v1/media/generate-image | uploads:write |
GET | /api/v1/media/generate-image | uploads:write |
POST takes { "prompt": "...", "aspect": "square", "count": 2 } (or "fromCaption": true with "caption"), and an optional "requestId": retrying with the same id returns the first result instead of making new images. It returns { images, failed, allowance }, where allowance.used is how many images you made this month. GET returns { allowance }.
| Status | code | Meaning |
|---|---|---|
| 400 | prompt_required | No description and no caption. |
| 402 | credits_exhausted | Not enough AI credits; creditsNeeded and creditsRemaining say how many. |
| 403 | not_included | AI images are not in your plan (AppSumo lifetime plans). |
| 409 | in_progress | The same requestId is still running. |
| 422 | prompt_rejected | The description was blocked by our content rules. |
| 502 | generation_failed | No image could be made; your credits were refunded. |