一个密钥，两个请求头，八个模型：PixVerse AI API 详解

两位开发者今天早上阅读了 PixVerse 文档。一位推出了负提示词功能。另一位发现该参数已不复存在。

两人读的都是官方页面。这就是 2026 年 PixVerse API 的真实状况：一个功能强大、快速迭代的视频生成服务，其文档中旧页面和新页面 quietly 存在分歧。大多数 PixVerse AI API 开发者的问题归结为两点：哪里能找到真正最新的文档？以及代码跑通后，一个片段要花多少钱？

本指南同时回答了这两个问题。以下每个端点、参数和价格均于本周（2026 年 7 月 23 日）与第一方页面核对过。

关键要点

• 官方 PixVerse API 文档位于 docs.platform.pixverse.ai。密钥和积分位于 platform.pixverse.ai。消费者应用 app.pixverse.ai 是独立产品，计费方式不同。
• 每次调用都需要两个标头：API-KEY 以及每个请求唯一的 Ai-trace-id UUID。生成是异步的：提交任务，获取 video_id，轮询获取结果。
• 文档在某些地方自相矛盾。较旧的 How-to 页面仍显示 negative_prompt 和 water_mark；当前的生成参考中两者均不存在。当页面不一致时，请以端点参考为准。
• 官方计费以积分计（$10 购买 1,000 积分）。同一 V6 模型在 Atlas Cloud 上按秒计费，从 $0.025/秒起，默认 5 秒 720p 带音频的片段售价 $0.30，而按积分包费率则为 $0.60。

PixVerse API 文档地图：真实文档在哪里

搜索 PixVerse API 文档会返回四个第一方页面和大量转售商页面。重要的四个如下：

最容易让人困惑的区别在于 app 和 platform。App 销售 $10 起的月度套餐，并提供每日不定量免费积分。Platform 在独立的账本上销售 API 积分和会员资格。付费的 app 订阅在 API 端没有任何作用，反之亦然。

平台文档 中隐藏着一个真正有用的细节：一个名为 PixVerse-api-llm.txt 的明文页面，将整个 API 参考整合到一个文档中。将其粘贴到你的编码助手中，它就能根据当前规范编写 PixVerse 调用，而不是依赖其训练数据中的旧信息。

文档描述的服务背后是“覆盖 175 个国家超过 1 亿创作者和企业”。规模是真实的。随之而来的版本更迭正是本文设有“矛盾之处”部分的原因。

今天使用 PixVerse AI API 的两种方式

下一节将详细介绍如何与 PixVerse 自己的平台集成。最快接触模型的方式是通过托管方：Atlas Cloud 在其 400 多个模型中运行 PixVerse V6 和 C1，按秒计费，以美元结算，无需积分包，也无水印。PixVerse 系列页面 列出了所有九个托管端点，从文生视频到参考图生视频再到扩展。两种方式：先在 Playground 中测试，然后从代码调用同一端点。自然的起点是 V6 文生视频 Playground。

方法 1：在 Playground 中测试 PixVerse V6 API

在编写代码之前，先花十分钟体验这里。Playground 与你的代码将要调用的端点相同，并附带了价格预估。

1. 登录并打开 Playground。 提示词字段是唯一必填项。
2. 设置时长、质量和宽高比。 默认值为 5 秒、720p、16:9。
3. 检查音频开关。 声音默认开启，会提高每秒费率。
4. 查看“运行”按钮。 它会显示当前设置的确切费用。在默认设置下为 $0.30，因此 $10 大约可运行 33 次。
5. 运行、查看、下载。 迭代提示词直到输出满意，然后将该确切配置转移到代码中。

方法 2：从代码调用 PixVerse V6 API

在 Atlas Cloud 上的 PixVerse V6 开发者工作流程需要两个 HTTP 请求。

步骤 1：获取 API 密钥。 在 Atlas Cloud 控制台创建一个密钥，并将其存储为环境变量，切勿放在客户端代码中。

图片：Atlas Cloud 控制台 API 密钥页面截图，显示创建密钥按钮以及新生成的密钥及其复制控件。

步骤 2：查看 API 文档。 端点、参数和认证信息位于 API 文档 中。

步骤 3：发送第一个请求。 提交任务：

