Generate an Image

Generates a production-ready social media image from a text prompt using Andie, Swonkie's AI assistant. The image is automatically uploaded to your workspace's media library and returned as a complete media object, ready to reference in posts.

Generation uses an image model. Typical generation time is 15–45 seconds.

Using the returned image in a post

Use the returned id as mediaLibId when creating or updating a post:

Notes

prompt and aspectRatio are required. All other fields are optional.

If both targetWidth and targetHeight are provided, they override the default resolution for the selected aspectRatio. The values are snapped to the nearest valid AI grid size (multiples of 16) within provider limits.

The returned status may be PROCESSING immediately after generation. If you need to verify the file is fully processed before embedding it in a post, poll GET /media/{id} until status is SUCCESS.

Generated images are stored as JPEG at 100% quality with an sRGB colour profile.

The path and preview URLs are temporary signed URLs that expire after a period of time.

curl --location 'https://api.swonkie.dev/v2/andie/generate-image' \ --header 'X-API-ID: ' \ --header 'X-API-KEY: ' \ --header 'Content-Type: application/json' \ --data '{ "prompt": "A warm, minimalist coffee shop interior at golden hour, wooden tables, soft bokeh background, editorial style", "aspectRatio": "4:5", "quality": "high" }'

{ "id": "QW5kaWVJbWFnZTEyMzQ1Njc", "name": "image", "path": "https://storage.example.com/temp/ai_uuid.jpg", "preview": "https://storage.example.com/temp/ai_uuid_preview.jpg", "type": "IMAGE", "status": "SUCCESS", "specs": { "width": 1080, "height": 1350, "duration": null, "fileSizeBytes": 312450, "fps": null } }

Using the returned image in a post

Notes

Request

Responses

Generate an Image

Using the returned image in a post#

Notes#

Request

Responses

Using the returned image in a post

Notes