Skip to main content
POST
  1. Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
  2. Use Query Task Status to retrieve the result. If you provide a callback_url, Vidgo sends the result to your webhook when the task finishes or fails.

Wan 3.0 Image to Video

Animate still images with Wan 3.0, combining text direction with optional audio in clips up to thirty seconds long.

Available Models

  • alibaba/wan-3.0/image-to-video - Generate video from image input.

Duration Options

  • 2-30 seconds - Set duration as an integer. Default: 5 seconds.

Key Features

  • Generate video from one or two input images.
  • Choose from 480p, 720p, 1080p output resolutions.
  • Control audio generation with audio; it defaults to true.

Advanced Parameters

Set model and optional callback_url at the request root. Place the parameters below inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.

Prompt

  • prompt: Optional. Describe the scene and desired motion.
  • The prompt must not be blank when supplied. Maximum length: 20,000 characters.

Image URLs

  • image_urls: Required. Provide 1-2 image URLs.
  • Images must be publicly accessible and directly downloadable.

Resolution

  • resolution: 480p, 720p, 1080p. Default: 720p.

Aspect Ratio

  • aspect_ratio: adaptive, 16:9, 4:3, 1:1, 3:4, 9:16. Default: adaptive.

Audio

  • audio: Set to true to enable generated audio, or false to disable it. Default: true.

Seed

  • seed is optional. Supply an integer from 0 to 2147483647.

Safety Checker

  • enable_safety_checker is optional. Set it to true or false to control safety checking. Default: true.

Pricing

Pricing depends on the selected model and applicable output settings. Check the Vidgo dashboard for the current rate. Credits are deducted on submission and refunded if the task fails.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.

model
enum<string>
required

Vidgo public model ID. Must be alibaba/wan-3.0/image-to-video.

Available options:
alibaba/wan-3.0/image-to-video
Example:

"alibaba/wan-3.0/image-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