Images

List your images on BetterWaifu, newest first — site generations and API generations alike. The id of each entry is what Generate accepts as source_image_id for img2img.

Endpoint

GET /api/v1/images

Authentication

Requires a valid API key in the Authorization header.

Authorization: Bearer bw_your_api_key_here

Query parameters

Param	Type	Default	Description
`limit`	number	20	Images per page (1-50)
`cursor`	string	-	The `next_cursor` from a previous page

Example Request

curl "https://betterwaifu.com/api/v1/images?limit=20" \
  -H "Authorization: Bearer bw_your_api_key_here"

Response

Success Response (200)

{
  "images": [
    {
      "id": "3PHHgFQ34v",
      "url": "https://cdn.betterwaifu.com/abc/3PHHgFQ34v.webp",
      "prompt": "1girl, solo, long hair, blue eyes",
      "width": 832,
      "height": 1216,
      "seed": 1099801386,
      "model_name": "tPonynai3",
      "created_at": "2026-09-01T16:13:13.254Z"
    }
  ],
  "next_cursor": "3PHHgFQ34v"
}

next_cursor is null on the last page; pass it back as cursor to fetch the next one.

Notes

Only your own images are listed; expired free-tier images are excluded
Use an entry's id as source_image_id in Generate for img2img