主题

语言

视频

Vidu Q4 API — 如何接入并付费

Vidu Q4 — 最新一代 Vidu（Pixel）：从首帧图像生成视频，或根据参考素材生成视频（最多 15 张图像，以及最多 3 段 3–12s 的 MP3 音频）。原生同步音频，可关闭。时长 3–16s，分辨率为 540p/720p/1080p/2K/4K。按分辨率以秒计费。

渠道对比

渠道	价格
Flow`vidu-q4:flow`默认最便宜	$0.042 起 / 秒
Pixel`vidu-q4:pixel`	$0.046286 起 / 秒

组合你需要的输出结果

vidu-q4:pixel

Duration

Resolution

Audio

Source material

输入： 文本, 图像, 音频某些模式需要附加： source image

获取 API 密钥

什么是 Vidu Q4

契约概览

输入: text, image, audio
输出: video
模式: 异步（任务 + 轮询）
状态轮询: 每 3 秒 · 最多 600 秒

优势

定价：按秒计费
输入：文本、图像、音频
2 个可配置选项
用于媒体生成的一个 API 密钥

应用场景

社交媒体片段
宣传片和片头序列
静态图像动画
故事板和动态分镜

请求示例

在 Bearer 请求头中传递密钥。API 会返回 jobId 用于轮询状态。

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 请求参数

通过 GetVibe API 向 Vidu Q4 发起请求的参数。

参数

prompt必填

类型

text

取值

text description

默认值

required

价格

—

参数

image_url

类型

URL

取值

Public image URL

默认值

—

价格

—

参数

audio_url

类型

URL

取值

Public audio URL

默认值

—

价格

—

参数

input

类型

option selection

取值

Image → video (default) · Reference → 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

默认值

价格

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: $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_urls必填

类型

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

参数	类型	取值	默认值	价格
`prompt`必填	text	text description	required	—
`image_url`	URL	Public image URL	—	—
`audio_url`	URL	Public audio URL	—	—
`input`	option selection	Image → video (default) · Reference → 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: $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_urls`必填	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

请求：POST https://getvibeapi.com/api/media/generate。价格以 USD 计。

Vidu Q4 的价格

Vidu Q4 的费用：从 $0.042 per second。价格按当前汇率动态计算，最终扣费见 API 响应（priceRub）。以 USD 支付，无订阅。

默认请求的实际费用

若不传参数，请求将使用这些取值：Duration — 5, Resolution — 720p, Audio — Yes, Source material — Image → video。 该请求的费用为 $0.443333。

“$0.042 起”是最便宜的参数组合，并非默认请求的价格。

各渠道及所有参数组合的价格

每个渠道的每种参数组合价格。这正是成功生成时扣除的金额，与下方链接的机器可读价格表一致。

Pixelvidu-q4:pixel$0.046286 起 / 秒精确价格

输入 · 带声音 \ 分辨率	540p	720p	1080p	2K	4K
图生视频 · 否	$0.046286 / 秒	$0.097714 / 秒	$0.123429 / 秒	$0.195429 / 秒	$0.401143 / 秒
图生视频 · 是	$0.046286 / 秒	$0.097714 / 秒	$0.123429 / 秒	$0.195429 / 秒	$0.401143 / 秒
参考生视频 · 否	$0.046286 / 秒	$0.097714 / 秒	$0.123429 / 秒	$0.195429 / 秒	$0.401143 / 秒
参考生视频 · 是	$0.046286 / 秒	$0.097714 / 秒	$0.123429 / 秒	$0.195429 / 秒	$0.401143 / 秒

所有组合（JSON）： /api/media/price-table?model=vidu-q4%3Apixel

Flowvidu-q4:flow$0.042 起 / 秒精确价格

输入 \ 分辨率	540p	720p	1080p	2K	4K
图生视频	$0.042 / 秒	$0.088667 / 秒	$0.112 / 秒	$0.177333 / 秒	$0.364 / 秒
参考生视频	$0.042 / 秒	$0.088667 / 秒	$0.112 / 秒	$0.177333 / 秒	$0.364 / 秒

所有组合（JSON）： /api/media/price-table?model=vidu-q4%3Aflow

README

Vidu Q4 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。

# Vidu Q4

公开模型：vidu-q4:pixel
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}

## 输入参数
- `prompt` (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
- `resolution` (option selection): 540p · 720p (default) · 1080p · 2K · 4K; 默认: 720p
- `duration` (option selection): 3 · 4 · 5 (default) · 6 · 7 · 8 · 9 · 10 · 11 · 12 · 13 · 14 · 15 · 16; 默认: 5
- `audio` (yes/no): Yes (default) · No; 默认: Yes
- `aspect_ratio` (option selection): 16:9 (default) · 9:16 · 1:1 · 4:3 · 3:4; 默认: 16:9
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; 默认: —
- `reference_image_urls` (Array<URLs>, 1–15 items): Public HTTP(S) URLs; 默认: required
- `reference_audio_urls` (Array<URLs>, 0–3 items): Public HTTP(S) URLs; 默认: —
- `reference_image_file_ids` (Array<strings>): List of values; 默认: —
- `reference_audio_file_ids` (Array<strings>): List of values; 默认: —

## 公开变体
- `vidu-q4:flow`: Flow
- `vidu-q4:pixel`: Pixel

模型 JSON 契约 Media API 指南 OpenAPI JSON

关于 Vidu Q4 API 的常见问题

Vidu Q4 的价格是多少？

Vidu Q4 的价格：从 $0.042 per second。价格按当前汇率动态计算。

是否兼容 OpenAI SDK？

是的，API 完全兼容 OpenAI。只需将 base_url 改为 https://getvibeapi.com/v1 并设置密钥——其余代码不变。

立即接入 Vidu Q4

一分钟注册，按用量付费，代码已备好。

获取 API 密钥

Vidu Q4 API — 如何接入并付费

渠道对比

组合你需要的输出结果

什么是 Vidu Q4

契约概览

优势

应用场景

API 契约

请求示例

JavaScript

API 请求参数

Vidu Q4 的价格

各渠道及所有参数组合的价格

README

关于 Vidu Q4 API 的常见问题

立即接入 Vidu Q4

相似模型