任务式生成
使用 request id 和任务状态，在你自己的应用界面管理长耗时视频输出。
视频生成 API
支持文生视频和图生视频的视频生成 API
通过 Pixapi 接入 Seedance、Kling、Wan、Grok Video、HappyHorse 等视频生成模型，并获得 API 密钥、额度追踪、任务状态和面向生产团队的文档。
文生视频图生视频任务式响应
视频生成请求
在后端提交视频任务，并轮询或追踪完成状态。
curl https://api.pixapi.ai/v1/async/videos/generations \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "veo3.1-fast",
"prompt": "A cinematic reveal of a smart speaker",
"seconds": 8,
"resolution": "720p"
}'直接答案：Pixapi 视频生成只支持异步任务
Pixapi 视频生成必须使用 POST /v1/async/videos/generations 提交任务；新接入不应使用 /v1/videos/generations。
视频请求使用 Bearer 认证，传入 veo3.1-fast、seedance-2、kling-3.0-turbo、wan2.6、grok-video-3、happyhorse-1.1 等视频模型，以及 prompt、seconds、resolution，并可用 image 实现图生视频。
Pixapi 会立即返回 task id；后端轮询 GET /v1/tasks/{id}，直到任务 completed 或 failed，再从 result.data[0].url 读取视频 URL。
视频 API 需要工作流控制
视频模型比图片生成更慢且成本更高，因此 API 层需要任务追踪、额度记录和清晰错误处理。
文本和图片提示
同时搭建文生视频和图生视频流程，并保持认证和计费一致。
模型目录指导
在选择路线前对比视频模型能力、价格提示和常见场景。
额度可见性
跨用户、套餐和产品功能预估并监控视频生成消耗。
生产重试
用一致错误模式处理限流、临时模型失败和用户侧状态更新。
一个视觉 AI 账户
图片、编辑和视频共用同一个 Pixapi 账户，而不是拼接多个供应商。
视频 API 工作流
| 需求 | 推荐 Pixapi 路由 | 适合原因 |
|---|---|---|
| 提示词生成产品短片 | Seedance / Kling / Wan / Grok Video / HappyHorse | 按真实感、风格和额度成本选择。 |
| 图生视频动画 | 带参考图的视频路由 | 将生成图或上传图变成短视频。 |
| 异步用户流程 | 任务 id + 状态追踪 | 生成期间保持产品界面响应。 |
| 成本可控上线 | 额度套餐和价格页 | 开放视频能力前先预估需求。 |
视频生成 API 常见问题
视频生成和图片生成有什么不同？
视频生成通常以任务形式运行，因为耗时更长、成本更高。你的应用应保存任务 id 并展示进度。
当前有哪些视频模型？
Pixapi 在模型目录列出 Seedance、Kling、Wan、Grok Video、HappyHorse 等精选视频路线，具体可用性会随供应商更新变化。
可以从图片生成视频吗？
支持的路线可使用参考图完成图生视频，请以各模型页参数为准。
可以组合图片和视频 API 吗？
可以。常见流程是先生成图片，再把它作为参考图生成短视频。