This guide shows how to generate images using Seedance 1.0 Pro and Seedance 1.0 Pro Fast models via the Leonardo.AI REST API.

Sample Request

curl --request POST \
     --url https://cloud.leonardo.ai/api/rest/v2/generations \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <YOUR_API_KEY>' \
     --header 'content-type: application/json' \
     --data '
{
    "model": "seedance-1.0-pro",
    "public": false,
    "parameters": {
      "prompt": "The koala plays with the cat",
      "guidances": {
        "start_frame": [
          {
            "image": {
              "id": "<YOUR_START_IMAGE_ID>",
              "type": "UPLOADED"
            }
          }
        ],
        "end_frame": [
          {
            "image": {
              "id": "<YOUR_END_IMAGE_ID>",
              "type": "UPLOADED"
            }
          }
        ]
      },
      "duration": 4,
      "mode": "RESOLUTION_1080",
      "prompt_enhance": "OFF",
      "width": 1920,
      "height": 1088
    }
}
'

Recipe

API Request Endpoint, Headers, Parameters

Endpoint

https://cloud.leonardo.ai/api/rest/v2/generations

Headers

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

Body Parameters

Parameter	Type	Definition
duration	`number`	Length of the generated video. Set to `4`, `6`, `8`, `10`.
guidances.endframe	`array`	Maximum 1 item. Each item includes image.id and image.type (`GENERATED` or `UPLOADED`). Only available when `start_frame` is provided.
guidances.start_frame	`array`	Maximum 1 item. Each item includes image.id and image.type (`GENERATED` or `UPLOADED`).
height	`number`	Sets the height of the output video in pixels.
model	`string`	Specifies the model used for generation. Set to `seedance-1.0-pro` or `seedance-1.0-pro-fast`
prompt	`string`	Text description of the video content to generate. Maximum of 1500 characters.
prompt_enhance	`string`	Enables or disables prompt enhancement. Valid values are `ON` and `OFF`.
public	`boolean`	Controls whether the generated video is public (true) or private (false).
width	`number`	Sets the width of the output video in pixels.

Dimensions

The API accepts width and height parameters in the following aspect ratio combinations:

Resolution	Aspect Ratio	Pixel Values (Width x Height)
480p	16:9 (Landscape)	864x480
	4:3	736x544
	1:1 (Square)	640x640
	3:4	544x736
	9:16 (Portrait)	480x864
	21:9	960x416
720p	16:9 (Landscape)	1248x704
	4:3	1120x832
	1:1 (Square)	960x960
	3:4	832x1120
	9:16 (Portrait)	704x1248
	21:9	1504x640
1080p (Reference Image feature is not supported)	16:9 (Landscape)	1920x1088
	4:3	1664x1248
	1:1 (Square)	1440x1440
	3:4	1248x1664
	9:16 (Portrait)	1088x1920
	21:9	2176x928