Skip to main content

Get images

Request

curl -X GET \
https://api.gpuless.io/v1/images \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {YOUR_API_KEY}'

Request` parameter

None

Response

{
"images": [
{
"status": "generated",
"image_id":"092cb6da-e1cd-4324-89d4-b7799a9f3166",
"metadata": {
"model":"anything-v4",
"prompt":"(masterpiece) 1girl maid cat ear",
"negative_prompt":"nsfw"
},
"image_url": "https://api.gpuless.io/v1/images/092cb6da-e1cd-4324-89d4-b7799a9f3166",
"raw_image_url": "https://api.gpuless.io/v1/images/092cb6da-e1cd-4324-89d4-b7799a9f3166/raw"
}
]
}

Response parameter

Image_url is the URL of the image file of [avif format] (https://en.wikipedia.org/wiki/avif) suitable for display on the client side. The file size is reduced by about 90%compared to PNG. In addition, this image is automatically cached in a location close to the user and can be displayed very fast. Normally, the size of one file is 30 to 50KB.

raw_image_url is the same image as image_url, but it is the URL of PNG format image files. It is intended to be accessed from the back end and used for storage. Normally, the size per file is 300 ~ 500KB.

Use image_url as much as possible to display at the client side.

KeyTypeRequiredComment
image_idstringA unique identifier of the image by UUIDv4
statusstringImage generation status work_in_progress,generated,error
modelstringAI model name. Currently only Anything-V4 is supported
metadataobjectMetadata used for image generation
image_urlstringURL of AVIF format image file
raw_image_urlstringURL of PNG format image file