This guide shows how to generate images using Veo 3.0 model via the Leonardo.AI REST API.

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": "<YOUR_PROMPT>",
       "imageId" : "<IMAGE_ID_OF_START_FRAME>",
       "imageType": "UPLOADED",
       "resolution": "RESOLUTION_1080",
       "duration":8,
       "height":1080,
       "width":1920,
       "model": "VEO3_0"
     }'

Recipe

API Request Endpoint, Headers, Parameters

Endpoint

https://cloud.leonardo.ai/api/rest/v1/generations-image-to-video

Headers

--header "accept: application/json" \
--header "authorization: Bearer <YOUR_API_KEY>" \
--header "content-type: application/json"

Body Parameters

Parameter	Type	Definition
duration	number	Specifies the length of the generated video in seconds. Set to `4`, `6`, or `8`.
height	number	Sets the height of the output video in pixels.
imageId	string	Identifier of the image used as the starting frame for image-to-video generation. The image must exist as an uploaded or previously generated asset.
imageType	string	Specifies the source type of the start frame image. Set to `UPLOADED` or `GENERATED`.
isPublic	boolean	Controls whether the generated video is public or private. Set to `true` to make the generation public, or `false` to keep it private.
model	string	Selects the Veo model used for generation. Set to `VEO3` or `VEO3FAST`.
prompt	string	Text description that guides the content, style, and motion of the generated video.
resolution	string	Defines the output resolution preset. Set to `RESOLUTION_720` and `RESOLUTION_1080`.
width	number	Sets the width of the output video in pixels.

Default Height and Width

When specifying resolution, please note the following defaults.

Veo 3.0

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.