ShengshuvideoNewOperational

Vidu Q4 Reference to Video API

Name: Vidu Q4 API
Brand: Shengshu
Availability: InStock

Reference to Video with Vidu Q4 by Shengshu. Vidu's newest model — up to 4K, 15 reference images and voice references.

shengshu/vidu-q4/reference-to-video

FromUp to −6%

$0.113/s$0.12

per second of video · 1080p

Open in Studio API

Try Vidu Q4 Reference to Video

Prompt*

Type @ to point at a reference image or audio clip0/5000

Reference images*

Up to 15 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2…

Reference audio

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

Output frame shape.

Resolution

Output resolution. Higher resolutions cost more per second.

Duration

Length of the generated clip in seconds (3–16s). You pay per second.

Generate audio

Generate synchronized dialogue and sound effects. Included in the price.

Estimated cost…

Create a free account with Google or email — pay only for what you generate.

Your video will appear here

Write a prompt, pick your settings and hit Run. You only pay for successful generations.

Also available: Vidu Q4 Image to Video

Vidu Q4 Reference to Video API

POST/api/v1/run/shengshu/vidu-q4/reference-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`reference_image_urls`required	string[] (URLs)	Up to 15 images for characters, products, style or scene. Refer to them in the prompt as @Image1, @Image2… Max items: 15	No
`reference_audio_urls`	string[] (audio URLs)	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. Max items: 3	No
`aspect_ratio`	string (enum)	Output frame shape. Values: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 1080p · 2K · 4k Default: 1080p	Yes
`duration`	integer	Length of the generated clip in seconds (3–16s). You pay per second. Range: 3–16s Default: 5	Yes
`generate_audio`	boolean	Generate synchronized dialogue and sound effects. Included in the price. Default: true	No
`seed`	integer	Use the same seed and settings to reproduce a result. Leave empty for random.	No
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

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": "1080p",
  "duration": 5
}'

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/shengshu/vidu-q4/reference-to-video", headers=headers, json={
    "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": "1080p",
    "duration": 5
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/shengshu/vidu-q4/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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": "1080p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "shengshu/vidu-q4",
  "endpoint": "shengshu/vidu-q4/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "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": "1080p",
    "duration": 5
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "shengshu/vidu-q4",
  "endpoint": "shengshu/vidu-q4/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "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": "1080p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.ai/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Vidu Q4 pricing

Pay per second of video. No subscription. Failed generations are refunded automatically.

Tier	Official price	Cheaper Gen.	You save
1080p audio included	~~$0.12~~/s	$0.113/s	−6%
2K audio included	~~$0.19~~/s	$0.179/s	−6%
4K audio included	~~$0.39~~/s	$0.366/s	−6%

Official price: Vidu API list price for viduq4-preview at $0.005 per credit (1080p 24 credits = $0.12 / s, 2K 38 = $0.19, 4K 78 = $0.39; audio and references included). Prices verified 2026-10-16.
540p and 720p are not offered yet: our channel's rate there is above Vidu's own price.

About Vidu Q4 All Vidu Q4 endpoints