Spark Dance 1.0 Lite - T2V

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_t2v

content `array` required

Input information for generating videos, supports text format

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. Too many characters can cause information dispersion, and the model may ignore details and only focus on key points, resulting in missing elements in the video

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. This parameter can be used to generate multiple consecutive videos by using the end frame of one video as the first frame of the next video task

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

ratio `string`

Aspect ratio of the generated video

Default: 16:9

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

duration `integer`

Video duration in seconds

Either duration or frames can be specified (one of two), frames takes priority over duration. If you want to generate an integer-second video, it is recommended to specify duration

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

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 content

type string

Resource type

url string

Content URL

size integer

Video size

jobId string

Remote job ID

duration integer

Video duration (seconds)

format string

Video format

resolution string

Video resolution

ratio string

Aspect ratio

fps integer

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 / completion tokens

total_tokens integer

Total number of tokens

generated_videos integer

Number of generated videos

metadata `object`

Metadata information

Error Codes

Error Code	Description
003004001	Missing content
003004002	Invalid content format
003004003	Invalid resolution
003004004	Invalid aspect ratio
003004005	Invalid duration
003004006	Invalid frame rate
003004007	Invalid seed
003004008	Invalid boolean parameter
003004009	Missing content type
003004010	Missing text field
003004095	Internal generation error
003004096	Result parsing error
003004097	HTTP error response
003004098	Status check error
003004099	Task creation error

curl --location 'https://cloud.vtrix.ai/model/v1/generation' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "model": "spark_dance_v1_0_lite_t2v", "input": [ { "params": { "content": [ { "type": "text", "text": "A beautiful sunset over the ocean with gentle waves" } ], "resolution": "720p", "ratio": "16:9", "duration": 5 } } ] }'

{ "id": "d5u5obte8783ap44qtj0", "created_at": 1769757744021, "status": "completed", "model": "spark_dance_v1_0_lite_t2v", "output": [ { "content": [ { "type": "video", "url": "https://example.com/generated-video.mp4", "duration": 5, "jobId": "remote_job_id_12345" } ] } ], "usage": { "cost": "0.000500", "discount": 0, "input_tokens": null, "output_tokens": null, "quantity": 1, "time_per_unit": 0, "total_tokens": null, "unit_price": "0.000500", "user_discount": 1 }, "metadata": { "completed_at": 120.5, "in_queue_at": 0, "upload_at": 1.2, "usage": { "input_tokens": 20, "input_tokens_details": { "text_tokens": 20 }, "output_tokens": 0, "total_tokens": 20 } } }

Authentication

authorization string required

Parameters

model string required

content array required

Text Content Object

type string required

text string required

callback_url string

return_last_frame boolean

service_tier string

execution_expires_after integer

resolution string

ratio string

duration integer

frames integer

seed integer

camera_fixed boolean

watermark boolean

Polling

Response Format

error object

code string

error_message string

output array

content array

type string

url string

size integer

jobId string

duration integer

format string

resolution string

ratio string

fps integer

usage object

cost string

discount number

input_tokens integer

output_tokens integer

total_tokens integer

generated_videos integer

metadata object

Error Codes

authorization `string` required

model `string` required

content `array` required

type `string` required

text `string` required

callback_url `string`

return_last_frame `boolean`

service_tier `string`

execution_expires_after `integer`

resolution `string`

ratio `string`

duration `integer`

frames `integer`

seed `integer`

camera_fixed `boolean`

watermark `boolean`

error `object`

code `string`

error_message `string`

output `array`

content `array`

type `string`

url `string`

size `integer`

jobId `string`

duration `integer`

format `string`

resolution `string`

ratio `string`

fps `integer`

usage `object`

cost `string`

discount `number`

input_tokens `integer`

output_tokens `integer`

total_tokens `integer`

generated_videos `integer`

metadata `object`