Skip to main content
POST
Submit Almighty Reference-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 almighty-reference-to-video:

Example:

"WERYDANCE_2_0_FAST"

duration
integer
required

Generated video duration in seconds. Range depends on the selected model; WERYDANCE_2_5 supports 4-30. HAILUO_03 supports 5-15 for the generated video; reference video duration is added on top for billing.

Required range: 4 <= x <= 30
Example:

4

prompt
string

Prompt text (max 2000 characters). HAILUO_03 requires a non-empty prompt; reference assets are cited in the prompt as Image 1, Video 1, Audio 1 in upload order.

Maximum string length: 2000
images
string<uri>[]

Reference image URLs.

WERYDANCE_2_5 requirements:

  • 0~30 images.
  • Each image must be within 4K and no larger than 30 MB.
  • Supported formats: jpeg, png, webp, bmp, tiff, gif, heic, heif.

Other Werydance models: 0~9 images. Optional, but at least one of images or videos must be provided.

HAILUO_03 requirements:

  • 0~9 images.
  • Supported formats: jpg, jpeg, png, webp.
  • The first 5 reference images are free; each additional image is billed separately.
  • Reference images, videos and audios must add up to at most 12 files in total.
Maximum array length: 30
videos
string<uri>[]

Reference video URLs.

WERYDANCE_2_5 requirements:

  • 0~10 reference videos.
  • Supports 480p~4K; each video must be no larger than 200 MB.
  • Supported formats: mp4, mov.
  • Each video duration must be [2,30] seconds; total video duration must be <= 30 seconds.

Other Werydance models: max 3 videos; each 2~15 seconds; total <= 15 seconds. Optional, but at least one of images or videos must be provided.

HAILUO_03 requirements:

  • Max 3 reference videos.
  • Each video duration must be [2,15] seconds; total video duration must be <= 15 seconds.
  • Reference video duration is billed at the same per-second rate as the generated output resolution.
  • Reference images, videos and audios must add up to at most 12 files in total.
Maximum array length: 10
audios
string<uri>[]

Reference audio URLs.

WERYDANCE_2_5 requirements:

  • 0~10 reference audios.
  • Each audio must be no larger than 15 MB.
  • Supported formats: mp3, wav.
  • Each audio duration must be [2,30] seconds; total audio duration must be <= 30 seconds.

Other Werydance models: max 3 audios; each 2~15 seconds; total <= 15 seconds. Cannot be used alone without images or videos.

HAILUO_03 requirements:

  • Max 3 reference audios.
  • Each audio duration must be [2,15] seconds; total audio duration must be <= 15 seconds.
  • Free of charge. Cannot be used alone without images or videos.
  • Reference images, videos and audios must add up to at most 12 files in total.
Maximum array length: 10
aspect_ratio
string

Video aspect ratio. Refer to the model table above for supported values per model.

Example:

"16:9"

resolution
string

Video resolution. Supported values: 480p, 720p. For Werydance models, only Werydance 2.0 supports 1080p. HAILUO_03 supports 768p, 2k, 4k.

Example:

"720p"

generate_audio
string

Whether to generate audio. Enter true or false manually.

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

Example:

"false"

video_number
enum<integer>
default:1

Number of videos to generate (1~4).

Available options:
1,
2,
3,
4
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