Spark Dance 1.0 Lite - I2V

API Tips

Reference Image to Video: Generates target video based on your input reference images (1-4 images) + text prompt (optional) + parameters (optional)

First and Last Frame to Video: Generates target video based on your input first frame image + last frame image + text prompt (optional) + parameters (optional)

First Frame to Video: Generates target video based on your input first frame image + text prompt (optional) + parameters (optional)

---

Authentication

authorization string required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key.

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model string required

Model ID to use for the request

Value: spark_dance_v1_0_lite_i2v

---

content array required

Input information for generating videos, supports text, image formats. Supports the following combinations: Text + Image

Text Content Object

type string required

Content type

Value: text

text string required

Text content input to the model, describing the expected video, including:

Text prompt (required): Supports Chinese and English. Recommended not exceeding 500 characters

Image Content Object

type string required

Content type

Value: image_url

image_url object required

Image URL object

url string required

Image information, can be image URL or Base64 encoded image

Image URL: Ensure the image URL is accessible

Base64 encoding: Follow this format data:image/<image_format>;base64,<base64_encoded>, note that <image_format> must be lowercase, e.g. data:image/png;base64,{base64_image}

Image requirements:
Image formats: jpeg, png, webp, bmp, tiff, gif
Aspect ratio (width/height): (0.4, 2.5)
Width and height (px): (300, 6000)
Size: less than 30 MB

role string conditional required

Image position or purpose

Reference Image to Video:
role value: Need to pass 1-4 image_url objects, and role field is required
Each reference image corresponds to role: reference_image

First Frame to Video:
role value: Need to pass 1 image_url object, and role field can be empty, or role is: first_frame

First and Last Frame to Video:
role value: Need to pass 2 image_url objects, and role field is required
First frame image corresponds to role: first_frame
Last frame image corresponds to role: last_frame

---

callback_url string

Callback notification address for task results

---

return_last_frame boolean

Whether to return the last frame image of the generated video

true: Returns the last frame image of the generated video. After setting to true, you can get the video’s last frame image through the query video generation task API. The last frame image format is png, with the same width and height pixels as the generated video, without watermark

false: Does not return the last frame image

Default: false

---

service_tier string

Service tier type for processing this request

default: Online inference mode

flex: Offline inference mode

Default: default

Options: default, flex

---

execution_expires_after integer

Task timeout threshold. Specifies the expiration time (in seconds) after task submission, calculated from the created_at timestamp

Default: 172800 (48 hours)

Range: [3600, 259200]

---

resolution string

Video resolution

Default: 720p

Options: 480p, 720p, 1080p

Note: Reference image scenario does not support 1080p

---

ratio string

Aspect ratio of the generated video

Default: adaptive (Reference image scenario default: 16:9)

Options: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

Note: Reference image scenario does not support adaptive

---

duration integer

Video duration in seconds

Default: 5

Range: 2 - 12

---

frames integer

Number of frames for the generated video

duration and frames are mutually exclusive, frames has higher priority. If you want to generate videos with fractional seconds, it is recommended to specify frames. By specifying the number of frames, you can flexibly control the length of the generated video, generating videos with fractional seconds

Due to the value restrictions of frames, only limited fractional seconds are supported. You need to calculate the closest frame number based on the formula

Calculation formula: Frame count = Duration × Frame rate (24)

Value range: Supports all integer values in the range [29, 289] that satisfy the format 25 + 4n, where n is a positive integer

Example: If you need to generate a 2.4 second video, frame count = 2.4×24=57.6. Since frames does not support 57.6, you can only choose the closest value. According to 25+4n, the closest frame number is 57, and the actual generated video is 57/24=2.375 seconds

---

seed integer

Seed integer for controlling randomness of generated content

Default: -1

Range: [-1, 2^32-1]

---

camera_fixed boolean

Whether to fix the camera

Default: false

Options: true, false

Note: Reference image scenario does not support this parameter

---

watermark boolean

Whether the generated video contains watermark

Default: false

Options: true, false

---

---

Polling

Since video generation takes time, you need to poll the task status after creation

The initial response returns the task ID and initial status. The actual generation results must be obtained through polling the task status endpoint

Response Format

error object

Error information. Only present when status is failed

code string

Error code

error_message string

Detailed error message

---

output array

Generation results. Only present when status is completed

content array

List of generated video content

type string

Resource type

Value: video

url string

Video URL (processed and uploaded to CDN)

size integer

Video size (bytes)

jobId string

Remote job ID

duration integer

Video duration (seconds)

format string

Video format, default mp4

resolution string

Video resolution

ratio string

Video aspect ratio

fps integer

Video frame rate

---

usage object

Usage statistics. Only present when status is completed

cost string

Total cost in USD

discount number

Discount amount

input_tokens integer

Number of input tokens

output_tokens integer

Number of output tokens

total_tokens integer

Total number of tokens

---

metadata object

Metadata information

---

Error Codes

Error Code	Description
003006095	Internal generation error
003006096	Result parsing error
003006097	HTTP error response
003006098	Status check error
003006099	Task creation error