Vidu Image-to-Video viduq4-preview

Use Vidu’s latest flagship model (preview) viduq4-preview to convert an image to video. This model supports audio-visual sync and automatic shot switching. After submitting a task, query its status via GET /vidu/ent/v2/tasks/{task_id}/creations. Uses model viduq4-preview.

POST /vidu/ent/v2/img2video

cURL

basic_image_to_video

curl --request POST \
  --url https://baze-api.powerbuyin.top/vidu/ent/v2/img2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq4-preview",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
  ],
  "prompt": "The astronaut waved and the camera moved up.",
  "duration": 5,
  "seed": 0,
  "resolution": "1080p"
}
'

200

{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq4-preview",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
  ],
  "prompt": "The astronaut waved and the camera moved up.",
  "duration": 5,
  "seed": 123456789,
  "resolution": "1080p",
  "payload": "",
  "credits": 10,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

Authorizations

Authorization · string · header · required

Pass Authorization: Bearer <token> in the request header.

Body

application/json

model · enum<string> · required

Model name. Available value: viduq4-preview

• viduq4-preview: Vidu's latest flagship model (preview), supports audio-visual sync and automatic shot switching

Available options: viduq4-preview

images · string[] · required

Start frame image. The model uses the image provided as the first frame to generate the video. Note 1: Supports image Base64 encoding or image URL (ensure accessibility); Note 2: Only 1 image is supported; Note 3: Supports png, jpeg, jpg, webp formats; Note 4: Image size must not exceed 50 MB; Note 5: Note that the http body must be less than 20M, and the encoding must include an appropriate content-type string, e.g.: data:image/png;base64,{base64_encode}

Required array length: 1 element

prompt · string

Text prompt. Text description for video generation. Note: Character length must not exceed 20000 characters

Maximum string length: 20000

audio · boolean · default: true

Whether to use audio-visual direct output

• false: no audio-visual direct output, outputs a silent video
• true: requires audio-visual sync, outputs a video with sound (including dialogue and sound effects) Note: viduq4-preview model default is true

is_rec · boolean · default: true

Whether to enable AI prompt rewriting

• true: enabled
• false: disabled (default value)

duration · integer · default: 5

Video duration parameter Default: 5 Enum: 3 - 16

Required range: 3 <= x <= 16

seed · integer

Random seed. When not provided or set to 0, a random number is used; when manually set, the configured seed is used.

resolution · enum<string>

Resolution parameter Default: 720p Enum: 540p / 720p / 1080p / 2K / 4K Note: viduq4-preview supports 2K and 4K video output

Available options: 540p, 720p, 1080p, 2K, 4K

payload · string

Passthrough parameter. No processing, only data transmission. Note: maximum 1048576 characters

Maximum string length: 1048576

watermark · boolean · default: false

Whether to add watermark

• true: add watermark
• false: no watermark Note: Currently watermark content is fixed, AI-generated, not added by default

wm_position · enum<integer> · default: 3

Watermark position, indicating where the watermark appears on the image. Options: 1: top-left 2: top-right 3: bottom-right 4: bottom-left Default: 3

Available options: 1, 2, 3, 4

Required range: 1 <= x <= 4

wm_url · string

Watermark content. This is an image URL; when not provided, the default watermark (AI-generated content) is used.

meta_data · string

Metadata identifier, a JSON format string passthrough field. You can customize the format or use the example format below: { "Label": "your_label", "ContentProducer": "your_content_producer", "ContentPropagator": "your_content_propagator", "ProduceID": "your_product_id", "PropagateID": "your_propagate_id", "ReservedCode1": "your_reserved_code1", "ReservedCode2": "your_reserved_code2" } When this parameter is empty, the Vidu-generated metadata identifier is used by default.

callback_url · string

Callback protocol. You need to actively set callback_url when creating a task. The request method is POST. When the video generation task changes status, Vidu will send a callback request containing the latest task status to this address. The callback request body structure is consistent with the query task API response body. The "status" returned by the callback includes the following states:

• processing: task is being processed
• success: task completed (if sending fails, callback retries three times)
• failed: task failed (if sending fails, callback retries three times) Vidu uses a callback signature algorithm for authentication, see: https://platform.vidu.cn/docs/callback-signature

Response

200

application/json

Submission successful, returns a video task object.

task_id · string

Task ID generated by Vidu.

state · enum<string>

Processing state Available values: created: task created successfully queueing: task in queue processing: task being processed success: task succeeded failed: task failed

Available options: created, queueing, processing, success, failed

model · string

Model name used for this call.

prompt · string

Prompt parameter used for this call.

images · string[]

Images parameter used for this call.

sounds · string

Sounds parameter used for this call.

duration · integer

Video duration parameter used for this call.

seed · integer

Random seed parameter used for this call.

resolution · string

Resolution parameter used for this call.

payload · string

Passthrough parameter passed in for this call.

credits · integer

Credits consumed for this call.

watermark · boolean

Whether a watermark was used for this task submission.

created_at · string<date-time>

Task creation time.