plaintextCopy
1curl -X POST https://api.atlascloud.ai/api/v1/model/generateVideo \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
4  -d '{
5    "model": "pixverse/v6/text-to-video",
6    "prompt": "A slow dolly shot through a rain-wet night market, neon signs reflecting in puddles, steam rising from food stalls",
7    "duration": 5,
8    "quality": "720p",
9    "aspect_ratio": "16:9",
10    "sound": true
11  }'

响应返回一个 prediction ID。轮询直到状态变为 completed：

plaintextCopy
1curl https://api.atlascloud.ai/api/v1/model/prediction/<prediction_id> \
2  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

完成后的响应包含托管视频的 URL。持久的好处是请求形式：Atlas Cloud 在所有模型上运行同一个 API，因此一个密钥、一个认证标头、一个提交-轮询循环即可覆盖今天的 PixVerse 以及你未来添加的任何模型。切换模型只需更改 model 字符串，其他都不变。

官方 PixVerse AI API 文档内部：一次调用实际如何运行

如果你改为与 PixVerse 自己的平台集成，API 概述 定义了针对基础域名 app-api.pixverse.ai 的三阶段流程：

每次调用都需要两个认证标头。API-KEY 包含来自平台控制台的密钥。Ai-trace-id 必须是每个请求唯一的 UUID；文档警告说，重复使用同一个 ID 会阻止新生成任务启动。

当前的文生视频参考 标记了五个必填字段：prompt（最多 5,000 个字符）、model、duration、quality 和 aspect_ratio。model 枚举接受八个值，从 v3.5 到 v5.6 以及 v6 和 c1，时长限制随生成方式变化：v5 及以下为 5 或 8 秒，v5.5 和 v5.6 提供 10 秒选项，v6 和 c1 支持 1 到 15 秒任意时长。音频通过 generate_audio_switch 选择加入，默认值为 false。这个默认值对预算很重要：上面的 Atlas Cloud Playground 默认开启声音，因此对于看似相同的片段，两种方式会报出不同的价格。

图生视频首先需要上传步骤。不能直接传递公开图片 URL；你需要上传文件，获取返回的 img_id，然后在生成主体中引用它。

两个操作细节来自错误参考。并发生成数量受会员等级限制，卡住的槽位大约 10 分钟后会自动释放。轮询状态值得显式处理：7 表示提示词触发了内容审核，8 表示服务器端错误，值得重试。

PixVerse API 文档中自相矛盾的地方

PixVerse API 文档是当前端点参考和未完全更新的旧 How-to 页面的混合体。阅读错误的页面会浪费大量调试时间。我们直接验证的冲突如下：

两条规则涵盖所有五行。当页面不一致时，以端点参考为准，而非 How-to 页面；参考页面携带当前规范，指南页面携带历史记录。当限制不一致时，以更严格的为准，因此上传图片以 4000 像素为限。

版本枚举本身值得注意。旧的模型名称仍然有效：v3.5、v4 和 v4.5 仍然是有效值，因此 2025 年的集成没有中断。它们只是多付了钱。在 720p 5 秒无音频的情况下，官方定价 V4 收费 60 积分，而 V6 仅 45 积分。如果你继承了一个使用旧模型字符串的代码库，升级它是一个单行更改，既能降低成本又能提高输出质量。只有 V2 代已完全从第一方访问中移除。

PixVerse API 定价：平台上的积分，Atlas Cloud 上的美元

官方 PixVerse 平台以积分计费，其定价页面 将模型表标注为“按秒计算”。积分包从 $10 购买 1,000 积分到 $5,000 购买 500,000 积分不等，月度会员从 $100 的 Essential 计划（15,000 积分）起，最高到 $6,000 的 Business 层级。当前模型的每秒积分消耗：

Atlas Cloud 以美元/秒计量相同的两个模型，无需积分包或会员。于 2026 年 7 月 23 日在实时模型页面上验证，为标价且无折扣运行：

一个片段可以让比较更具体。一个 5 秒 720p 带音频的 V6 片段需要 60 积分：在 $10 积分包费率下为 $0.60，在 Essential 会员费率下约为 $0.40（需每月承诺 $100）。在 Atlas Cloud 上按秒计费，相同的片段为 $0.30。C1 模型每秒价格略高，通过 C1 Playground 生成相同片段的价格为 $0.325，这为其电影级调优买单。

