> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifically.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vidu Q4

> Vidu Q4 image-to-video and reference-to-video with up to 15 images and 3 audio references, 540p to 4K. See parameters and API examples.

Generate videos with Vidu Q4, ShengShu Technology's video model released October 7, 2026. One model covers two modes, picked by which images you send: image-to-video animates a single image, and reference-to-video builds a new scene from up to 15 reference images plus up to 3 audio references. Every video comes with native audio. Images and audio are downloaded from their public URLs automatically.

Try it in the browser: [Vidu Q4 API playground](https://unifically.com/models/vidu-q4).

## Model

```
vidu/q4
```

## Modes

| Mode | How to select it | Length | Shape |
| - | - | - | - |
| Image-to-video | Send `image_url` | 3-16 seconds | Follows the input image |
| Reference-to-video | Send `reference_image_urls` (and optionally `reference_audio_urls`) | 1-16 seconds | `aspect_ratio` |

Send either `image_url` or `reference_image_urls`, not both.

## Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `prompt` | string | Yes | - | Video prompt, 1-5000 characters. In reference-to-video, mention inputs as `[Image1]`-`[Image15]` and `[Audio1]`-`[Audio3]` |
| `image_url` | string | Conditional | `null` | Image-to-video: public URL of the image to animate. Required unless `reference_image_urls` is set |
| `reference_image_urls` | string\[] | Conditional | `null` | Reference-to-video: 1-15 public image URLs. `[Image1]` is the first URL |
| `reference_audio_urls` | string\[] | No | `null` | Reference-to-video only: up to 3 public audio URLs (wav, mp3, aac, ogg, flac, aiff), 1-16 seconds and up to 20 MB each. `[Audio1]` is the first URL |
| `resolution` | string | No | `"1080p"` | `"540p"`, `"720p"`, `"1080p"`, `"2k"`, or `"4k"` |
| `duration` | integer | No | `5` | Image-to-video: 3-16 seconds. Reference-to-video: 1-16 seconds |
| `aspect_ratio` | string | No | `"16:9"` | Reference-to-video only: `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, or `"3:4"` |
| `video_format` | string | No | `"h264_pro"` | `"h264"`, `"h264_pro"`, `"h265"`, or `"h265_pro"`. Same price; the pro variants encode at higher quality |
| `enhance_prompt` | boolean | No | `true` | Let Vidu rewrite the prompt before generating |
| `nsfw_check` | boolean | No | `true` | Check uploaded media inputs for NSFW content |

Image inputs must be at least 128x128 pixels with an aspect ratio between 1:4 and 4:1, up to 50 MB.

## Example - Image-to-Video

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "vidu/q4",
    "input": {
      "prompt": "The cat slowly turns its head toward the camera and meows softly",
      "image_url": "https://example.com/cat.jpg",
      "resolution": "1080p",
      "duration": 8
    }
  }'
```

## Example - Reference-to-Video

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "vidu/q4",
    "input": {
      "prompt": "[Image1] picks up the apple from [Image2] and says the line from [Audio1]",
      "reference_image_urls": [
        "https://example.com/person.jpg",
        "https://example.com/apple.jpg"
      ],
      "reference_audio_urls": ["https://example.com/voice.mp3"],
      "resolution": "4k",
      "duration": 8,
      "aspect_ratio": "9:16"
    }
  }'
```

## Response

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}
```

Poll `GET /v1/tasks/<task_id>` or set a `callback_url` on the request to receive the finished video.

<Note>
  **Volume discounts** are available for almost all models. Reach out at [contact@unifically.com](mailto:contact@unifically.com) to discuss custom pricing.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.