PixVerse API
PixVerse API on WaveSpeedAI — PixVerse V6, V6 Max and C1 text-to-video, image-to-video, reference-to-video and transitions with 1-15 second clips up to 1080p and optional native audio, plus V5.x, motion control, swap, lipsync and music MV endpoints.
One API key for the PixVerse video family: V6 and V6 Max for text-to-video and image-to-video, C1 for film-grade clips and transitions, earlier V5 and V4.5 generations, and the motion-control, swap, lipsync and music-video endpoints. Call them with the same REST prediction flow as every other model on WaveSpeedAI.
概览
关于 PixVerse API
PixVerse 能做什么、它在 PixVerse 模型阵容中的定位,以及团队选择它的原因。
PixVerse 是 PixVerse 推出的视频生成模型,可通过 WaveSpeedAI REST API 使用。PixVerse API on WaveSpeedAI — PixVerse V6, V6 Max and C1 text-to-video, image-to-video, reference-to-video and transitions with 1-15 second clips up to 1080p and optional native audio, plus V5.x, motion control, swap, lipsync and music MV endpoints.
One API key for the PixVerse video family: V6 and V6 Max for text-to-video and image-to-video, C1 for film-grade clips and transitions, earlier V5 and V4.5 generations, and the motion-control, swap, lipsync and music-video endpoints. Call them with the same REST prediction flow as every other model on WaveSpeedAI.
WaveSpeedAI 上的 PixVerse 系列提供 24 个 REST 端点,涵盖 Image-To-Video, Text-To-Video, Reference-To-Video, Video-Extend, Video-Effects, Motion-Control, Video-To-Video, Digital-Human 个工作流。每个变体都有各自的定价、参数选项和示例输出——请选择与你的输入模态和生产约束相匹配的那一个,或使用同一个 API 密钥调用多个变体,组合成多步骤流水线。
使用与 WaveSpeedAI 上其他 1,000 多个 AI 模型相同的 API 密钥、账单账户和速率限制来运行 PixVerse。无需单独对接供应商,无需各家 SDK,也无需应对各家不同的速率限制——一次集成即可覆盖从文生图、文生视频到音频合成、3D 生成、放大和编辑的全部能力。
端点
全部 PixVerse API 端点
WaveSpeedAI 现已提供 24 个 PixVerse 端点——请选择适合你工作流的变体。
/filters:quality(82)/media/images/2cdb168a-fdcb-4a74-93f7-03cc97e1ace8.webp)
Pixverse v6 Max Image To Video
PixVerse V6 Max Image-to-Video generates high-quality videos from input images with flexible duration, 360P to 1080P output, seed control, optional native audio generation, multi-clip generation for creative, social, marketing, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/0104a544-ce4e-4256-bab3-3382de46f2dd.webp)
Pixverse v6 Max Text To Video
PixVerse V6 Max Text-to-Video generates high-quality videos from text prompts with flexible duration, 360P to 1080P output, aspect ratio and seed controls, optional native audio generation, and multi-clip generation for creative, social, marketing, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785412894905684267_jzY7xHR0.webp)
Pixverse v6 Reference To Video
PixVerse V6 Reference to Video creates high-quality videos from prompts, up to 10 reference images, and up to 2 reference videos. Use image references for subject, product, character, and scene consistency, and video references for motion, camera movement, action timing, and visual style. Supports optional audio and up to 1080P output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104103_e6ozhl9s.webp)
Pixverse v6 Transition
PixVerse V6 Transition creates smooth AI-generated video transitions between a start image and an optional end image. Supports 360p to 1080p resolutions, 1-15 second duration, multiple aspect ratios, optional audio generation, and multi-clip mode. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104056_9jmosgiz.webp)
Pixverse v6 Extend
PixVerse V6 Extend continues and enhances existing video content by analyzing the ending segment and generating new frames forward. Supports 360p to 1080p resolutions, 1-15 second extension duration, optional audio generation, and multiple styles. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104052_wme1fft3.webp)
Pixverse v6 Image To Video
PixVerse V6 generates high-quality videos from images with flexible duration (1-15s), multiple resolutions up to 1080p, and optional audio generation. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/20260408104059_dxcdg6lw.webp)
Pixverse v6 Text To Video
PixVerse V6 generates high-quality videos from text prompts with flexible duration (1-15s), multiple resolutions up to 1080p, and optional audio generation. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/1777710835599985297_ibAKT3OX.webp)
Pixverse C1 Transition
PixVerse C1 generates smooth transition videos between two images with flexible duration (1-15s), multiple resolutions up to 1080p, and optional native audio generation. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/1777710820845603554_Qo1oOgCR.webp)
Pixverse C1 Image To Video
PixVerse C1 generates film-grade videos from a starting image with flexible duration (1-15s), multiple resolutions up to 1080p, and optional native audio generation. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/1777710808435884269_lzWdA7DV.webp)
Pixverse C1 Text To Video
PixVerse C1 generates film-grade videos from text prompts with flexible duration (1-15s), multiple resolutions up to 1080p, and optional native audio generation. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/1777711153699175678_fIR0sCMU.webp)
Pixverse C1 Reference To Video
PixVerse C1 Reference-to-Video generates videos from reference images with subject and background consistency. Use @ref_name in prompts to reference uploaded images. Supports 360p to 1080p resolutions, 1-15 second duration, multiple aspect ratios, and optional audio generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104147_9iq6vq6m.webp)
Pixverse v5.6 Text To Video
PixVerse V5.6 transforms text prompts into realistic videos with smooth motion and natural detail in seconds—ideal for stories, ads, and social clips. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104143_769cl1c3.webp)
Pixverse v5.6 Image To Video
PixVerse V5.6 Image-to-Video turns a single image into cinematic clips with smooth motion, clean detail, and strong subject fidelity—ideal for logo stingers, character motion, and social posts. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/20260408104137_7t6upbqo.webp)
Pixverse v5.5 Image To Video
PixVerse V5.5 Image-to-Video turns a single image into cinematic clips with smooth motion, clean detail, and strong subject fidelity—ideal for logo stingers, character motion, and social posts. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/20260408104140_iz7l2gsr.webp)
Pixverse v5.5 Text To Video
PixVerse V5.5 transforms text prompts into realistic videos with smooth motion and natural detail in seconds—ideal for stories, ads, and social clips. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104113_8lpoohvv.webp)
Pixverse v5.5 Transition
Create smooth morph transitions between two images into 5s, 8s or 10s videos at 360p, 540p, 720p, or 1080p—perfect for logo reveals, before-and-after shots, and social posts. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/20260408104115_lih2fv4w.webp)
Pixverse v5.5 Effects
PixVerse V5.5 Effects is an AI image-to-video model that converts still images into smooth, natural short videos with lifelike motion, supporting 5s/8s/10s clips at 360p to 1080p for social posts, ads, and previews. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/20260408104122_pr5ldpw3.webp)
Pixverse v5 Transition
Create smooth morph transitions between two static images into 5s or 8s videos at 360p, 540p, 720p, or 1080p. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104108_i1vo2evv.webp)
Pixverse v5 Effects
PixVerse V5 Effects converts images into smooth, natural short videos with lifelike motion; supports 5s/8s and 720p/1080p outputs. Ready-to-use REST API, no coldstarts, best performance, affordable pricing.
/filters:quality(82)/media/images/20260408104131_hwc7dryc.webp)
Pixverse v5 T2v
PixVerse V5 Text-to-Video generates smooth, natural 5s videos from text prompts in seconds, with 720p output available ($0.20 per 5s). Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104127_94c59j4l.webp)
Pixverse v5 I2v
PixVerse V5 converts images to short, smooth, natural-looking videos. 5s video: $0.15 (360p/540p), $0.20 (720p), $0.40 (1080p). Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1779786234555433992_xdFx1v0s.webp)
Motion Control Mimic
PixVerse Motion Control Mimic is a fast AI motion transfer model that transfers motion from a reference video onto a target image to create natural character animation from a still image and motion clip. Ready-to-use REST inference API for character animation, pose transfer, reference motion videos, social media clips, advertising creatives, and professional image-to-video workflows with simple integration, no coldstarts, and affordable pricing.
/filters:quality(82)/media/images/20260408104117_58e257su.webp)
Swap
PixVerse Swap replaces backgrounds, people, and objects directly inside existing videos for quick scene changes and creative edits with natural-looking results. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
/filters:quality(82)/media/images/20260408104110_g9dbn0mw.webp)
Lipsync
PixVerse LipSync converts audio into realistic lip-sync animations with advanced algorithms for precise mouth movements and timing for video avatars. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
示例
看看 PixVerse 的实际效果
由 PixVerse API 生成的真实输出。悬停在任意视频上即可预览,点击可打开全尺寸查看器。
使用方法
如何使用 PixVerse API
从注册到完成一次生成,只需四步。完整的 Python、Node.js 和 cURL 示例见下方的 API 部分。
- 01
获取 API 密钥
注册 WaveSpeedAI 账号,并从控制台复制你的 API 密钥。新账号附带免费体验额度——足够在开始计费前把 Playground 运行几十次。
- 02
提交预测
把你的输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/pixverse/pixverse-v6/text-to-video。端点会立即返回预测 ID——生成是异步的,因此推理期间你无需保持连接。
- 03
轮询完成状态
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。状态为 completed 时返回输出;状态为 failed、cancelled、timeout 或 deleted 时以错误终止;其他任何状态都继续轮询。
- 04
读取输出 URL
状态变为 "completed" 后,从 data.outputs[0] 读取 URL。该 URL 指向 WaveSpeedAI CDN 上你生成的媒体——具体是图片、视频、音频还是 3D 文件,取决于你调用的 PixVerse 变体。
应用场景
用 PixVerse 可以构建什么
开发者和创作者使用 PixVerse API 的常见工作流。
Text-to-video up to 1080p
pixverse/pixverse-v6/text-to-video and pixverse-v6-max/text-to-video generate videos from prompts with 1-15 second duration, 360p to 1080p output and optional native audio.
Reference-to-video consistency
pixverse/pixverse-v6/reference-to-video and pixverse-c1/reference-to-video build videos from reference images with subject and background consistency.
Transitions between two images
pixverse-c1/transition and pixverse-v6/transition create smooth AI-generated transitions from a start image to an end image — logo reveals, before-and-after shots, scene changes.
Motion control, swap and lipsync
pixverse/motion-control/mimic transfers motion from a reference video onto a target image, pixverse/swap replaces backgrounds, people and objects inside existing video, and pixverse/lipsync animates mouths from audio.
Music videos from audio
pixverse/music-mv-agent generates a music video from an input audio track with optional visual references, style controls, aspect ratio and quality settings.
技巧
PixVerse 提示词技巧
让 PixVerse 输出更好结果的实用建议——总结自生产流水线中各类视频模型都适用的做法。
- 01
明确说明运镜方式
使用具体的摄影术语——orbit、dolly-in、push-in、pan-left、crane shot、handheld follow。笼统的提示词会产生静止或随意的镜头选择;命名的运镜方式能直接对应到模型训练数据中的运动意图,大幅提升镜头质量。
- 02
用参考图像锚定角色身份
如果提示词依赖特定的人物、角色或产品,请在提示词之外上传参考图像。没有参考时,身份会在帧与帧之间、镜头与镜头之间漂移——同一个角色每次生成看起来都像略有不同的人。
- 03
描述光线和时间
「黄金时刻,柔和温暖的定向光」或「阴天漫射光,石板灰的天空」这类光线提示,比含糊的画质修饰词更能提升质量和一致性。光线是模型所依据的最强先验之一。
- 04
用负面提示词抑制常见的失败模式
视频常用的负面提示词:「帧闪烁、运动模糊、水印、文字伪影、变形的手、低分辨率、JPEG 压缩」。负面提示词不花一分钱,却能明显降低您原本需要重新抽取的生成比例。
- 05
选择能涵盖该节拍的最短时长
大多数提示词在 5-8 秒时效果最好。更长的片段会放大时间上的不一致(主体变形、环境漂移)。如果需要 20 秒的序列,请生成三段 6-8 秒的片段再剪辑在一起——质量比一次长生成更高。
- 06
预先让画幅比例匹配平台
TikTok / Reels / Shorts 用 9:16,横屏信息流和 YouTube 用 16:9,帖子宫格用 1:1。模型对每种画幅比例的训练略有不同——事后把 16:9 裁成 9:16,会同时损失保真度和模型原本设计的构图。
定价
PixVerse API 定价
按输出计费。最终费用会随你在各变体 Playground 中设置的参数(分辨率、时长、输出数量、参考素材)而变化。
API
调用 PixVerse API
在 wavespeed.ai/accesskey 注册并获取 API 密钥,然后通过 REST 提交预测。Playground 可以为任意输入组合生成可直接粘贴的示例代码。
POSThttps://api.wavespeed.ai/api/v3/pixverse/pixverse-v6/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/pixverse/pixverse-v6/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio_switch": false,
"thinking_type": "auto"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/pixverse/pixverse-v6/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio_switch": false,
"thinking_type": "auto"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio_switch": False,
"thinking_type": "auto"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/pixverse/pixverse-v6/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)对比
PixVerse 与其他方案对比
在 WaveSpeedAI 上,何时应选择 PixVerse 而不是同类模型。
PixVerse 对比 Kling 3.0
Kling 3.0 ships Standard, Pro and 4K tiers with native audio on every variant. PixVerse covers a wider set of utility endpoints — transitions, motion control, swap, lipsync and a music-video agent — alongside text and image to video.
PixVerse 对比 Hailuo 2.3
Hailuo 2.3 focuses on physics-aware text-to-video and image-to-video in Standard, Pro and Fast tiers. PixVerse V6 offers 1-15 second clips with optional audio plus reference-to-video and extend.
常见问题
PixVerse API — 常见问题
定价、许可、集成——关于在 WaveSpeedAI 上运行 PixVerse 的常见问题。
PixVerse API 是什么?
PixVerse 是 PixVerse 的视频生成模型,在 WaveSpeedAI 上以 REST API 形式提供。PixVerse API on WaveSpeedAI — PixVerse V6, V6 Max and C1 text-to-video, image-to-video, reference-to-video and transitions with 1-15 second clips up to 1080p and optional native audio, plus V5.x, motion control, swap, lipsync and music MV endpoints.你可以通过编程方式调用它,也可以在上方链接的 Playground 中试用。
如何调用 PixVerse API?
注册 WaveSpeedAI 账号,从 /accesskey 复制你的 API 密钥,然后把输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/pixverse/pixverse-v6/text-to-video。端点会返回预测 ID。从大约每 2 秒一次开始轮询结果端点,长耗时任务可适当拉长间隔,并在任何终止状态时停止。上方有面向生产环境的 Python / Node.js / cURL 示例。
PixVerse API 的费用是多少?
PixVerse $0.04 起。实际费用会随你设置的参数(分辨率、时长、输出数量、参考素材)而变化。Playground 中“生成”按钮旁的实时费用预览会显示你当前输入对应的准确价格。
有哪些 PixVerse 变体可用?
WaveSpeedAI 托管了 24 个已上线的 PixVerse 端点:pixverse/pixverse-v6-max/image-to-video, pixverse/pixverse-v6-max/text-to-video, pixverse/pixverse-v6/reference-to-video, pixverse/pixverse-v6/transition, pixverse/pixverse-v6/extend, pixverse/pixverse-v6/image-to-video, pixverse/pixverse-v6/text-to-video, pixverse/pixverse-c1/transition等。每个变体都有自己的 Playground 页面和定价。
PixVerse 的输出可以商用吗?
商用权利遵循 PixVerse 的模型许可。大多数 PixVerse 模型允许商用输出;具体许可摘要请查看各模型的 Playground 页面,平台层面的条件请参阅 WaveSpeedAI 的服务条款。
为什么要在 WaveSpeedAI 上使用 PixVerse,而不是直接对接?
一个 API 密钥、一个账单账户,即可使用 PixVerse 以及来自其他提供方的 1,000 多个 AI 模型。无需逐家配置 SDK,无需应对各自独立的速率限制,也无需为每家重写集成代码。价格通常与 PixVerse 直接提供的 API 持平或更低。
在 WaveSpeedAI 上用 PixVerse 开始构建
注册即送免费体验额度。一个 API 密钥,即可使用来自 PixVerse 及其他所有提供方的 1,000 多个 AI 模型。