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..."
}

GET

pictoryapis

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.

Show Video Object Properties

url

string

Direct download URL for the generated video file (MP4)

string

The unique identifier of the generated video

prompt

string

The text prompt that was used to generate this video

aspectRatio

string

The aspect ratio of the generated video (e.g., "16:9", "9:16", "1:1")

createdDate

string

ISO 8601 timestamp of when the video was generated

model

string

The AI model that was used for generation (e.g., "pixverse5.5", "veo3.1")

width

number

Width of the generated video in pixels

height

number

Height of the generated video in pixels

duration

string

Duration of the generated video (e.g., "8s")

previewImageUrl

string

URL for the video preview image (JPG)

thumbnailImageUrl

string

URL for the video thumbnail image (JPG)

lastFrameImageUrl

string

URL for the last frame of the video (PNG). This can be used as a firstFrameImageUrl in a subsequent generation request.

firstFrameImageUrl

string

The first frame image URL that was provided in the original request, if applicable

referenceImageUrls

array

The reference image URLs that were provided in the original request, if applicable

extendVideoUrl

string

The source video URL that was extended, if applicable

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 Code	Description
200	Request processed successfully. The `items` array contains the generated videos. An empty array is returned if no videos have been generated.
401	Unauthorized. The API key in the `Authorization` header is missing or invalid.
500	Internal server error. Retry the request after a brief delay.

Response Fields

Field	Type	Always Present	Description
`url`	string	Yes	Direct download URL for the generated video (MP4)
`id`	string	Yes	Unique identifier of the generated video
`prompt`	string	Yes	The text prompt used to generate the video
`aspectRatio`	string	Yes	Aspect ratio of the video (e.g., `"9:16"`)
`createdDate`	string	Yes	ISO 8601 creation timestamp
`model`	string	Yes	AI model used for generation
`width`	number	Yes	Video width in pixels
`height`	number	Yes	Video height in pixels
`duration`	string	Yes	Video duration (e.g., `"8s"`)
`previewImageUrl`	string	Yes	Preview image URL (JPG)
`thumbnailImageUrl`	string	Yes	Thumbnail image URL (JPG)
`lastFrameImageUrl`	string	Yes	Last frame image URL (PNG), useful for creating video continuations
`firstFrameImageUrl`	string	No	Present only if a first frame image was provided in the original request
`referenceImageUrls`	array	No	Present only if reference images were provided in the original request
`extendVideoUrl`	string	No	Present 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

Get Generated Images Get Smart Layouts

⌘I

​Overview

​API Endpoint

​Request Parameters

​Headers

​Query Parameters

​Response

​Success Response (200)

​Response Examples

​Status Codes

​Response Fields

​Pagination

​Code Examples

Overview

API Endpoint

Request Parameters

Headers

Query Parameters

Response

Success Response (200)

Response Examples

Status Codes

Response Fields

Pagination

Code Examples