视频生成接口
PinduCloud 提供豆包 Seedance、MiniMax-H3、Vidu Q3、Kling V3、Kling V3 Omni、 Wan3.0 和 Wan3.0 Prime 视频接口。不同模型的请求字段、任务状态和结果获取方式不同， 请按对应页面的接口说明调用。所有示例均使用 PinduCloud API Key。
标记为“本站拒绝”的参数会在任务提交前被 PinduCloud 拒绝。未列出的参数不属于本站 公开接口约定，不能据此认定受支持。
服务地址与鉴权
视频接口的公共地址为：
https://video.pinducloud.com.cn
所有请求使用 PinduCloud API Key：
export BASE_URL="https://video.pinducloud.com.cn"
export API_KEY="sk-your-pinducloud-token"
请求头：
Authorization: Bearer <PINDUCLOUD_API_KEY>
Content-Type: application/json
路由总览
| 能力 | 方法 | 路径 |
|---|---|---|
| Seedance 创建任务 | POST | /doubao/api/v3/contents/generations/tasks |
| Seedance 查询任务 | GET | /doubao/api/v3/contents/generations/tasks/:task_id |
| Seedance 查询列表 | GET | /doubao/api/v3/contents/generations/tasks |
| Seedance 取消或删除 | DELETE | /doubao/api/v3/contents/generations/tasks/:task_id |
| Seedance 素材组列表 / 创建普通组 | GET / POST | /v1/seedance/asset-groups |
| Seedance 上传媒体 | POST | /v1/seedance/assets/upload |
| Seedance 创建真人认证会话 | POST | /v1/seedance/validation-sessions |
| Seedance 查询真人认证结果 | GET | /v1/seedance/validation-sessions/:id |
| H3 创建视频 | POST | /hailuo/v2/video_generation |
| H3 视频再生成 | POST | /hailuo/v2/video_regeneration |
| H3 Context-IR | POST | /hailuo/v2/h3_context_ir |
| H3 查询任务 | GET | /hailuo/v2/query/video_generation/:task_id |
| H3 查询列表 | GET | /hailuo/v2/query/video_generation |
| H3 取消或删除 | DELETE | /hailuo/v2/video_generation/:task_id |
| Vidu 文生视频 | POST | /vidu/ent/v2/text2video |
| Vidu 图生视频 | POST | /vidu/ent/v2/img2video |
| Vidu 参考生视频 | POST | /vidu/ent/v2/reference2video |
| Vidu 首尾帧 | POST | /vidu/ent/v2/start-end2video |
| Vidu 智能多帧 | POST | /vidu/ent/v2/multiframe |
| Vidu 场景模板 | POST | /vidu/ent/v2/template |
| Vidu 模板成片 | POST | /vidu/ent/v2/template-story |
| Vidu 查询列表 | GET | /vidu/ent/v2/tasks |
| Vidu 查询任务 | GET | /v1/videos/:task_id |
| Vidu 下载视频 | GET | /v1/videos/:task_id/content |
| Kling 新版文生视频 | POST | /kling/text-to-video/:model |
| Kling 新版图生视频 | POST | /kling/image-to-video/:model |
| Kling 新版 Omni 生成 | POST | /kling/omni-video/:model |
| Kling 新版动作控制 | POST | /kling/motion-control/:model |
| Kling 新版任务列表 | GET | /kling/tasks |
| Kling 新版单任务查询 | GET | /v1/videos/:task_id |
| Kling 新版视频下载 | GET | /v1/videos/:task_id/content |
| Kling 原版文生视频 | POST | /kling/v1/videos/text2video |
| Kling 原版图生视频 | POST | /kling/v1/videos/image2video |
| Kling 原版动作控制 | POST | /kling/v1/videos/motion-control |
| Kling 原版 Omni 视频生成 | POST | /kling/v1/videos/omni-video |
| Kling 原版多图参考 | POST | /kling/v1/videos/multi-image2video |
| Kling 原版多元素编辑 | POST | /kling/v1/videos/multi-elements |
| Kling 原版视频延长 | POST | /kling/v1/videos/video-extend |
| Kling 原版对口型 | POST | /kling/v1/videos/advanced-lip-sync |
| Kling 原版数字人 | POST | /kling/v1/videos/avatar/image2video |
| Kling 原版音频与音色接口 | POST | /kling/v1/audio/*、/kling/v1/general/custom-voices |
| Kling 原版任务查询/列表 | GET | /kling/v1/{task_path}、/kling/v1/{task_path}/:task_id |
| Kling 原版多元素选择初始化/添加/删除/清空/预览 | POST | /kling/v1/videos/multi-elements/{init-selection,add-selection,delete-selection,clear-selection,preview-selection} |
| Kling 原版人脸识别、图像识别 | POST | /kling/v1/videos/identify-face、/kling/v1/videos/image-recognize |
| Kling 原版预置音色查询/删除音色 | GET / POST | /kling/v1/general/presets-voices、/kling/v1/general/delete-voices |
| Kling 原版主体创建、查询、删除与预置主体查询 | POST / GET | /kling/v1/general/advanced-custom-elements、/kling/v1/general/delete-elements、/kling/v1/general/advanced-presets-elements |
| Kling 原版视频特效 | POST | /kling/v1/videos/effects |
| Kling 下载视频 | GET | /v1/videos/:task_id/content |
| Wan 文生、图生、参考与编辑 | POST | /ali/api/v1/services/aigc/video-generation/video-synthesis |
| Wan 首尾帧、动作迁移与数字人 | POST | /ali/api/v1/services/aigc/image2video/video-synthesis |
| Wan 人脸检测 | POST | /ali/api/v1/services/aigc/image2video/face-detect |
| Wan 查询任务 | GET | /ali/api/v1/tasks/:task_id |
| Wan 下载视频 | GET | /v1/videos/:task_id/content |
请求路径均相对于本页所列的公共服务地址。
Seedance 的素材管理、真人认证与视频生成是不同步骤。完整流程见 私域素材库和真人认证与人像素材。 已有 OpenAI 客户端可使用 Seedance 兼容接口。 Vidu 接口说明见 Vidu 视频生成。 Kling 新版接口说明见 Kling 新版视频接口，原版接口见 Kling 原版视频接口。 万相接口说明见 Wan 视频生成。
统一任务流程
- 调用创建接口并保存响应中的
id或task_id。 - 使用创建响应中的公开任务 ID 调用对应查询接口。
- 按各接口规定的成功状态读取视频 URL 或文本结果。
- 在链接有效期内下载或转存视频；签名 URL 不作为永久存储地址。
任务状态字段和取值因接口而异，见对应模型页面。创建接口返回成功只表示任务已受理； 请使用对应查询接口确认任务完成，再获取视频结果。列表查询有分页和筛选条件，未出现在当前列表中不代表任务不存在。 查询不到任务时，先核对创建响应中的公开 ID、接口类型及 API Key 所属用户，不要重复创建任务。
示例与调用说明
示例中的 API Key、任务 ID、主体 ID、素材地址和响应内容均为示意，调用时须替换为真实值。
example.com 不是可直接使用的测试素材地址。curl 示例采用 Bash 语法；Windows 调用时应使用
curl.exe，并按所用终端调整引号和换行方式。响应代码块中的注释用于解释字段，不属于实际 JSON 响应。
模型在账号中可见，不代表该型号支持栏目中的全部功能。请按每个接口的型号、规格和素材要求组织请求。 创建和查询的响应结构因接口而异；原生可选字段可能缺失，不应按示例要求所有字段始终存在。
费用与失败处理
视频生成提交成功后会预扣额度，任务完成后按本站配置的模型价格及可用用量信息结算，可能产生退款或补扣。
视频任务失败后退还该任务预扣额度，具体金额和差额处理以使用日志为准。原生响应中的 usage、credits
或 final_unit_deduction 是用量或任务服务信息，不能直接当作本站扣费金额。
HTTP 请求成功不代表视频生成成功，仍需检查任务的最终状态。创建请求超时或返回不明确的错误时， 先检查已有任务和业务关联记录；避免直接重试创建请求而产生重复任务。查询请求可适当重试，建议间隔 5–15 秒。
接口类型
| 接口 | 请求形式 | 任务查询方式 |
|---|---|---|
| Seedance | 豆包原生任务接口；素材引用使用多模态 content | Seedance 任务查询、列表和删除路由 |
| MiniMax-H3 | Hailuo 视频生成、视频再生成和 Context-IR 接口 | H3 单任务、列表和删除路由 |
| Vidu | /vidu/ent/v2 路由；各任务类型使用独立创建接口 | /vidu/ent/v2/tasks 列表及 /v1/videos/{task_id} 单任务查询 |
| Kling 新版 | 操作类型和模型名位于请求路径 | /kling/tasks 查询列表，/v1/videos/{task_id} 查询单任务 |
| Kling 原版 | 各视频、音频和素材管理能力使用独立路径；模型名放在请求体中 | 任务型接口各自提供单任务查询和列表路径 |
| Wan | DashScope 风格的 model、input 和 parameters 请求体 | /ali/api/v1/tasks/{task_id} 查询任务 |