Kandinsky 6.0 Pro 图生视频 API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 | kandinsky-6.0-pro/image-to-video |
|---|---|
| 能力 | 首帧图生视频 + 同步音频 |
| 分辨率 | 480p（16:9 实际 864×480） |
| 时长 | 固定 5 秒 |
以一张首帧图生成 5 秒、480p、带同步音频的视频，可自动匹配画幅，按条计费。
生产建议
调用建议
- 首帧图决定主体与构图，prompt 只写要加入的运动、镜头和声音。
- aspect_ratio=auto 会按图片选择最接近的支持画幅并居中裁切；需要精确控制时显式指定 16:9、9:16、1:1、4:3 或 3:4。
- 图片用 JPG、PNG 或 WebP，保持公开可访问；上传后请使用返回的 URL。
- 使用 callback.url 接收任务通知；产物 URL 有有效期，长期保存请转存。
适用场景
商品图动起来
用已有产品图作为首帧，加入环绕、推镜和音效，主体外形保持不变。
image_urlprompt海报与插画动画化
把平面海报或插画变成 5 秒动态素材。
image_urlaspect_ratio真实场景补运动
给风光、街景或建筑照片加入雨、雾、人流等运动。
promptseed请求参数
model string 必填 模型 ID。
input object 必填 图生视频参数。
prompt string 必填 描述要加入的运动、镜头和声音，不必重复画面内容。最多 6,000 字符，英文或俄文效果最稳。
image_url string 必填 作为视频首帧的图片，支持 JPG、PNG、WebP。aspect_ratio=auto 时会选择最接近的支持画幅并居中裁切。
negative_prompt string 可选 不希望出现在视频里的内容或瑕疵，最多 2,000 字符。
aspect_ratio enum 可选 输出画幅。auto 会按首帧图片选择最接近的支持画幅并居中裁切；其余取值与文生视频一致。
seed integer 可选 随机种子，用于尽量复现同一结果。省略时随机生成。
guidance_scale number 可选 提示词遵循强度，1-10 之间的数值，默认 5；数值越高越贴近文字描述。
callback object 可选 任务完成或失败后发送通知；查询响应从 data 读取任务对象，回调正文直接读取任务对象。
url string 必填 接收任务完成或失败通知的 HTTPS 地址。
when enum 可选 任务完成或失败时触发。
用例示例
雨夜电话亭
首帧图为 16:9 街景，auto 画幅，固定 5 秒、480p、带同步音频。
请求体
{
"model": "kandinsky-6.0-pro/image-to-video",
"input": {
"prompt": "Rain intensifies on the empty street, neon reflections ripple in the puddles, steam rises from a grate beside the booth, the camera slowly pushes in, steady rain and distant traffic",
"image_url": "https://your-domain.com/first-frame.jpg",
"aspect_ratio": "auto"
}
}竖屏人像补运动
竖屏首帧配 9:16 输出，适合短视频。
请求体
{
"model": "kandinsky-6.0-pro/image-to-video",
"input": {
"prompt": "The subject turns slightly toward the window, hair moves in the breeze, soft city ambience",
"image_url": "https://your-domain.com/portrait.jpg",
"aspect_ratio": "9:16"
}
}获取结果
- 创建任务响应从 data.taskId 读取任务 ID。
- 等待 callback，或调用 GET /v1/tasks/:id 查询状态；轮询响应从 data 读取任务对象。
- status=success 时，从 output 中读取 type=video 的视频 URL；callback body 直接读取 output。
常见问题
首帧图有什么要求？
支持 JPG、PNG、WebP，需为可公开访问的图片 URL。图片决定主体和构图，输出画幅由 aspect_ratio 决定。
auto 画幅会怎么处理图片？
会选择最接近图片比例的支持画幅，并把图片居中裁切到该画幅。需要不裁切时，请先把图片处理成目标比例。
提示词要写什么？
只写要加入的运动、镜头和声音，不必重复图片里已有的内容。英文和俄文为原生支持。
能生成多长的视频？
固定 5 秒、480p；时长、分辨率、推理步数和超分都不开放参数。
可以只传图片不写提示词吗？
不可以。prompt 为必填，用来指定运动、镜头和声音。
可以复现同一个结果吗？
传入相同的图片、seed 和参数可以尽量复现；不同请求之间仍可能有细微差异。
怎么计费？
按条计费，每次成功生成计一档固定价格，具体金额以价格页为准。
结果链接会过期吗？
会。请及时下载或转存到自己的存储。