Runway Gen-4.5 Image-to-Video
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 ID | runway-gen-4.5/image-to-video |
|---|---|
| 类型 | 视频生成（图生视频） |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
由首帧驱动，固定 720p，时长可选 5、8 或 10 秒，支持横屏、竖屏、4:3、3:4 与方形画幅。
生产建议
生产环境建议
- 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
- GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
- callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。
适用场景
静图动画化
首帧驱动，让产品图、插画和摄影作品动起来。
image_urlsprompt多种画幅
横屏、竖屏、4:3、3:4 或方形，适配不同发布平台。
aspect_ratio5/8/10 秒时长
按需选择片段长度。
duration请求参数
model string 必填 固定填 runway-gen-4.5/image-to-video。
input object 必填 视频生成参数。
prompt string 必填 描述画面中的运动与镜头变化，最长 1000 字符。
image_urls string[] 必填 传入图片，用作视频的首帧，仅限 1 张；支持 jpeg/png/webp，不支持 svg，最大 10MB。
duration enum 可选 视频时长（秒），可选 5、8 或 10。
aspect_ratio enum 可选 生成视频的宽高比，例如横屏 16:9 或竖屏 9:16；首帧会按该比例居中裁切。
callback object 可选 可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。
url string 必填 传入 callback 时必填；接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；当前建议固定为 final。
用例示例
蒸汽机车（16:9，5 秒）
首帧驱动，镜头平稳跟拍。
请求体
{
"model": "runway-gen-4.5/image-to-video",
"input": {
"prompt": "The steam locomotive thunders forward across the stone bridge, white steam streaming back from the chimney, wheels turning, the camera tracks smoothly alongside in warm golden hour light",
"image_urls": [
"https://dev-static.hiapi.ai/gallery/2026/10/30fa8d9dc2f623dd.jpg"
],
"duration": 5,
"aspect_ratio": "16:9"
}
}获取结果
- 提交成功后立即返回 taskId（不等待生成完成）。
- 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
- status=success 后，从返回的 output[].url 下载生成的视频。
- 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。
常见问题
可以更改分辨率吗？
不可以，输出固定为 720p。
画幅与首帧比例不一致会怎样？
首帧会按 aspect_ratio 居中裁切，建议让主体位于图片中央附近。
只有文字，没有图片？
请使用 runway-gen-4.5/text-to-video。