Artwork

Get an artwork job

Returns processing state and print eligibility for one account-owned artwork. purchasable becomes true only after processing completes and an image is uploaded. For a private import, image paths are returned only to the signed-in owner using a user-session token and are null for account API keys and MCP access tokens.

get/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:read)

Query parameters

idstring uuid required

Account-owned artwork job ID.

Response

Current artwork state and metadata.

jobIdstring uuid required
idstring uuid required

Legacy alias of jobId.

status'processing' | 'failed' | 'complete' | 'unknown' required
statusCode1 | 2 | 3 required
creditsRemaininginteger required
imageUploadedboolean required
imagePathsstring[] nullable
image_pathsstring[] nullable
imagePrivateboolean required
visibilitystring nullable
sourcestring nullable
purchasableboolean required
aspect'square' | 'portrait' | 'landscape' required
imageModelSizestring required
promptSizeinteger nullable
titlestring nullable
descriptionstring nullable
originalPromptstring nullable
revisedPromptstring nullable
keywordsstring[] nullable

Changes

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