Skip to main content
POST
Create 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-i2v
Example:

"happyhorse-1.0-i2v"

prompt
string
required

Text description of the desired motion.

Example:

"Camera slowly zooms in, the scene comes to life"

image
string
required

First-frame image URL. Use images: [...] array form if you prefer — only the first item is used.

Example:

"https://example.com/first-frame.png"

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 add the bottom-right "Happy Horse" watermark.

Example:

false

seed
integer

Random seed for reproducibility.

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

Optional alternative location for the same parameters (DashScope-native 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-i2v"

status
string
Example:

"queued"

progress
integer
Example:

0

created_at
integer
Example:

1777343862