---
title: "GET /api/product_to_videos/"
method: GET
path: "/api/product_to_videos/"
tags: ["product_to_videos"]
---

# GET /api/product_to_videos/

`GET /api/product_to_videos/`

Retrieve a list of videos, with an optional ids param to filter vdieo by their UUIDs.

## Query parameters

- `ids` string

## Response `200`

- ProductToVideo[]
  - `id` string, uuid, required
  - `type` 'product_anyshot' | 'product_avatar' — * `product_anyshot` - Product AnyShot * `product_avatar` - Product Avatar
  - `product_url` string, uri, required — URL of the product image to use for video generation (must be a direct image URL, e.g. PNG, JPG, WEBP).
  - `aspect_ratio` '9x16' | '16x9' | '1x1' — * `9x16` - 9X16 * `16x9` - 16X9 * `1x1` - 1X1
  - `override_avatar` string, uuid, nullable — Override avatar for the video. Default is null.
  - `motion_style` union — The motion style of the product avatar when start generate video.The prerequisite is that the image has an avatar. * `talking` - Talking * `display` - Display
    - 'talking' | 'display' — * `talking` - Talking * `display` - Display
    - unknown
  - `product_showcase_url` string, nullable — The sample diagram url of the product you wish to generate.
  - `image_prompt` string, nullable — User prompt for generate image description
  - `video_prompt` string, nullable — User prompt for generate video description
  - `status` 'initializing' | 'image_generating' | 'image_generated' | 'video_generating' | 'video_generated' | 'failed', required
  - `generated_video_url` string, required — The generated video url.
  - `generated_photo_url` string, required — The generated image url.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `webhook_url` string, uri, nullable — Webhook URL for status updates. Default is null.
  - `failed_reason` string, required — The generated image url.
  - `regen_type` string, required — The generated image url.
  - `regen_source_id` string, required — The generated video url.

---

[API](https://skmtc.dev/creatify/apis/creatify-ai-api.md) · [All operations](https://skmtc.dev/creatify/apis/creatify-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/creatify/creatify-ai-api/revisions/7ca3bf8077ba/schema)