Vidu image-to-video — Create a task

POST

/services/aigc/video-generation/video-synthesis

Image-to-video

# Singapore (ap-southeast-1). This model is available only in this region.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
curl --location 'https://ap-southeast-1.maas.qwencloudapi.com/api/v1/services/aigc/video-generation/video-synthesis' \
  --header 'X-DashScope-Async: enable' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "vidu/viduq2-pro-fast_img2video",
  "input": {
    "media": [
      {
        "type": "image",
        "url": "https://example.com/first-frame.png"
      }
    ],
    "prompt": "The camera slowly pans up from below a sea turtle swimming leisurely."
  },
  "parameters": {
    "duration": 5,
    "resolution": "720P",
    "watermark": false,
    "seed": 12345
  }
}'

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

vidu/viduq2-pro-fast_img2video generates a video from a single first-frame image and a text prompt. The model animates the scene while preserving the subject and composition of the input image. Supported regions: Singapore only. Use an API key created in that region and the https://ap-southeast-1.maas.qwencloudapi.com endpoint. See Regions and endpoints.

Prompt: up to 5,000 characters. Text beyond the limit is truncated.
Image: exactly one image. JPG, JPEG, PNG, or WEBP; aspect ratio 1:4 to 4:1; up to 50 MB; publicly accessible HTTP or HTTPS URL.
Output: MP4 video, 720P or 1080P, 1 to 10 seconds.

Processing is asynchronous: this operation returns a task_id, and you poll Query the result until the task finishes. Generation typically takes 1 to 5 minutes.

Authorizations

string

header

required

QwenCloud API key. See Get an API key.

Header Parameters

enum<string>

required

The content type of the request. Must be application/json.

Available options:application/json

enum<string>

required

Enables asynchronous processing. HTTP requests support only asynchronous calls, so this must be enable.

Available options:enable

Body

application/json

enum<string>

required

The model name.

Available options:vidu/viduq2-pro-fast_img2video

Example:vidu/viduq2-pro-fast_img2video

object

required

The input object, including the text prompt and media assets.

Show child attributes

object[]

required

The media assets. Provide exactly one image.

Show child attributes

enum<string>

The media type. Must be image.

Available options:image

string

The publicly accessible URL of the image. Supports HTTP and HTTPS. Formats: JPG, JPEG, PNG, WEBP. Aspect ratio: 1:4 to 4:1. File size: up to 50 MB.

Example:https://example.com/first-frame.png

string

The text prompt that describes the elements and visual characteristics of the video. Up to 5,000 characters. Text beyond the limit is truncated.

Example:The camera slowly pans up from below a sea turtle swimming leisurely.

object

Video generation parameters.

Show child attributes

enum<string>

default"720P"

The resolution tier of the output video. Billing depends on this value. Valid values: 720P and 1080P. Default: 720P.

Available options:720P,1080P

integer

default5

The video duration in seconds. Range: 1 to 10. Default: 5. Billing is per second.

Required range:1 <= x <= 10

boolean

defaultfalse

Whether to add a watermark in the lower-right corner. The watermark text is "Generated by AI". Default: false.

integer

The random seed. Range: 0 to 2147483647. A fixed seed improves reproducibility.

Required range:0 <= x <= 2147483647

Response

200-application/json

string

Unique request identifier for tracing and troubleshooting.

object

Show child attributes

string

The task ID. It is valid for queries for 24 hours.

enum<string>

The task status. New tasks start as PENDING.

Available options:PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

string

Error code. Returned only when the request fails.

string

Detailed error message. Returned only when the request fails.