任务式生成
使用 request id 和任务状态，在你自己的应用界面管理长耗时视频输出。
视频生成 API
支持文生视频和图生视频的视频生成 API
通过 Pixapi 接入 Veo、Wan 等视频生成模型，并获得 API 密钥、额度追踪、任务状态和面向生产团队的文档。
文生视频图生视频任务式响应
视频生成请求
在后端提交视频任务，并轮询或追踪完成状态。
curl https://api.pixapi.ai/v1/async/videos/generations \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "veo",
"prompt": "A cinematic reveal of a smart speaker",
"duration": 5,
"size": "1280x720"
}'直接答案：Pixapi 视频生成只支持异步任务
Pixapi 视频生成必须使用 POST /v1/async/videos/generations 提交任务；新接入不应使用 /v1/videos/generations。
视频请求使用 Bearer 认证，传入 veo 或 wan 等视频模型、prompt、duration，并可用 input_image 实现图生视频。
Pixapi 会立即返回 task id；后端轮询 GET /v1/tasks/{id}，直到任务 completed 或 failed，再从 result.data[0].url 读取视频 URL。
视频 API 需要工作流控制
视频模型比图片生成更慢且成本更高，因此 API 层需要任务追踪、额度记录和清晰错误处理。
文本和图片提示
同时搭建文生视频和图生视频流程，并保持认证和计费一致。
模型目录指导
在选择路线前对比视频模型能力、价格提示和常见场景。
额度可见性
跨用户、套餐和产品功能预估并监控视频生成消耗。
生产重试
用一致错误模式处理限流、临时模型失败和用户侧状态更新。
一个视觉 AI 账户
图片、编辑和视频共用同一个 Pixapi 账户，而不是拼接多个供应商。
视频 API 工作流
| 需求 | 推荐 Pixapi 路由 | 适合原因 |
|---|---|---|
| 提示词生成产品短片 | Veo 或 Wan 模型路由 | 按真实感、风格和额度成本选择。 |
| 图生视频动画 | 带参考图的视频路由 | 将生成图或上传图变成短视频。 |
| 异步用户流程 | 任务 id + 状态追踪 | 生成期间保持产品界面响应。 |
| 成本可控上线 | 额度套餐和价格页 | 开放视频能力前先预估需求。 |
如何评估视频生成 API
视频生成 API 与图片生成不同。视频生成 API 应该在上线前提供异步任务、状态查询、模型选择、时长控制和成本可见性。
实用的视频生成 API 首先要有任务管理。视频输出耗时更长、成本更高，通常需要进度状态，所以视频生成 API 应该立即返回任务 id，并允许后端轮询或追踪完成状态。Pixapi 围绕异步生成、任务状态和额度追踪设计视频生成 API。
模型选择是视频生成 API 的核心。不同团队需要真实运动、风格化短片、商品展示或图生视频动画。Pixapi 将视频生成 API 页面连接到 Veo、Wan 等模型路线，并把价格和文档放在决策附近。
视频生成 API 还需要成本控制，因为时长、质量、分辨率和模型档位都会影响消耗。Pixapi 在视频生成 API 周围提供额度可见性，让团队能预估上线成本、设置内部限制，并决定哪些用户可访问高成本视频工作流。
对开发者来说，视频生成 API 应该保持熟悉。将 Pixapi 调用留在服务端，用 model id 和 prompt 提交视频生成 API 请求，保存返回的 task id，再把任务状态映射到产品界面。这个模式让视频生成 API 支持预览、队列、通知和重试。
完整的视频生成 API 也应该支持图生视频。许多产品先生成图片，再将图片变成短视频。Pixapi 让团队在同一账户下组合图片生成 API 和视频生成 API，从而减少供应商决策，并保持额度报告一致。
当产品需要可重复的视频输出，而不只是一次性创意实验时，就应该选择视频生成 API。Pixapi 的视频生成 API 聚焦生产需求：异步任务、模型目录、额度价格、API 密钥和开发文档，适合 SaaS 工具、内容平台和创意自动化。
视频生成 API 常见问题
视频生成和图片生成有什么不同？
视频生成通常以任务形式运行，因为耗时更长、成本更高。你的应用应保存任务 id 并展示进度。
当前有哪些视频模型？
Pixapi 在模型目录列出 Veo、Wan 等精选视频路线，具体可用性会随供应商更新变化。
可以从图片生成视频吗？
支持的路线可使用参考图完成图生视频，请以各模型页参数为准。
可以组合图片和视频 API 吗？
可以。常见流程是先生成图片，再把它作为参考图生成短视频。