对于已经身处 PixVerse 平台的团队，积分仍然有意义，尤其是在 Scale 层级，有效费率较低。对于其他所有人，按秒计费更容易预测：渲染价格等于时长乘以费率，在花费前即可读取。

构建 PixVerse AI API 的开发者公司

一个 API 意味着对运营它的公司的信任，在构建之前了解 PixVerse AI 的开发者公司是值得的。PixVerse 由 AISphere（爱诗科技）构建，于 2023 年 4 月在北京成立，总部现设在新加坡，约有 150 名员工。创始人兼 CEO 王长虎在 2017 年至 2021 年期间负责字节跳动的 AI Lab 视觉工作，这使得 PixVerse 成为其前雇主构建的 Seedance 的直接竞争对手。联合创始人谢家永来自 Lighthouse Capital。

对于一家独立的视频模型公司来说，融资情况异常强劲。2026 年 7 月 13 日，该公司完成了 C 轮扩展，使该轮融资总额达到 4.39 亿美元，估值超过 20 亿美元，阿里巴巴参与其中，根据 TechCrunch 报道。对开发者而言，这意味着有足够的资金储备：你本季度集成的 API 不太可能在明年消失。

资金充裕的实验室的另一面是发布速度。仅 2026 年的发布线：

三个月内三次模型发布，解释了本文一直指出的文档滞后问题。请据此构建：锁定你的模型字符串，在升级前阅读发布说明，并重新检查端点参考，而不是假设上一季度的参数仍然存在。

常见问题

官方 PixVerse API 文档在哪里？

位于 docs.platform.pixverse.ai，开发者控制台位于 platform.pixverse.ai。任何托管在 app.pixverse.ai 上的内容都是消费者产品，而第三方“PixVerse API 文档”页面经常描述 v4 时代的参数。文档还包括一个可供编码助手使用的 LLM 就绪文本页面。

如何获取 PixVerse API 密钥？

在平台控制台 platform.pixverse.ai 注册，创建密钥，并在 API-KEY 标头中传递，同时每个请求需携带唯一的 Ai-trace-id UUID。密钥与平台积分绑定，积分与任何消费者应用订阅分开购买。在 Atlas Cloud 上，等效的是控制台密钥，作为标准 Bearer 令牌传递。

PixVerse API 有免费层级吗？

平台定价文档仅列出付费积分包和会员。PixVerse 宣传的每日不定量免费积分属于消费者应用，不会流入 API 账本。最便宜的付费入口是官方平台上的 $10 积分包，或 Atlas Cloud 上从 $0.025/秒起的按秒计费。

PixVerse API 可以运行哪些模型？

当前生成端点接受八个模型值：v3.5、v4、v4.5、v5、v5.5、v5.6、v6 和 c1。V6 和 C1 是当前一代，支持 1 到 15 秒片段和可选原生音频。旧名称仍然有效，但在相同设置下比 V6 消耗更多积分。V2 代已不再通过第一方提供。

PixVerse AI API 每个视频多少钱？

官方平台：一个 5 秒 720p 带音频的 V6 片段需要 60 积分，在 $10 积分包费率下约为 $0.60。Atlas Cloud：相同片段按秒计费为 $0.30，每秒范围从 $0.025 到 $0.115，取决于分辨率和音频。C1 略高，该片段为 $0.325。价格于 2026 年 7 月 23 日验证。

结论

PixVerse API 的状况比其文档要好。服务本身快速、资金充足且与时俱进：八个模型值、最长 15 秒片段、同一次传递中支持音频，以及任何初级开发者都能在一下午连接起来的异步流程。只是文档没有跟上发布日历的步伐，因此端点参考和 How-to 指南描述了不同的产品。

有效的方法很简单。信任端点参考，当页面不一致时以更严格的限制为准，并锁定你的模型字符串。然后选择你的计费方式：如果团队已经使用官方平台则选择积分，或者如果你希望在发送前就能读取每个渲染的价格，则选择从 $0.025/秒起的按秒计费。Playground 中默认的 $0.30 片段是一个低廉的起点，可以让你弄清楚自己属于哪一边。