Skip to main content
GET
Get Image
Use this endpoint when Generate Image returns an image record whose image_url is empty, or to retrieve an existing image. Pass its id as the camelCase query parameter imageId.
The response is a single object. Read image_url at the top level. Use the same account’s API key that created the image. For pending images, poll every 15–30 seconds with a bounded timeout. Stop on HTTP errors and retain the ID on timeout. This endpoint has no normalized job status field, so an empty URL alone cannot distinguish processing from a failed generation. Do not automatically submit another paid generation when polling stops.

Authorizations

x-api-key
string
header
required

API key for authentication. Get yours at https://easy-peasy.ai/settings/api

Query Parameters

imageId
integer
required

The id from a Generate Image response.

Response

Image record

Image record returned directly, without an image wrapper. Additional record fields may be present.

id
integer
image_url
string | null

Image URL when ready; empty or null while pending.

model
string
prompt
string
used_credits
number
created_at
string<date-time>