vidu-q4:flowdefaultcheapestVidu Q4 API — how to connect and pay
Vidu Q4 — the newest Vidu generation (Pixel): video from a first-frame image, or video from references (up to 15 images and up to 3 MP3 audio clips 3–12s). Native synchronized audio, which you can turn off. Duration 3–16s, resolutions 540p/720p/1080p/2K/4K. Priced per second by resolution.
Channel comparison
last 7 days
vidu-q4:pixel| Channel | Price |
|---|---|
Flow vidu-q4:flowdefaultcheapest | from $0.042 / s |
Pixel vidu-q4:pixel | from $0.046286 / s |
Build the result you need
vidu-q4:pixelWhat is Vidu Q4
Vidu Q4 — the newest Vidu generation (Pixel): video from a first-frame image, or video from references (up to 15 images and up to 3 MP3 audio clips 3–12s). Native synchronized audio, which you can turn off. Duration 3–16s, resolutions 540p/720p/1080p/2K/4K. Priced per second by resolution.
Contract at a glance
- Input
- text, image, audio
- Output
- video
- Mode
- async (job + polling)
- Status polling
- every 3 s · up to 600 s
Strengths
- Pricing: per second
- Inputs: text, image, audio
- 2 configurable options
- One API key for media generation
Where it is used
- Social media clips
- Promos and title sequences
- Still-image animation
- Storyboards and animatics
API contract
Generation runs asynchronously: create a job, then poll its status until completion.
- Create job
- POST /api/media/generate
- Check status
- GET /api/media/jobs/{jobId}
- Input
- text, image, audio
- Output
- video
- Polling
- every 3 s · up to 600 s
- Authentication
- Authorization: Bearer sk-pv-…
Example request
Pass your key in the Bearer header. The API returns jobId for polling the status.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"vidu-q4:pixel","prompt":"a beautiful landscape","opts":{"input":"image-to-video","resolution":"720p","duration":"5","audio":true,"image_url":"https://example.com/image_url.png"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "vidu-q4:pixel",
"prompt": "a beautiful landscape",
"opts": {
"input": "image-to-video",
"resolution": "720p",
"duration": "5",
"audio": true,
"image_url": "https://example.com/image_url.png"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API request parameters
Parameters for requests to Vidu Q4 via the GetVibe API.
promptreq.image_urlaudio_urlinputresolutiondurationaudioaspect_ratioimage_file_idimage_base64reference_image_urlsreq.reference_audio_urlsreference_image_file_idsreference_audio_file_ids| Parameter | Type | Values | Default | Price |
|---|---|---|---|---|
promptreq. | text | text description | required | — |
image_url | URL | Public image URL | — | — |
audio_url | URL | Public audio URL | — | — |
input | option selection | Image → video (default) · Reference → video | Image → video | Included in the base price |
resolution | option selection | 540p · 720p (default) · 1080p · 2K · 4K | 720p | 540p: $0.042/s, 720p: $0.088667/s, 1080p: $0.112/s, 2K: $0.177333/s, 4K: $0.364/s |
duration | option selection | 3 · 4 · 5 (default) · 6 · 7 · 8 · 9 · 10 · 11 · 12 · 13 · 14 · 15 · 16 | 5 | 3: $0.088667/s, 4: $0.088667/s, 5: $0.088667/s, 6: $0.088667/s, 7: $0.088667/s, 8: $0.088667/s, 9: $0.088667/s, 10: $0.088667/s, 11: $0.088667/s, 12: $0.088667/s, 13: $0.088667/s, 14: $0.088667/s, 15: $0.088667/s, 16: $0.088667/s |
audio | yes/no | Yes (default) · No | Yes | Yes: $0.088667/s, No: $0.097714/s |
aspect_ratio | option selection | 16:9 (default) · 9:16 · 1:1 · 4:3 · 3:4 | 16:9 | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
reference_image_urlsreq. | Array<URLs>, 1–15 items | Public HTTP(S) URLs | required | Included in the base price |
reference_audio_urls | Array<URLs>, 0–3 items | Public HTTP(S) URLs | — | Included in the base price |
reference_image_file_ids | Array<strings> | List of values | — | Included in the base price |
reference_audio_file_ids | Array<strings> | List of values | — | Included in the base price |
Request: POST https://getvibeapi.com/api/media/generate. Prices in USD.
Price of Vidu Q4
The cost of Vidu Q4: from $0.042 per second. The price is calculated dynamically at the current exchange rate, and the final charge is shown in the API response (priceRub). Payment in USD, no subscriptions.
What a default request costs
With no parameters sent, the request uses these values: Duration — 5, Resolution — 720p, Audio — Yes, Source material — Image → video. That request costs $0.443333.
“from $0.042” is the cheapest parameter set, not the price of a default request.
Channels and prices for every parameter combination
For every channel, the price of every parameter combination. It is exactly the amount a successful generation is charged, and the same figure as in the machine-readable table linked below.
Pixelvidu-q4:pixelfrom $0.046286 / sexact prices
| Input · With sound \ Resolution | 540p | 720p | 1080p | 2K | 4K |
|---|---|---|---|---|---|
| Image → video · No | $0.046286 / s | $0.097714 / s | $0.123429 / s | $0.195429 / s | $0.401143 / s |
| Image → video · Yes | $0.046286 / s | $0.097714 / s | $0.123429 / s | $0.195429 / s | $0.401143 / s |
| Reference → video · No | $0.046286 / s | $0.097714 / s | $0.123429 / s | $0.195429 / s | $0.401143 / s |
| Reference → video · Yes | $0.046286 / s | $0.097714 / s | $0.123429 / s | $0.195429 / s | $0.401143 / s |
Every combination as JSON: /api/media/price-table?model=vidu-q4%3Apixel
Flowvidu-q4:flowfrom $0.042 / sexact prices
| Input \ Resolution | 540p | 720p | 1080p | 2K | 4K |
|---|---|---|---|---|---|
| Image → video | $0.042 / s | $0.088667 / s | $0.112 / s | $0.177333 / s | $0.364 / s |
| Reference → video | $0.042 / s | $0.088667 / s | $0.112 / s | $0.177333 / s | $0.364 / s |
Every combination as JSON: /api/media/price-table?model=vidu-q4%3Aflow
README
The machine-readable contract for Vidu Q4 contains the request schema, operations, limits, polling and response examples.
# Vidu Q4
Public model: vidu-q4:pixel
Create job: POST /api/media/generate
Check status: GET /api/media/jobs/{jobId}
## Input parameters
- `prompt` (text): text description; default: required
- `image_url` (URL): Public image URL; default: —
- `audio_url` (URL): Public audio URL; default: —
- `input` (option selection): Image → video (default) · Reference → video; default: Image → video
- `resolution` (option selection): 540p · 720p (default) · 1080p · 2K · 4K; default: 720p
- `duration` (option selection): 3 · 4 · 5 (default) · 6 · 7 · 8 · 9 · 10 · 11 · 12 · 13 · 14 · 15 · 16; default: 5
- `audio` (yes/no): Yes (default) · No; default: Yes
- `aspect_ratio` (option selection): 16:9 (default) · 9:16 · 1:1 · 4:3 · 3:4; default: 16:9
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); default: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; default: —
- `reference_image_urls` (Array<URLs>, 1–15 items): Public HTTP(S) URLs; default: required
- `reference_audio_urls` (Array<URLs>, 0–3 items): Public HTTP(S) URLs; default: —
- `reference_image_file_ids` (Array<strings>): List of values; default: —
- `reference_audio_file_ids` (Array<strings>): List of values; default: —
## Public variants
- `vidu-q4:flow`: Flow
- `vidu-q4:pixel`: PixelFAQ about the Vidu Q4 API
How much does Vidu Q4 cost?
The price of Vidu Q4: from $0.042 per second. The price is calculated dynamically at the current exchange rate.
Is it compatible with the OpenAI SDK?
Yes, the API is fully OpenAI-compatible. Just change base_url to https://getvibeapi.com/v1 and set your key — the rest of the code stays the same.