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

{
  "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 2.6 Reference to Video

Use reference videos to guide new scenes with Wan 2.6, with support for multiple shots and video output up to 1080p.

​

Available Models

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

​

Duration Options

• 5, 10 seconds - Set duration as an integer. Optional. Default: 5 seconds.

​

Key Features

• Generate video guided by reference material and a prompt.
• Use 1-10 video references to guide the generated scene.
• Choose from 720p, 1080p output resolutions.

​

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, 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. Length: 1-5,000 characters.
• The value must not be blank when supplied.

​

Reference Videos

• video_urls: Required. Provide reference video URLs. Supply 1-10 items. Each item must be an HTTP(S) URL.
• PoYo accepts MP4, MOV, and MKV files up to 10 MiB each.

​

Resolution

• resolution: Optional. Accepted values: 720p, 1080p. Default: 720p.

​

Multi-Shot Generation

• multi_shots: Optional. Enable multi-shot generation. Use true or false.

​

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.