Generate social media images from a caption
POST/:workspaceUuid/ai/image-generate
Generates one or more images and saves them immediately to the workspace media library.
Standard mode (recommended): provide caption + platform. PostBoost
builds a professional image prompt internally using platform-specific
templates. No prompt engineering required.
Developer mode: provide prompt directly to bypass prompt building.
If both caption and prompt are sent, standard mode runs.
Credits: 1 image credit per image (429 image_credits_exhausted when the monthly pool is empty).
If the image pool is switched off, count × credit_weight text credits instead.
Request
Responses
- 200
- 401
- 403
- 422
- 429
Images generated and saved to media library
Missing or invalid API token.
Access denied. Returned when the caller is not a member of the workspace, lacks the role
the endpoint needs, or the workspace's plan does not include API access (capability api).
Validation failed.
AI credits exhausted for this billing period