Skip to main content
GET
/
pictoryapis
/
v1
/
aistudio
/
videos
Get Generated Videos
curl --request GET \
  --url https://api.pictory.ai/pictoryapis/v1/aistudio/videos \
  --header 'Authorization: <authorization>'
{
    "items": [
        {
            "url": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/d7c6b5a4-e3f2-1098-dcba-fedcba987654.mp4",
            "id": "20260409185104635ec00b33280fc451f",
            "prompt": "A woman sitting on the grass as children run and play around her in a wide shot",
            "aspectRatio": "9:16",
            "createdDate": "2026-04-09T18:51:47.967Z",
            "model": "pixverse5.5",
            "width": 720,
            "height": 1280,
            "duration": "8s",
            "previewImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/d7c6b5a4-e3f2-1098-dcba-fedcba987654_preview.jpg",
            "thumbnailImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/d7c6b5a4-e3f2-1098-dcba-fedcba987654_thumbnail.jpg",
            "lastFrameImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/d7c6b5a4-e3f2-1098-dcba-fedcba987654_last_frame.png"
        },
        {
            "url": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/f8e7d6c5-b4a3-2190-fedc-ba0987654321.mp4",
            "id": "2026040918025436554deba0b339b4a01",
            "prompt": "A woman walking through an open field towards a farmhouse in the distance in a wide shot",
            "aspectRatio": "9:16",
            "createdDate": "2026-04-09T18:02:57.039Z",
            "model": "pixverse5.5",
            "width": 720,
            "height": 1280,
            "duration": "8s",
            "previewImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/f8e7d6c5-b4a3-2190-fedc-ba0987654321_preview.jpg",
            "thumbnailImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/f8e7d6c5-b4a3-2190-fedc-ba0987654321_thumbnail.jpg",
            "lastFrameImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/f8e7d6c5-b4a3-2190-fedc-ba0987654321_last_frame.png",
            "referenceImageUrls": [
                "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/a9b8c7d6-e5f4-3210-abcd-ef9876543210_last_frame.png",
                "https://example.cloudfront.net/images/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/1a2b3c4d-5e6f-7890-abcd-ef0123456789.png"
            ]
        }
    ],
    "nextPageKey": "eyJwYXJ0aXRpb25LZXkiOiJ1c2VyI..."
}

​
Overview

This endpoint retrieves a paginated list of all AI-generated videos associated with your account. The results are sorted by creation date in descending order, with the most recent videos returned first. Each item includes the video URL, prompt, model, dimensions, duration, thumbnail images, 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/videos

​
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 video 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/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/d7c6b5a4-e3f2-1098-dcba-fedcba987654.mp4",
            "id": "20260409185104635ec00b33280fc451f",
            "prompt": "A woman sitting on the grass as children run and play around her in a wide shot",
            "aspectRatio": "9:16",
            "createdDate": "2026-04-09T18:51:47.967Z",
            "model": "pixverse5.5",
            "width": 720,
            "height": 1280,
            "duration": "8s",
            "previewImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/d7c6b5a4-e3f2-1098-dcba-fedcba987654_preview.jpg",
            "thumbnailImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/d7c6b5a4-e3f2-1098-dcba-fedcba987654_thumbnail.jpg",
            "lastFrameImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/d7c6b5a4-e3f2-1098-dcba-fedcba987654_last_frame.png"
        },
        {
            "url": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/f8e7d6c5-b4a3-2190-fedc-ba0987654321.mp4",
            "id": "2026040918025436554deba0b339b4a01",
            "prompt": "A woman walking through an open field towards a farmhouse in the distance in a wide shot",
            "aspectRatio": "9:16",
            "createdDate": "2026-04-09T18:02:57.039Z",
            "model": "pixverse5.5",
            "width": 720,
            "height": 1280,
            "duration": "8s",
            "previewImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/f8e7d6c5-b4a3-2190-fedc-ba0987654321_preview.jpg",
            "thumbnailImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/f8e7d6c5-b4a3-2190-fedc-ba0987654321_thumbnail.jpg",
            "lastFrameImageUrl": "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/f8e7d6c5-b4a3-2190-fedc-ba0987654321_last_frame.png",
            "referenceImageUrls": [
                "https://example.cloudfront.net/videos/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/a9b8c7d6-e5f4-3210-abcd-ef9876543210_last_frame.png",
                "https://example.cloudfront.net/images/user/a1b2c3d4-e5f6-7890-abcd-ef1234567890/1a2b3c4d-5e6f-7890-abcd-ef0123456789.png"
            ]
        }
    ],
    "nextPageKey": "eyJwYXJ0aXRpb25LZXkiOiJ1c2VyI..."
}

​
Status Codes

Status CodeDescription
200Request processed successfully. The items array contains the generated videos. An empty array is returned if no videos 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

FieldTypeAlways PresentDescription
urlstringYesDirect download URL for the generated video (MP4)
idstringYesUnique identifier of the generated video
promptstringYesThe text prompt used to generate the video
aspectRatiostringYesAspect ratio of the video (e.g., "9:16")
createdDatestringYesISO 8601 creation timestamp
modelstringYesAI model used for generation
widthnumberYesVideo width in pixels
heightnumberYesVideo height in pixels
durationstringYesVideo duration (e.g., "8s")
previewImageUrlstringYesPreview image URL (JPG)
thumbnailImageUrlstringYesThumbnail image URL (JPG)
lastFrameImageUrlstringYesLast frame image URL (PNG), useful for creating video continuations
firstFrameImageUrlstringNoPresent only if a first frame image was provided in the original request
referenceImageUrlsarrayNoPresent only if reference images were provided in the original request
extendVideoUrlstringNoPresent only if the video was generated by extending another video

​
Pagination

The API returns up to 100 videos 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/videos?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/videos' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'accept: application/json' | python -m json.tool