SociaHive Docs

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

aspectSizeSuits
square1024 × 1024Instagram, Facebook, Threads, Bluesky
portrait1024 × 1536Pinterest, TikTok
landscape1536 × 1024X, LinkedIn, YouTube

From your AI or the CLI

ToolWhat it does
generate_post_imageMakes 1 to 4 images from prompt or caption and returns their URLs.
sociahive media generate --prompt "A bright flat lay of candles on a linen table" --aspect square --count 2
sociahive media generate --caption "Our autumn menu is here" --aspect portrait

To use an image in a post, pass its url as media of type image to create_scheduled_post.

REST API

MethodPathScope
POST/api/v1/media/generate-imageuploads:write
GET/api/v1/media/generate-imageuploads: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 }.

StatuscodeMeaning
400prompt_requiredNo description and no caption.
402credits_exhaustedNot enough AI credits; creditsNeeded and creditsRemaining say how many.
403not_includedAI images are not in your plan (AppSumo lifetime plans).
409in_progressThe same requestId is still running.
422prompt_rejectedThe description was blocked by our content rules.
502generation_failedNo image could be made; your credits were refunded.

On this page