Skip to main content
POST
Video Fast 1.0 — reference to video

Authorizations

Authorization
string
header
required

Your API key from the developer console, sent as Authorization: Bearer sk_live_.... The x-api-key: sk_live_... header is accepted as an alternative.

Headers

Idempotency-Key
string

Optional key that makes the request safe to retry: any string up to 128 characters, unique per account, kept for 24 hours. The same key with the same body replays the first answer (Idempotent-Replayed: true) instead of creating a second task. See Idempotency.

Maximum string length: 128
Example:

"order-8812-attempt-1"

Body

application/json

Send at least one of reference_images, reference_videos, reference_audios.

prompt
string
required

What to generate. Name the assets by position, for example @Image1, @Video1, @Audio1.

Maximum string length: 2000
Example:

"@Image1 walks along the beach at sunset, the camera follows, @Audio1 plays softly"

duration
integer
required

Video length in seconds.

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

5

resolution
enum<string>
required

Output resolution.

Available options:
480p,
768p
Example:

"480p"

reference_images
string<uri>[]

Public HTTPS URLs of JPG, PNG or WebP images, 256–5,760 px, at most 30 MB each. @Image1 is the first item.

Maximum array length: 9
Example:
reference_videos
string<uri>[]

Public HTTPS URLs of video clips, 2–15 seconds and at most 50 MB each. @Video1 is the first item.

Maximum array length: 3
reference_audios
string<uri>[]

Public HTTPS URLs of audio files, at most 15 MB each. Send them together with an image or a video. @Audio1 is the first item.

Maximum array length: 3
webhook_url
string<uri>

Public HTTPS URL that receives this task's events. Overrides your account's default webhook endpoint.

Example:

"https://hooks.example.com/fiveapi"

metadata
object

Your own JSON, up to 4,096 bytes when serialized. Returned unchanged on the task and in every webhook.

Example:

Response

The task was accepted and queued.

A generation task. error is always present (null unless the task failed); other empty members are omitted.

id
string
required

Task id, task_ followed by 26 characters.

Example:

"task_01J9X7Z0K7Q8W3F2P1N6M5V4R3"

object
string
required
Allowed value: "task"
model
string
required

The model id the task was created with.

Example:

"wan/v3.0-spark/image-to-video"

task
enum<string>
required

The task type, the last segment of the model id.

Available options:
text-to-video,
image-to-video,
reference-to-video,
video-extend
status
enum<string>
required

queued → processing → one of the terminal states completed, failed, cancelled.

Available options:
queued,
processing,
completed,
failed,
cancelled
input
object
required

The accepted request body, without webhook_url and metadata.

error
object | null
required

Why the task failed. null unless status is failed.

credits
object
required
created_at
string<date-time>
required

When the task was created.

output
object

The result. Present on completed tasks until expires_at.

queue
object

Present while the task is queued.

webhook_url
string<uri>

The webhook URL sent with the task.

metadata
object

The metadata sent with the task.

started_at
string<date-time>

When generation started.

completed_at
string<date-time>

When the task reached completed, failed or cancelled.

expires_at
string<date-time>

When the output is removed, 7 days after completion.