Images

List Images

List the images your account has generated.

These are exactly the URLs accepted as inputs elsewhere in the API. Use this to look up what you can edit or animate.

GET/v1/imagesTry it

List Images

cURL

curl --request GET \
  --url 'https://api.spicyapi.com/v1/images?limit=50' \
  --header 'Authorization: Bearer $SPICYAPI_KEY'

200

JSON

{
  "data": [
    {
      "url": "https://cdn.spicyapi.com/outputs/a1b2/req_8f2a91c4-0.png",
      "source": "image",
      "prompt": "blonde woman sunbathing on a private beach, golden hour",
      "tags": ["solo", "outdoor", "realistic"],
      "created_at": "2026-08-23T10:14:02.000Z"
    }
  ]
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your SpicyAPI key (sk-spicy-…). Create one in the dashboard under API Keys.

Query parameters

limitinteger

How many to return, newest first, 1 to 100. Defaults to 50.

afterstring

The url of the last image on the previous page, to get the next page. Not with q or tag.

qstring

Plain-language search over your library, e.g. blonde on a beach at sunset. Ranks your most recent 250 images by how well their prompts match; returns nothing when no image plausibly fits.

tagstring

Filter by an auto-assigned tag: solo, couple, group, pov, outdoor, indoor, lingerie, nude, explicit, anime, realistic, closeup.

Response

200 · application/json

Successful Response

dataAsset · object[]required

Your generated images, newest first (or best match first when q is set).

has_morebooleanrequired

True when the page came back full: pass the last url as after.

Was this page helpful?

Suggest edits Raise issue

List Styles