Skip to main content
GET
/
pictoryapis
/
v1
/
aistudio
/
images
Get Generated Images
curl --request GET \
  --url https://api.pictory.ai/pictoryapis/v1/aistudio/images \
  --header 'Authorization: <authorization>'
{
    "items": [
        {
            "url": "https://example.cloudfront.net/images/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/c3d4e5f6-a7b8-9012-cdef-345678901234.png",
            "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
            "prompt": "A modern workspace with an open laptop on a clean desk, illuminated by warm daylight from a nearby window",
            "aspectRatio": "16:9",
            "createdDate": "2026-04-04T06:03:38.665Z",
            "model": "nanobanana",
            "width": 1024,
            "height": 1024,
            "style": "photorealistic",
            "referenceImageUrl": "https://example.cloudfront.net/images/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/b2c3d4e5-f6a7-8901-bcde-234567890123.png"
        },
        {
            "url": "https://example.cloudfront.net/images/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/e5f6a7b8-c9d0-1234-efab-567890123456.png",
            "id": "e5f6a7b8-c9d0-1234-efab-567890123456",
            "prompt": "A man playing guitar on a beach during sunset",
            "aspectRatio": "16:9",
            "createdDate": "2026-03-15T21:26:36.239Z",
            "model": "seedream3.0",
            "width": 1280,
            "height": 720
        }
    ],
    "nextPageKey": "eyJwYXJ0aXRpb25LZXkiOiJ1c2VyI..."
}

Overview

This endpoint retrieves a paginated list of all AI-generated images associated with your account. The results are sorted by creation date in descending order, with the most recent images returned first. Each item includes the image URL, prompt, model, dimensions, and other metadata from the original generation request.
A valid API key is required to use this endpoint. Obtain your API key from the API Access page in your Pictory dashboard.

API Endpoint

GET https://api.pictory.ai/pictoryapis/v1/aistudio/images

Request Parameters

Headers

Authorization
string
required
API key for authentication (starts with pictai_)
Authorization: YOUR_API_KEY

Query Parameters

nextPageKey
string
A pagination token returned in the previous response. Pass this value to retrieve the next page of results. Omit this parameter to fetch the first page.

Response

Success Response (200)

items
array
An array of generated image objects, sorted by creation date (newest first). Up to 100 items are returned per page.
nextPageKey
string
A pagination token to retrieve the next page of results. This field is only present when additional pages are available. Pass this value as the nextPageKey query parameter in the next request.

Response Examples

{
    "items": [
        {
            "url": "https://example.cloudfront.net/images/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/c3d4e5f6-a7b8-9012-cdef-345678901234.png",
            "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
            "prompt": "A modern workspace with an open laptop on a clean desk, illuminated by warm daylight from a nearby window",
            "aspectRatio": "16:9",
            "createdDate": "2026-04-04T06:03:38.665Z",
            "model": "nanobanana",
            "width": 1024,
            "height": 1024,
            "style": "photorealistic",
            "referenceImageUrl": "https://example.cloudfront.net/images/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/b2c3d4e5-f6a7-8901-bcde-234567890123.png"
        },
        {
            "url": "https://example.cloudfront.net/images/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/e5f6a7b8-c9d0-1234-efab-567890123456.png",
            "id": "e5f6a7b8-c9d0-1234-efab-567890123456",
            "prompt": "A man playing guitar on a beach during sunset",
            "aspectRatio": "16:9",
            "createdDate": "2026-03-15T21:26:36.239Z",
            "model": "seedream3.0",
            "width": 1280,
            "height": 720
        }
    ],
    "nextPageKey": "eyJwYXJ0aXRpb25LZXkiOiJ1c2VyI..."
}

Status Codes

Status CodeDescription
200Request processed successfully. The items array contains the generated images. An empty array is returned if no images have been generated.
401Unauthorized. The API key in the Authorization header is missing or invalid.
500Internal server error. Retry the request after a brief delay.

Response Fields

FieldTypeDescription
urlstringDirect download URL for the generated image
idstringUnique identifier of the generated image
promptstringThe text prompt used to generate the image
aspectRatiostringAspect ratio of the image (e.g., "16:9")
createdDatestringISO 8601 creation timestamp
modelstringAI model used for generation
widthnumberImage width in pixels
heightnumberImage height in pixels
stylestringVisual style applied (present only if specified in the original request)
referenceImageUrlstringReference image URL (present only if specified in the original request)

Pagination

The API returns up to 100 images per page. If more results are available, the response includes a nextPageKey field. To retrieve subsequent pages, pass this token as a query parameter in the next request. Example paginated request:
GET https://api.pictory.ai/pictoryapis/v1/aistudio/images?nextPageKey=eyJwYXJ0aXRpb25LZXkiOiJ1c2VyI...
When no nextPageKey is present in the response, you have reached the last page.

Code Examples

Replace YOUR_API_KEY with your actual API key from the API Access page.
curl --request GET \
  --url 'https://api.pictory.ai/pictoryapis/v1/aistudio/images' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'accept: application/json' | python -m json.tool