Generate a post image
Generates the image for a single post and saves it on the plan.
The post’s own image_prompt wins over the image_prompt you send, so the request body only decides the prompt for a post that has none. To change an image that already exists, send refinement_instruction.
image_url and you send no refinement_instruction, the existing image is returned as-is. Nothing is generated and no credits are charged.Generating an image costs 1 credit and fails with a 402 when the workspace is out of quota. Image generation is budgeted at up to 60 seconds per attempt, so use a client timeout above that.
This endpoint is limited to 12 requests per minute, separately from the other social content endpoints.
Authorizations
Personal API key.
Path Parameters
ID of the post, as returned in the content plan. Must be a UUID.
ID of the app.
Body
Prompt to generate the image from. Used only when the post carries no image_prompt of its own, which is the prompt the plan generated for it. Send the post's own image_prompt back if you want to be sure of what is used.
2000"A freelancer closing a laptop at a tidy desk, warm morning light"
What to change about the existing image. Sending this regenerates the image even when the post already has one. The first 300 characters are used.
500"Make the lighting cooler and remove the coffee cup."