Generate with Veo3 and Veo3 Fast Using Start Frame

Example for generating a video with uploaded images as a start frame using Veo3 and Veo3 Fast

Follow this recipe to generate video using text:

The guide will recreate the following functionality in the Web UI via API.

Veo3 720p Using Uploaded Image Sample Request

curl --request POST \
     --url https://cloud.leonardo.ai/api/rest/v1/generations-image-to-video\
     --header 'accept: application/json' \
     --header 'authorization: Bearer <YOUR_API_KEY>' \
     --header 'content-type: application/json' \
     --data'
{
    "prompt":"a breathtaking, cinematic sequence of a massive crystal whale gliding through a vast night sky that behaves like a deep ocean. The whale’s body is sculpted from translucent, glimmering crystal—its surface faceted like a gemstone, catching moonlight and scattering it in radiant rainbow beams across the sky. Each movement creates soft refractions that dance across the clouds, making them ripple like bioluminescent waves.",
    "imageId" : "<YOUR_INIT_IMAGE_ID>",
    "imageType": "UPLOADED",
    "resolution": "RESOLUTION_720",
    "model": "VEO3",
    "isPublic": false
}
'

Veo3 Using Uploaded Image Generate in 1080p

Change "resolution": "RESOLUTION_720" to "resolution": "RESOLUTION_1080"

Veo3 1080p Using Uploaded Image Sample Request

curl --request POST \
     --url https://cloud.leonardo.ai/api/rest/v1/generations-image-to-video\
     --header 'accept: application/json' \
     --header 'authorization: Bearer <YOUR_API_KEY>' \
     --header 'content-type: application/json' \
     --data'
{
    "prompt":"a breathtaking, cinematic sequence of a massive crystal whale gliding through a vast night sky that behaves like a deep ocean. The whale’s body is sculpted from translucent, glimmering crystal—its surface faceted like a gemstone, catching moonlight and scattering it in radiant rainbow beams across the sky. Each movement creates soft refractions that dance across the clouds, making them ripple like bioluminescent waves.",
    "imageId" : "<YOUR_INIT_IMAGE_ID>",
    "imageType": "UPLOADED",
    "resolution": "RESOLUTION_1080",
    "model": "VEO3",
    "isPublic": false
}
'

Generate With Veo3 Fast Model Using Uploaded Image

Follow this recipe to generate video using text:

The guide will recreate the following functionality in the Web UI via API.

Veo3 Fast 720p Sample Request

curl --request POST \
     --url https://cloud.leonardo.ai/api/rest/v1/generations-image-to-video\
     --header 'accept: application/json' \
     --header 'authorization: Bearer <YOUR_API_KEY>' \
     --header 'content-type: application/json' \
     --data'
{
    "prompt":"a breathtaking, cinematic sequence of a massive crystal whale gliding through a vast night sky that behaves like a deep ocean. The whale’s body is sculpted from translucent, glimmering crystal—its surface faceted like a gemstone, catching moonlight and scattering it in radiant rainbow beams across the sky. Each movement creates soft refractions that dance across the clouds, making them ripple like bioluminescent waves.",
    "imageId" : "<YOUR_INIT_IMAGE_ID>",
    "imageType": "UPLOADED",
    "resolution": "RESOLUTION_720",
    "model": "VEO3FAST",
    "isPublic": false
}
'

Veo3 Fast 1080p Sample Request

curl --request POST \
     --url https://cloud.leonardo.ai/api/rest/v1/generations-image-to-video\
     --header 'accept: application/json' \
     --header 'authorization: Bearer <YOUR_API_KEY>' \
     --header 'content-type: application/json' \
     --data'
{
    "prompt":"a breathtaking, cinematic sequence of a massive crystal whale gliding through a vast night sky that behaves like a deep ocean. The whale’s body is sculpted from translucent, glimmering crystal—its surface faceted like a gemstone, catching moonlight and scattering it in radiant rainbow beams across the sky. Each movement creates soft refractions that dance across the clouds, making them ripple like bioluminescent waves.",
    "imageId" : "<YOUR_INIT_IMAGE_ID>",
    "imageType": "UPLOADED",
    "resolution": "RESOLUTION_1080",
    "model": "VEO3FAST",
    "isPublic": false
}
'

📘

Generated vs Uploaded Images

To use a generated image ID, change imageType to GENERATED.

📘

Default Dimension

Veo3 720p generates at an aspect ratio of 16:9 at dimensions 1280x720.

Veo3 1080p generates at an aspect ratio of 16:9 at dimensions 1920x1080.

Dimensions will default to 16:9, height and width are not required. Please note uploaded images will be cropped to fit those dimensions.

📘

Switch to Motion 2

To use Motion 2.0, remove the model parameter or set it to MOTION2.

Parameters such as frameinterpolation and promptEnhance are not compatible with Veo3.

Cost

The Text-to-Video endpoint costs 4000 API Credits per Veo3 video

The Text-to-Video endpoint costs 2140 API Credits per Veo3 Fast video