curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "alibaba/wan-3.0-prime/reference-to-video",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": true,
    "enable_safety_checker": true,
    "reference_image_urls": [
      "https://example.com/image.png"
    ]
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

​

Wan 3.0 Video Prime Reference to Video

Guide Wan 3.0 Prime video scenes with image, video, and audio references, combining multiple sources into a new visual sequence.

​

Available Models

• alibaba/wan-3.0-prime/reference-to-video - Generate a new video guided by reference material and a prompt.

​

Duration Options

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

​

Key Features

• Use image, video, audio, document, or webpage references to guide a new scene.
• 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: Required. Describe the scene and desired motion.
• The prompt must not be blank when supplied. Maximum length: 20,000 characters.

​

Reference Inputs

• At least one reference type is required in addition to prompt. Audio can be the only reference type.
• Do not combine reference_file_urls with reference_link_urls.
• reference_image_urls: Optional; provide 1-10 images.
• reference_video_urls: Optional; provide 1-5 videos.
• reference_audio_urls: Optional; provide 1-5 audio files.
• reference_file_urls: Optional; provide exactly 1 document.
• reference_link_urls: Optional; provide exactly 1 webpage.

​

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.