Skip to main content
POST
Submit First-and-Last-Frame-to-Video Task

Authorizations

Authorization
string
header
required

Authenticate using Bearer token. Get your API Key from the WeryAI Console.

Example: Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Body

application/json
model
string
required

Model Key. Supported models for first-last-image-to-video:

Example:

"VEO_3_1"

prompt
string
required

Positive text prompt

Required string length: 1 - 2000
Example:

"The camera slowly moves from the first frame to the last frame with smooth motion."

first_pic_url
string<uri>
required

Start frame image URL (supports jpg, jpeg, png, webp)

Example:

"https://example.com/start.jpg"

end_pic_url
string<uri>
required

End frame image URL (supports jpg, jpeg, png, webp)

Example:

"https://example.com/end.jpg"

aspect_ratio
string
required

Video aspect ratio. Refer to the model table above for supported values per model. Models marked with - do not support aspect ratio selection. For HAILUO_03, the output aspect ratio follows the input image and this parameter is ignored.

Example:

"16:9"

duration
integer
required

Video duration in seconds. Refer to the model table above for supported values per model.

Example:

5

negative_prompt
string

Negative text prompt

Maximum string length: 1000
video_number
enum<integer>
default:1

Number of videos to generate (1~4).

Available options:
1,
2,
3,
4
resolution
string

Video resolution. Supported values per model. For Werydance models, only Werydance 2.0 supports 1080p.

generate_audio
string

Whether to generate audio. Enter true or false manually. Only supported by the following models:

HAILUO_03 always generates synchronized audio natively; this parameter is ignored.

Example:

"false"

webhook_url
string<uri>

Callback URL

caller_id
integer<int64>

Caller ID

Response

Task submitted successfully

status
integer

Business status code (0 indicates success)

Example:

0

desc
string

Status description

Example:

"success"

message
string

Multi-language message

Example:

"success"

data
object