Vidu Q4 Preview Reference to Video
vidu/q4-preview/reference-to-video
vidu/q4-preview/reference-to-video. Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.
Powiązane modele
Pełne parametry, schemat wyjścia i aktualne ceny
| Rynek API modeli AI | Jedna platforma do wszystkiego | Najpopularniejszy | Regulamin | Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API. |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | |
| imagesImages | image_upload | — | image/* · 0–15 items | |
| audiosAudios | audio_upload_group | — | audio/* · 0–3 items | |
| aspect_ratioAspect Ratio | select | 16:9 | 16:9 | 9:16 | 1:1 | 3:4 | 4:3 | |
| resolutionResolution | select | 720p | 540p | 720p | 1080p | 2k | 4k | |
| durationDuration | slider | 5 | 3 ~ 16 · step 1 | |
| generate_audioGenerate Audio | boolean | true | — | |
| seedSeed | number | — | step 1 |
Pełne parametry, schemat wyjścia i aktualne ceny
| Dowiedz się więcej | Jedna platforma do wszystkiego | Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API. |
|---|---|---|
| videos | array<string> |
API
Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.
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);Dokumentacja API
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
| Parameter | Type | Required | Default | Limits / description |
|---|---|---|---|---|
prompt | string | Yes | — | max 5000 chars; The positive prompt for the generation. |
images | array | No | — | 0–15 URLs; Reference image URL array (up to 15 images). |
audios | array | No | — | 0–3 URLs; Optional reference audio files for generation. Supports up to 3 audio references. |
aspect_ratio | string | No | "16:9" | 16:9, 9:16, 1:1, 3:4, 4:3; The aspect ratio of the generated media. |
resolution | string | No | "720p" | 540p, 720p, 1080p, 2k, 4k; The resolution of the generated media. |
duration | integer | No | 5 | 3–16; step 1; The duration of the generated media in seconds. |
generate_audio | boolean | No | true | Whether to generate audio. |
seed | integer | No | — | 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
| Resolution | USD / second | Credits / second | USD / 5 seconds |
|---|---|---|---|
| 540p | $0.045 | 4.5 | $0.225 |
| 720p | $0.095 | 9.5 | $0.475 |
| 1080p | $0.12 | 12 | $0.6 |
| 2k | $0.19 | 19 | $0.95 |
| 4k | $0.39 | 39 | $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.
Powiązane modele
xAI Grok Imagine Video v1.5 Reference to Video
x-ai/grok-imagine-video-v1.5/reference-to-video. Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.
MiniMax H3 Reference to Video
minimax/h3/reference-to-video. Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.
Gemini Omni Flash Reference to Video API
google/gemini-omni-flash/reference-to-video. Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.
Seedance 2.0 Mini Reference to Video
doubao/seedance-2.0-mini/reference-to-video. Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.
Seedance 2.5 Reference to Video
doubao/seedance-2-5/reference-to-video. Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.
Seedance 2.0 Fast reference-to-video
doubao/seedance-2-0-fast/reference-to-video. Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.
Wan 2.6 Flash Reference to Video
alibaba/wan-2.6-flash/reference-to-video. Przeglądaj API modeli obrazu, wideo i zamiany twarzy. Wypróbuj model, a następnie zintegruj go przez wspólne REST API.