> ## Documentation Index
> This page is part of the Image and Video APIs product. Fetch the complete documentation index for Image and Video APIs at: https://cloudinary.com/documentation/llms-image-and-video-apis.txt?referrer=docpage and then use it to discover all relevant pages before exploring further.
> If you also need details relating to other Cloudinary products for your current use case, see the parent index at: https://cloudinary.com/documentation/llms.txt?referrer=docpage

# Image to Video (Beta)


> **INFO**: The Image to Video Add-on is currently in **Beta**. There may be minor changes to parameter names or other implementation details before the general access release. We invite you to try it out. We would appreciate any feedback via our [support team](https://support.cloudinary.com/hc/en-us/requests/new).

The Image to Video Add-on uses AI to generate videos from your images. You provide one or more source images with a text prompt describing the motion or scene you want, and Cloudinary generates a video and saves it to the 'image-to-video' folder in your [Media Library](https://console.cloudinary.com/console/media_library/search). You drive video generation from the **Image to Video** app in the [Cloudinary Console](https://console.cloudinary.com).

![Image to Video app](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1784575188/docs/video_player_studio/image-to-video-home.png "thumb: w_700,dpr_2, width:700, with_url:false, with_code:false")

## Getting access

The Image to Video feature is enabled via an add-on subscription. You can subscribe on a self-service basis from the [Add-on Marketplace](cloudinary_add_ons#registering_for_add_ons). If you need help, [contact support](https://support.cloudinary.com/hc/en-us/requests/new).

> **NOTE**: If you're using our [Asia Pacific or Europe data centers](admin_api#alternative_data_centers_and_endpoints_premium_feature), the Image to Video Add-on isn't currently available.

> **TIP**: Your data center is set per product environment, and new product environments are US-based by default. If your current product environment is on a non-US data center, you can create a new US-based one to try out the add-on.

Once your subscription is active, the add-on appears on the **Installed Add-ons** tab of the [Add-ons](https://console.cloudinary.com/app/settings/addons) page in the Console. Depending on your account or product environment setup, you may need to access add-ons from **Settings > Add-ons** instead.

## Plans and quota

Each plan provides a monthly quota of credits, and every video you generate consumes credits from that quota. Enabling **Audio** consumes twice as many credits as the same generation without audio.

When you run out of credits for the current billing cycle, you can't generate more videos until more credits are available. The **Image to Video** app displays your remaining credits so you can monitor usage before generating more videos.

For details about prorated billing, mid-cycle upgrades, and downgrade behavior, see [Add-on units and billing](cloudinary_add_ons#add_on_units_and_billing).

### Free trial

Accounts on a paid Cloudinary plan receive a one-time allocation of 32 free trial credits so you can try the Image to Video Add-on before subscribing to an add-on plan. Each video you generate consumes trial credits, and the **Image to Video** app displays how many are left.

## Providing source images

You can provide source images using two modes, selectable via the tabs at the top of the left panel:

* **Start & End Frames** (default): Add a start frame and optionally an end frame. The generated video transitions from the start frame to the end frame based on your prompt.
* **Reference Images**: Add a main image and up to two additional reference images to help guide the style of the generated video. Reference Images and End Frame are mutually exclusive, so you'll need to remove an end frame before adding reference images, or vice versa.

To add images, click **Add Start Frame**, **Add End Frame**, or **Add photo** depending on the selected mode.

## Writing a prompt

Under **What do you want to create?**, enter a text description of the scene or motion you want to generate. For example, "Turn around" or "add rain".

If you're not sure what to write, open **Presets** and choose one of the **Suggested** presets:

* Freestyle Animate
* Zoom In
* Zoom Out
* Pan Left
* Pan Right
* Rotate
* Fade In
* Fade Out
* Slow Motion
* Time Lapse
* Cinematic Movement
* Dramatic Reveal

Selecting a preset populates the prompt field with a description optimized for that type of motion. You can also save and reuse your own prompts under **Your Presets** via **Manage presets**.

## Configuring advanced settings

Expand **Advanced Settings** to configure the following options:

| Setting | Options | Default | Description |
|---------|---------|---------|-------------|
| **Resolution** | `720p`, `1080p` | `720p` | The resolution of the generated video. |
| **Aspect Ratio** | `auto`, `16:9`, `9:16` | `auto` | The aspect ratio of the generated video. |
| **Duration (secs)** | `4`, `6`, `8` | `4` | The length of the generated video in seconds. |
| **Audio** | `On`/`Off` | `Off` | Whether the generated video includes audio. |
| **Prompt Enhancement** | `On`/`Off` | `On` | Enhances the prompt during video generation using visual analysis of the image. |

> **NOTE**:
>
> Enabling **Audio** consumes 2× credits. For more details, see [Plans and quota](#plans_and_quota).

## Generating the video

After configuring your image, prompt, and settings, click **Generate Video** to start. The right panel displays a loading state while Cloudinary generates the video.

Once the video is ready, the app displays a full preview with playback controls. A notification confirms that the video has been saved to the 'image-to-video' folder in your [Media Library](https://console.cloudinary.com/console/media_library/search).

For example, the following run uses a start frame, an end frame, and the **Dramatic Reveal** preset:

Start frame

End frame

The preset fills in a prompt describing a slow, controlled zoom that builds tension. Clicking **Generate Video** produces a video that transitions from the start frame to the end frame:

![Dramatic Reveal output transitioning from the start frame to the end frame](https://cloudinary-res.cloudinary.com/video/upload/v1776774267/docs/video_player_studio/i2v_example_output.mp4 "thumb: w_500,dpr_2, width:500, with_url:false, with_code:false, muted:true, poster:https://cloudinary-res.cloudinary.com/video/upload/so_1.5/c_scale,w_500,dpr_2.0/v1776774267/docs/video_player_studio/i2v_example_output.jpg")

> **NOTE**: AI-generated output varies between runs. Your result for the same inputs may look different.

## Viewing and sharing creations

The top bar provides the following options:

* **Generated Videos**: Opens a picker of your previously generated videos. Select one to reopen it and continue editing, as described in [Iterating on a generation](#iterating_on_a_generation).
* **Share**: Shares the generated video.
* **Share Feedback**: Provides feedback on the Image to Video app.

## Iterating on a generation

Each video you generate saves the settings used to create it, so you can refine a result instead of starting over. Open a previous generation from **Generated Videos** in the top bar, and the app restores that video's source images, prompt, and advanced settings. Adjust any of them and click **Generate Video** to create a new version.

The generation settings are saved with the video as contextual metadata, so they stay with the asset. They don't appear among the video's visible metadata in the Media Library.

## Generating videos via the API

In addition to the **Image to Video** app, you can generate videos programmatically using the Image to Video API. You submit an image and a prompt to create a generation job, poll the job until it completes, and receive the generated video's asset details and delivery URL. You can also save and reuse prompts.

The API uses Basic Authentication with your Cloudinary API Key and API Secret, and its base URL is `https://api.cloudinary.com/v2/video/{cloudName}`.

> **NOTE**:
>
> The Image to Video API is in **Beta** and isn't yet in its final form. Endpoints, parameters, and response payloads may change before the general access release.

For the full list of endpoints, request and response payloads, and interactive examples, see the [Image to Video API reference](image_to_video_reference).