Generate an image (tool generate_image): {name, prompt, aspectRatio, size?, quality?, reference_keys?, budgetUsd?}.

post/api/images

Request

  • Base URL: https://shapelessai.com
  • URL: https://shapelessai.com/api/images
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://shapelessai.com/api/auth/mcp/authorize, token URL https://shapelessai.com/api/auth/mcp/token, scopes: write)

Request body

namestring required

A 2-6 word filename for this image, the way you would describe it to a colleague - e.g. "founder desk golden hour". Becomes the file the user sees in their Assets.

promptstring required

The full scene as 2-5 sentences of flowing prose, directing medium, subject, setting, light, and composition — YES "A photorealistic overhead shot of a cluttered founder desk at golden hour, one glowing laptop as the focal point, deep negative space on the right", NOT "desk, laptop, startup, 4k, trending, professional". When reference_keys are given, also say what each referenced object does in the scene.

aspectRatio'1:1' | '4:5' | '3:4' | '16:9' | '9:16' required

LinkedIn feed image: 4:5. Wide header: 16:9.

size'1K' | '2K'

1K draft, 2K final.

quality'standard' | 'premium'

standard = the default model (default). premium = the fidelity escalation, several times the price.

reference_keysstring[]

Up to 6 media keys to condition on: brand-asset keys from the digest, mediaKeys of earlier generated images, or chat-upload keys. Omit for a purely imagined scene.

budgetUsdnumber

The most this call may spend, in USD (default 2, max 10). Held while the tool runs, released after.

Response

OK

toolstring required
outputunknown required
chargedUsdnumber required

Changes

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