Skip to main content
POST
Submit Image-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 image-to-video:

Example:

"WERYAI_VIDEO_1_0"

prompt
string
required

Positive text prompt

Required string length: 1 - 2000
Example:

"Make the person wave their hand"

image
string<uri>
required

Reference image (supports jpg, jpeg, png, webp)

Example:

"https://example.com/reference.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.

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. Only supported by the following models:

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:

Example:

"720p"

generate_audio
string

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

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