Follow this recipe to generate video using text:

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

Veo3 Using Uploaded Image Generate in 720p

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",
    "duration": 8,
    "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",
    "duration": 8,
    "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",
    "duration": 8,
    "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",
    "duration": 8,
    "model": "VEO3FAST",
    "isPublic": false
}
'

📘

Generated vs Uploaded Images

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

📘

Duration

Duration can be 4, 6, or 8. The units is seconds.

📘

Default Dimension

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

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

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

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

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

Veo3 8s video costs 2140 API Credits

Veo3 6s video costs 1605 API Credits

Veo3 4s video costs 1070 API Credits

Veo3 Fast 8s video costs 1092 API Credits

Veo3 Fast 6s video costs 819 API Credits

Veo3 Fast 4s video costs 546 API Credits