Skip to main content
GET
/
v1
/
images
List your generation history
curl --request GET \
  --url https://api.example.com/v1/images \
  --header 'X-Api-Key: <api-key>'
{
  "object": "list",
  "data": [
    {
      "id": "img_01HXMQ7Z3K8Y2ABCDEFGHJKM",
      "status": "succeeded",
      "prompt": "A golden sunset over mountains, cinematic lighting",
      "created_at": "2026-05-04T10:00:00Z",
      "media_type": "image",
      "negative_prompt": "blurry, low quality",
      "output_urls": [
        "https://api.aurous-labs.com/v1/images/img_01HXMQ7Z3K8Y2ABCDEFGHJKM/output/0?token=..."
      ],
      "output_video_url": "https://api.aurous-labs.com/v1/videos/vid_01HXMQ7Z3K8Y2ABCDEFGHJKM/output?token=...",
      "reference_image_urls": [
        "https://example.com/ref1.jpg"
      ],
      "error_message": "Content policy violation",
      "duration_ms": 14820,
      "cost": {
        "amount": 2,
        "currency": "credit",
        "breakdown": {
          "base": 1,
          "enhance": 1
        }
      },
      "width": 1024,
      "height": 1024,
      "image_count": 1,
      "size_preset": "square",
      "inference_type": "t2i",
      "seed": 42,
      "video_duration": 5,
      "video_resolution": "480p",
      "video_ratio": "16:9",
      "video_camera_fixed": {},
      "character_id": "char_01HXMQ7Z3K8Y2ABCDEFGHJKM",
      "bundle_name": "Cinematic Trio",
      "loras": [
        {
          "id": "lora_01HXMQ7Z3K8Y2ABCDEFGHJKM",
          "name": "Sunset Style"
        }
      ],
      "aurous_version": "2026-05-15",
      "creation_request_id": "req_01HXMQ7Z3K8Y2ABCDEFGHJKM",
      "completed_at": "2026-05-04T10:00:14Z"
    }
  ],
  "has_more": true,
  "next_cursor": "img_01HXMQ7Z3K8Y2ABCDEFGHJKM"
}

Documentation Index

Fetch the complete documentation index at: https://docs.aurous-labs.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-Api-Key
string
header
required

Your team API key (starts with al_live_ — legacy keys may start with og_).

Headers

Aurous-Version
string

Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-05-15 for unauthenticated requests.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-05-15"

Query Parameters

starting_after
string

Cursor — opaque ID; returns rows STRICTLY OLDER than this

Example:

"img_01HXMQ7Z3K8Y2ABCDEFGHJKM"

ending_before
string

Cursor — opaque ID; returns rows STRICTLY NEWER than this

Example:

"img_01HXMQ7Z3K8Y2ABCDEFGHJKM"

limit
number

Items per page (1–100, default 20)

Example:

20

Response

Cursor-paginated list of generations

object
enum<string>
required

Discriminator

Available options:
list
Example:

"list"

data
object[]
required

Array of GenerationResponse items

has_more
boolean
required

True when the next page exists

Example:

true

next_cursor
object

Pass as ?starting_after= on the next request. null when has_more is false.

Example:

"img_01HXMQ7Z3K8Y2ABCDEFGHJKM"