tools

Generate one marketing image (ad creative, thumbnail, hero, social graphic) and return a public URL

Generate one marketing image (ad creative, thumbnail, hero, social graphic) and return a public URL. Free plans burn one of their monthly free images; paid plans spend 1 platform credit. Optionally pass a reference image to keep a person, product, place, or brand consistent.

post/api/mcp/tools/generate_image

Request

  • Base URL: https://finestructure.ai
  • URL: https://finestructure.ai/api/mcp/tools/generate_image
  • Auth: HTTP bearer

Request body

promptstring required

What to draw. Up to 4500 chars.

languagestring

Language of any text in the image. ISO code such as 'en' or 'he'. Defaults to 'en'.

reference_image_urlstring

Public https URL of a reference image, or one of this account's own finestructure.ai uploads.

reference_image_data_urlstring

Reference image inline as a data:image/... URL. Prefer reference_image_url for large files.

reference_image_data_urlsstring[]

Up to 6 extra reference images as data:image/... URLs.

notify_by_emailboolean

Email the account owner the finished image. Default false so batch runs do not spam.

Response

Tool executed successfully

okboolean required
toolstring required
resultobject required

Changes

No recorded changes to this operation across all 2 revisions of this API.