Skip to main content
POST
Create an 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

Description of the motion effect.

Example:

"The camera slowly zooms in and the scene comes to life"

image
string
required

First-frame image URL. You can also use the images: [...] array form (only the first image 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 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-i2v"

status
string
Example:

"queued"

progress
integer
Example:

0

created_at
integer
Example:

1777343862