# Vidu Q4 API (Shengshu)

> Vidu Q4 (preview) animates a first frame or combines up to 15 reference images and 3 voice clips into 3–16 second videos with audio, from 540p up to 4K.

Page: https://cheapergen.com/models/shengshu/vidu-q4 · API reference: https://cheapergen.com/models/shengshu/vidu-q4/api

## Pricing
Official list price source: Vidu API list price for viduq4-preview at $0.005 per credit (540p 9 credits = $0.045 / s, 720p 19 = $0.095, 1080p 24 = $0.12, 2K 38 = $0.19, 4K 78 = $0.39; audio and references included). Prices verified 2026-10-16.

| Tier | Official | Cheaper Gen. | Save |
|---|---|---|---|
| 540p | $0.0450/s | $0.0396/s | 12% |
| 720p | $0.0950/s | $0.0836/s | 12% |
| 1080p | $0.1200/s | $0.1056/s | 12% |
| 2K | $0.1900/s | $0.1672/s | 12% |
| 4K | $0.3900/s | $0.3432/s | 12% |

## Specs
- Resolutions: 540p · 720p · 1080p · 2K · 4K
- Duration: 3–16 s
- Aspect ratios: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 (reference-to-video)
- Inputs: One first frame, or 1–15 reference images + up to 3 MP3 voice clips
- Status: Preview (Vidu)

## Endpoints

### Image to Video — `POST https://cheapergen.com/api/v1/run/shengshu/vidu-q4/image-to-video`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| image_url | string (URL) | yes | Image used as the opening frame. JPG/PNG/WebP, URL or upload. |
| resolution | string (enum) (540p, 720p, 1080p, 2K, 4k) | no | Output resolution. Higher resolutions cost more per second. |
| duration | integer (3–16) | no | Length of the generated clip in seconds (3–16s). You pay per second. |
| generate_audio | boolean | no | Generate synchronized dialogue and sound effects. Included in the price. |
| seed | integer | no | Use the same seed and settings to reproduce a result. Leave empty for random. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/shengshu/vidu-q4/image-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "She looks up from the book and smiles as snow begins to fall outside the window",
  "image_url": "https://cdn.cheapergen.ai/samples/portrait.jpg",
  "resolution": "720p",
  "duration": 5
}'
```

### Reference to Video — `POST https://cheapergen.com/api/v1/run/shengshu/vidu-q4/reference-to-video`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| reference_image_urls | string[] (URLs) | yes | Up to 15 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2… |
| reference_audio_urls | string[] (audio URLs) | no | Up to 3 MP3 clips for voice, music or sound (3–12 s each, ≤ 50 MB each). Refer to them as @Audio1, @Audio2… Needs at least one reference image or video. |
| aspect_ratio | string (enum) (16:9, 9:16, 1:1, 4:3, 3:4) | no | Output frame shape. |
| resolution | string (enum) (540p, 720p, 1080p, 2K, 4k) | no | Output resolution. Higher resolutions cost more per second. |
| duration | integer (3–16) | no | Length of the generated clip in seconds (3–16s). You pay per second. |
| generate_audio | boolean | no | Generate synchronized dialogue and sound effects. Included in the price. |
| seed | integer | no | Use the same seed and settings to reproduce a result. Leave empty for random. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/shengshu/vidu-q4/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "@Image1 greets @Image2 in the café from @Image3 and says the line from @Audio1",
  "reference_image_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.jpg",
    "https://cdn.cheapergen.ai/samples/reference-2.jpg",
    "https://cdn.cheapergen.ai/samples/reference-3.jpg"
  ],
  "reference_audio_urls": [
    "https://cdn.cheapergen.ai/samples/reference-1.mp3"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'
```

## Getting the result
Jobs are async. Poll `GET https://cheapergen.com/api/v1/generations/{id}` until status is succeeded/failed/canceled, or pass `webhook_url`. Failed generations are refunded automatically.

## FAQ
**How is Vidu Q4 priced?**
Vidu Q4 is billed per second of output video at the selected resolution. Audio is included at no extra cost, and failed generations are never charged.

**Is this the official Vidu Q4?**
Yes. Requests run on Shengshu's Vidu Q4 through official API channels, at a lower price than Vidu's own list price.

**Can it use my voice?**
Yes — in Reference to Video, attach up to 3 MP3 clips (3–12 s each) and refer to them as @Audio1… Reference images and audio are included in the price.

**Can I use the output commercially?**
Yes, subject to Vidu's terms of use and our Terms of Service.

Vidu Q4 is developed by Shengshu. Cheaper Gen. provides API access and does not own the model.