Artwork

Queue an artwork generation

Spends one available generation credit and queues an artwork job. For text-only creation, send JSON with inputType: describe, a prompt, and an image-model size. Multipart form data additionally supports an uploaded reference image; printPhoto and interiorPhoto require that image. An interior photo supplies palette, mood, and style context—the output is standalone artwork, not a recreation of the room. Use the selected print variant's exact generation.imageModelSize to guarantee aspect compatibility at checkout.

post/api/image-generations

Request

  • Base URL: https://api.createprints.ai
  • URL: https://api.createprints.ai/api/image-generations
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.createprints.ai/api/oauth/authorize, token URL https://api.createprints.ai/api/oauth/token, scopes: artwork:create)

Request body

inputType'describe' | 'printPhoto' | 'interiorPhoto'
promptstring required

Artwork description; required for JSON.

sizestring required

Width and height must be multiples of 16; longest side ≤3840 px; aspect ≤3:1; 655,360–8,294,400 total pixels. Prefer the selected variant's generation.imageModelSize.

keywordsstring[]
colorsstring[]
seedIdstring nullable
forceOriginalPromptboolean
referenceImageUrlstring uri nullable
revisionboolean

Example request

{
  "size": "1536x1536"
}

Response

The artwork job was queued.

jobIdstring uuid required
status'queued' required
statusUrlstring required

Relative polling URL.

creditsRemaininginteger required

Changes

No recorded changes to this operation across all 1 revision of this API.