---
title: "create video by text or image or reference image"
method: POST
path: "/generation/vidu/viduq3-pro"
tags: ["generation", "video generation"]
---

# create video by text or image or reference image

`POST /generation/vidu/viduq3-pro`

## Request

- Base URL: `https://pollo.ai/api/platform`
- URL: `https://pollo.ai/api/platform/generation/vidu/viduq3-pro`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/pollo/apis/pollo-ai-video-collection/docs/generation/vidu/viduq3-pro/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `input` union, required
    - object
      - `prompt` string: The prompt of the generation
      - `image` string, uri, required: Only image URLs are accepted (HTTPS preferred); base64 is not allowed. Supported formats include JPG, PNG, and JPEG. Image aspect ratio must be less than 1:4 or 4:1.
      - `imageTail` string, uri: URL of the tail image for video generation. Only image URLs are accepted (HTTPS preferred); base64 is not allowed. Supported formats include JPG, PNG, and JPEG. Image aspect ratio must be less than 1:4 or 4:1.
      - `length` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16: The length of the generation
      - `resolution` '360p' | '540p' | '720p' | '1080p' | '2K': The resolution of the generation
      - `seed` number: The seed of the generation
      - `generateAudio` boolean: Generate natural-sounding, fitting audio for the output video.
    - object
      - `prompt` string, required: The prompt of the generation
      - `firstFrameImage` string
      - `lastFrameImage` string
      - `length` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16: The length of the generation
      - `seed` number: The seed of the generation
      - `aspectRatio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4'
      - `resolution` '360p' | '540p' | '720p' | '1080p' | '2K': The resolution of the generation
      - `generateAudio` boolean: Generate natural-sounding, fitting audio for the output video.
  - `webhookUrl` string
  - `clientSource` string

## Response `200`

Successful response

- object
  - `taskId` string, required
  - `status` 'waiting' | 'succeed' | 'failed' | 'processing', required

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/pollo/apis/pollo-ai-video-collection.md) - [All operations](https://skmtc.dev/pollo/apis/pollo-ai-video-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/pollo/apis/pollo-ai-video-collection/revisions/b3c228cf4e87?raw)