Vidu Q4 Preview Reference to Video

vidu/q4-preview/reference-to-video

Generate a 3–16 second video from a prompt with optional references: up to 15 images and 3 audio clips. Supports aspect ratio selection, audio generation and 540p–4k resolution.

Examples

Vidu Q4 Preview Reference to Video Examples 1

Parameters

NameTypeDefaultConstraintsDescription
prompt *Prompttextarea—≤ 5000 charsThe positive prompt for the generation.
imagesImagesimage_upload—image/* · 0–15 itemsReference image URL array (up to 15 images).
audiosAudiosaudio_upload_group—audio/* · 0–3 itemsOptional reference audio files for generation. Supports up to 3 audio references.
aspect_ratioAspect Ratioselect16:916:9 | 9:16 | 1:1 | 3:4 | 4:3The aspect ratio of the generated media.
resolutionResolutionselect720p540p | 720p | 1080p | 2k | 4kThe resolution of the generated media.
durationDurationslider53 ~ 16 · step 1The duration of the generated media in seconds.
generate_audioGenerate Audiobooleantrue—Whether to generate audio.
seedSeednumber—step 1The random seed to use for the generation. 0 or an omitted value uses a random seed.

Output fields

FieldTypeDescription
videosarray<string>

API

Call this model through one unified REST API. Get a key on the API Keys page.

cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/vidu/q4-preview/reference-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "Create a polished cinematic product video featuring the same matte black wireless headphones from the reference images on a clean studio set. Start with a slow rotating close-up that highlights the soft ear cushions and brushed metal details, then transition to a lifestyle shot of a young adult placing the headphones on while warm ambient light glows in the background. Keep the subject design fully consistent with the references, use smooth camera motion, realistic reflections, shallow depth of field, premium commercial styling, and subtle motion graphics for a modern brand ad.",
    "images": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/794a150611fc.jpeg",
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/1612d26e4530.jpeg",
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/87a14c8b9623.jpeg"
    ],
    "audios": [],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "generate_audio": true,
    "seed": 123456
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"
Python
import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/vidu/q4-preview/reference-to-video",
    headers=HEADERS,
    json={
        "input": {
            "prompt": "Create a polished cinematic product video featuring the same matte black wireless headphones from the reference images on a clean studio set. Start with a slow rotating close-up that highlights the soft ear cushions and brushed metal details, then transition to a lifestyle shot of a young adult placing the headphones on while warm ambient light glows in the background. Keep the subject design fully consistent with the references, use smooth camera motion, realistic reflections, shallow depth of field, premium commercial styling, and subtle motion graphics for a modern brand ad.",
            "images": [
                "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/794a150611fc.jpeg",
                "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/1612d26e4530.jpeg",
                "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/87a14c8b9623.jpeg"
            ],
            "audios": [],
            "aspect_ratio": "16:9",
            "resolution": "720p",
            "duration": 5,
            "generate_audio": True,
            "seed": 123456
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))
JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/vidu/q4-preview/reference-to-video", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "prompt": "Create a polished cinematic product video featuring the same matte black wireless headphones from the reference images on a clean studio set. Start with a slow rotating close-up that highlights the soft ear cushions and brushed metal details, then transition to a lifestyle shot of a young adult placing the headphones on while warm ambient light glows in the background. Keep the subject design fully consistent with the references, use smooth camera motion, realistic reflections, shallow depth of field, premium commercial styling, and subtle motion graphics for a modern brand ad.",
      "images": [
        "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/794a150611fc.jpeg",
        "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/1612d26e4530.jpeg",
        "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/87a14c8b9623.jpeg"
      ],
      "audios": [],
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": 5,
      "generate_audio": true,
      "seed": 123456
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

Documentation

Vidu Q4 Preview Reference to Video

vidu/q4-preview/reference-to-video

Generate a 3–16 second video from a prompt with optional references: up to 15 images and 3 audio clips. Supports aspect ratio selection, audio generation and 540p–4k resolution.

Parameters

ParameterTypeRequiredDefaultLimits / description
promptstringYes—max 5000 chars; The positive prompt for the generation.
imagesarrayNo—0–15 URLs; Reference image URL array (up to 15 images).
audiosarrayNo—0–3 URLs; Optional reference audio files for generation. Supports up to 3 audio references.
aspect_ratiostringNo"16:9"16:9, 9:16, 1:1, 3:4, 4:3; The aspect ratio of the generated media.
resolutionstringNo"720p"540p, 720p, 1080p, 2k, 4k; The resolution of the generated media.
durationintegerNo53–16; step 1; The duration of the generated media in seconds.
generate_audiobooleanNotrueWhether to generate audio.
seedintegerNo—The random seed to use for the generation. 0 or an omitted value uses a random seed.

Only prompt is required. images accepts 0–15 image URLs; audios accepts 0–3 audio URLs. Both arrays can be omitted or empty. seed=0 or an omitted seed uses a random seed. aspect_ratio defaults to 16:9. This endpoint does not expose enable_prompt_expansion.

Pricing

ResolutionUSD / secondCredits / secondUSD / 5 seconds
540p$0.0454.5$0.225
720p$0.0959.5$0.475
1080p$0.1212$0.6
2k$0.1919$0.95
4k$0.3939$1.95

Total price = resolution rate × duration. duration accepts integers from 3 to 16. Defaults: 720p, 5 seconds, audio enabled. Default total: $0.475 = 47.5 credits. Only resolution and duration affect the price; audio generation, seed, and supported reference inputs or prompt expansion add no separate fee. USD 1 = 100 credits. List prices match WaveSpeed; account discounts are applied separately.

API

curl -X POST https://www.namifusion.com/api/v1/marketplace/run/vidu/q4-preview/reference-to-video \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "prompt": "Create a polished cinematic product video featuring the same matte black wireless headphones from the reference images on a clean studio set. Start with a slow rotating close-up that highlights the soft ear cushions and brushed metal details, then transition to a lifestyle shot of a young adult placing the headphones on while warm ambient light glows in the background. Keep the subject design fully consistent with the references, use smooth camera motion, realistic reflections, shallow depth of field, premium commercial styling, and subtle motion graphics for a modern brand ad.",
    "images": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/794a150611fc.jpeg",
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/1612d26e4530.jpeg",
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/87a14c8b9623.jpeg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "generate_audio": true,
    "seed": 123456
  }
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
  -H "Authorization: Bearer $API_KEY"

Submit returns task_uuid. Poll until completed or failed. Successful output.videos is an array of video URLs.

WaveSpeed

Related models

xAI Grok Imagine Video v1.5 Reference to Video
Reference to VideoX Ai

xAI Grok Imagine Video v1.5 Reference to Video

Generate a 1-15 second video from a prompt and 1-7 reference images at 480p or 720p.

from $0.850 / per run
MiniMax H3 Reference to Video
Reference to VideoMinimax

MiniMax H3 Reference to Video

MiniMax H3 Reference to Video generates coherent 2K videos from natural-language prompts and multimodal references, including images, videos, and audio, guiding subject consistency, motion, timing, visual style, and scene continuity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.650 / per run
Gemini Omni Flash Reference to Video API
Reference to VideoGoogle

Gemini Omni Flash Reference to Video API

Gemini Omni Flash Reference to Video creates short AI videos with synchronized audio from one or more reference images and a text prompt, preserving visual identity and following the provided references for guided multimodal video generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $1.28 / per run
Seedance 2.0 Mini Reference to Video
Reference to VideoDoubao

Seedance 2.0 Mini Reference to Video

Seedance 2.0 Mini Reference-to-Video is a high-speed, cost-effective video generation model developed by ByteDance, engineered specifically for creating multi-shot videos with a cinematic feel. By seamlessly combining reference images with text prompts, it generates highly narrative video segments. The model features advanced AI camera control and ensures robust character consistency across different scenes. It supports multiple output resolutions from 480P up to 4K, durations ranging from 4 to 15 seconds, and flexible aspect ratios. Complete with an out-of-the-box REST inference API, it delivers exceptional performance with zero cold starts, offering an affordable yet premium solution for professional video creation.

from $0.3591 / per run
Seedance 2.5 Reference to Video
Reference to VideoDoubao

Seedance 2.5 Reference to Video

The "Reference-to-Video" feature of Seedance 2.5 is the ultimate solution for visual stylistic unity. It precisely extracts artistic styles, lighting tones, or compositional intents from reference materials and seamlessly integrates them into newly generated videos, ensuring a highly consistent visual language for your creative series.

from $0.6565 / per run
Seedance 2.0 Fast reference-to-video
Reference to VideoDoubao

Seedance 2.0 Fast reference-to-video

Seedance 2.0 Fast (Video-Edit) edits an input video from a natural-language prompt at a faster, cheaper tier. Built on ByteDance Seed's unified multimodal architecture, it preserves subject identity, composition, and motion while rewriting lighting, style, weather, environment, or specific elements as instructed. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.

from $0.6774 / per run
Wan 2.6 Flash Reference to Video
Reference to VideoAlibaba

Wan 2.6 Flash Reference to Video

Generate a 2–10 second video using reference images or videos, with optional audio at 720P or 1080P.

from $0.375 / per run