Skip to main content
POST
Create a reference-image-to-video task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

model ID。

Available options:
happyhorse-1.0-r2v
Example:

"happyhorse-1.0-r2v"

prompt
string
required

Video description text.

Example:

"A woman in a red qipao gently raises her hand and opens a folding fan"

images
string[]
required

1-3 reference image URLs.

Required array length: 1 - 3 elements
Example:
resolution
enum<string>
default:1080P

Video resolution.

Available options:
720P,
1080P
Example:

"720P"

ratio
enum<string>
default:16:9

Aspect ratio.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4
Example:

"16:9"

duration
integer
default:5

Video duration in seconds.

Required range: 3 <= x <= 15
Example:

5

watermark
boolean
default:true

Whether to keep the "Happy Horse" watermark in the bottom-right corner.

Example:

false

seed
integer

Random seed.

Required range: 0 <= x <= 2147483647
parameters
object

Optional: an alternative placement for the same parameters (native DashScope style).

Response

Task created successfully

id
string
Example:

"asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya"

task_id
string
Example:

"asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya"

object
string
Example:

"video"

model
string
Example:

"happyhorse-1.0-r2v"

status
string
Example:

"queued"

progress
integer
Example:

0

created_at
integer
Example:

1777343862