Generate an image

Pick the aspect ratio for the platform it is going to. The key goes straight into a post's mediaKeys or a carousel. The credit is held for the call's budget and settled at what it really cost; a refusal or failure is never charged.

Ask in plain words#

• "make an image of a founder desk at dusk for LinkedIn"
• "image generation API for social posts"
• "generate a 4:5 cover image for this Instagram post"

From an agent host (MCP)#

Server: https://shapelessai.com/mcp (add it to your host).

• tools_run with { "name": "generate_image", "input": { ... } }: the input is the REST body below; tools_list prints its JSON Schema.

From code (REST)#

Bearer API key with the scope each call names (auth, OpenAPI).

• POST /api/images (write scope): Generate an image (tool generate_image): {name, prompt, aspectRatio, size?, quality?, reference_keys?, budgetUsd?}.

From a terminal (CLI)#

• shapeless tools run generate_image --input '<json>' (tools show generate_image prints the schema)

Example#

curl -s https://shapelessai.com/api/images -H "Authorization: Bearer $SHAPELESS_API_KEY" -H "Content-Type: application/json" -d '{"name":"founder desk","prompt":"A quiet founder desk at dusk, one lamp, deep shadows.","aspectRatio":"4:5"}'

Refusals#

Where else#

• The api docs (markdown)