Kandinsky 6.0 Pro 文生视频 API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 | kandinsky-6.0-pro/text-to-video |
|---|---|
| 能力 | 文生视频 + 同步音频 |
| 分辨率 | 480p（16:9 实际 864×480） |
| 时长 | 固定 5 秒 |
用一段文字生成 5 秒、480p、带同步音频的视频，支持 5 种画幅，按条计费。
生产建议
调用建议
- 先把主体、动作、镜头和声音各写一句，5 秒镜头里只安排一件事。
- 横屏投放用 16:9，竖屏短视频用 9:16，方图与 4:3 / 3:4 适合信息流和封面。
- 需要锁定画面主体时改用 kandinsky-6.0-pro/image-to-video，先准备一张首帧图。
- 使用 callback.url 接收任务完成或失败通知；产物 URL 有有效期，长期保存请转存。
适用场景
广告与产品片头
一句话写出镜头运动、材质和音效，得到可直接剪辑的 5 秒片头。
promptaspect_ratio竖屏社媒内容
9:16 直出，适合短视频平台和品牌信息流。
aspect_ratio分镜与概念预演
用不同画幅和镜头描述快速验证节奏与构图。
promptseed请求参数
model string 必填 模型 ID。
input object 必填 文生视频参数。
prompt string 必填 描述主体、动作、镜头和声音。最多 6,000 字符，英文或俄文效果最稳。
negative_prompt string 可选 不希望出现在视频里的内容或瑕疵，最多 2,000 字符。
aspect_ratio enum 可选 输出画幅：16:9 横屏、9:16 竖屏、1:1 方形、4:3 与 3:4。
seed integer 可选 随机种子，用于尽量复现同一结果。省略时随机生成。
guidance_scale number 可选 提示词遵循强度，1-10 之间的数值，默认 5；数值越高越贴近文字描述。
callback object 可选 任务完成或失败后发送通知；查询响应从 data 读取任务对象，回调正文直接读取任务对象。
url string 必填 接收任务完成或失败通知的 HTTPS 地址。
when enum 可选 任务完成或失败时触发。
用例示例
横屏夜行列车
16:9 默认画幅，固定 5 秒、480p、带同步音频。
请求体
{
"model": "kandinsky-6.0-pro/text-to-video",
"input": {
"prompt": "A night train crosses a tall stone viaduct under a full moon, a plume of steam trailing into the valley, the camera cranes up from the river below, rhythmic wheels on the rails and a distant whistle",
"aspect_ratio": "16:9"
}
}竖屏产品镜头
9:16 竖屏，配合反向提示词控制画面。
请求体
{
"model": "kandinsky-6.0-pro/text-to-video",
"input": {
"prompt": "A ceramic pour-over coffee dripper on a dark counter, steam rising, camera slowly pushes in",
"aspect_ratio": "9:16",
"negative_prompt": "text, watermark, logo"
}
}获取结果
- 创建任务响应从 data.taskId 读取任务 ID。
- 等待 callback，或调用 GET /v1/tasks/:id 查询状态；轮询响应从 data 读取任务对象。
- status=success 时，从 output 中读取 type=video 的视频 URL；callback body 直接读取 output。
常见问题
支持多长的视频和哪些分辨率？
固定 5 秒、480p。时长、分辨率、推理步数和超分都不开放参数，价格也按这一档固定。
生成的声音可以关掉吗？
不可以。模型固定输出同步音频，画面与环境声、音效一起生成。
支持竖屏吗？
支持。aspect_ratio 设为 9:16 即竖屏，另有 1:1、4:3、3:4 可选。
实际输出尺寸是多少？
16:9 请求的实际成片为 864×480，帧率 24fps，容器为 MP4。
提示词用什么语言？
英文和俄文为原生支持；中文提示词建议先翻成英文再提交，效果更稳定。
可以复现同一个结果吗？
可以传入相同的 seed 和参数，尽量复现同一镜头；不同请求之间仍可能有细微差异。
怎么计费？
按条计费，每次成功生成计一档固定价格，具体金额以价格页为准。
结果链接会过期吗？
会。请及时下载或转存到自己的存储，长期使用不要依赖临时链接。