Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.
Create 5 or 10 second videos from text with synchronized audio and landscape or portrait output up to 1080p.

Models

  • alibaba/wan-2.5/text-to-video: Generate a video scene from a text prompt.

Request Parameters

Set model and optional callback_url at the request root. Place the following generation parameters inside input.

prompt

  • prompt (string, required): Describe the subject, scene, and motion. Use 1–1500 characters after trimming surrounding whitespace.

aspect_ratio

  • aspect_ratio (string, required): Frame dimensions in pixels (width*height): 832*480, 480*832, 1280*720, 720*1280, 1920*1080, 1080*1920.

duration

  • duration (integer, optional): Video duration: 5 or 10 seconds. Default: 5.

audio

  • audio (string, optional): Optional audio file URL to supply a recording for the video.

negative_prompt

  • negative_prompt (string, optional): Optional description of elements to exclude from the scene.

seed

  • seed (integer, optional): Optional integer random seed for reusing generation settings.

Retrieve the Video

Query the task with task_id. Continue polling while status is not_started or running. At finished, read the video URL from data.files[].file_url. At failed, read data.error_message for the error details.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Set model and optional callback_url at the request root. Place generation parameters inside input.

model
string
required
Example:

"alibaba/wan-2.5/text-to-video"

input
object
required
callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required