跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Veo 3.1 Image to Video API

POST /v1/tasks

所有模型都通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 veo-3.1/image-to-video
类型 视频生成（图生视频）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Google Veo 3.1 图生视频 API，把一张静态图片动画化为电影级短片，原生音频、最高 4K、支持 4 / 6 / 8 秒，画幅可自动跟随输入图。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

产品图 / 海报动起来

把静态产品图、海报或摄影素材动画化为电影级短片，光影与画面内容保持一致。

image_urlprompt
带原生音频的氛围片

在画面动起来的同时生成环境音与音效，一次产出可直接投放的带声短片。

generate_audio
4K 高清交付

支持 720p / 1080p / 4K 输出，静态素材直接升级为高分辨率动态成片。

resolutionduration
画幅自动跟随输入图

aspect_ratio 默认 auto，输出自动匹配输入图画幅；也可强制 16:9 或 9:16。

aspect_ratio

请求参数

model string 必填

固定填 veo-3.1/image-to-video。

示例 veo-3.1/image-to-video
input object 必填

业务参数对象；Veo 3.1 Image to Video 的模型专属配置都放在这里。

prompt string 必填

描述图片应如何动起来的文本提示词。

image_url string 必填

要动画化的输入图片 URL。建议 720p 以上、16:9 或 9:16 画幅；其他画幅会被裁切适配。不支持 SVG。

aspect_ratio enum 可选

输出视频画幅比例；auto 跟随输入图。

默认 auto 可选值: auto16:99:16
resolution enum 必填

输出视频分辨率，分辨率越高单价越高。

默认 720p 可选值: 720p1080p4k
duration enum 必填

视频时长（秒），费用按时长计算。

默认 8 可选值: 468
generate_audio boolean 可选

是否生成原生音频音轨，开启后单价更高。

默认 true
negative_prompt string 可选

描述要在生成视频中避免出现的内容。

seed integer 可选

随机种子，用于复现相同结果。

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

风暴灯塔（4K 含音）

静态灯塔图动画化：巨浪、光束扫海与雷声，4K / 8 秒。

请求体
{
  "model": "veo-3.1/image-to-video",
  "input": {
    "prompt": "风暴加剧：巨浪慢动作拍向悬崖，灯塔光束扫过翻腾的海面，雷声与浪涛轰鸣",
    "image_url": "https://static.hiapi.ai/example/2026/07/02/1782991315981-ea706258e68806d3-veo-3-1-image-to-video.webp",
    "resolution": "4k",
    "duration": 8,
    "generate_audio": true
  }
}
低成本预览（720p 无音）

同一输入图 720p / 4 秒无音，先低成本验证动效再出 4K 成片。

请求体
{
  "model": "veo-3.1/image-to-video",
  "input": {
    "prompt": "海浪有节奏地拍打灯塔下的礁石，光束旋转，云层缓缓移动",
    "image_url": "https://static.hiapi.ai/example/2026/07/02/1782991315981-ea706258e68806d3-veo-3-1-image-to-video.webp",
    "resolution": "720p",
    "duration": 4,
    "generate_audio": false
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的视频。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

对输入图有什么要求？

建议 720p 以上分辨率、16:9 或 9:16 画幅；其他画幅会被裁切适配。image_url 需要是可公开访问的图片地址。不支持 SVG。

prompt 是必填的吗？

是。prompt 描述图片应如何动起来（运动、镜头、音效氛围），和 image_url 一起构成必填输入。

支持哪些分辨率和时长？价格怎么算？

分辨率 720p / 1080p / 4K，时长 4 / 6 / 8 秒。按分辨率、是否含音和时长（按秒）组合计费，与 veo-3.1 文生视频同价，实时价格见价格页。 查看价格

怎么拿到生成的视频？

提交后立即返回 taskId，任务进入终态后从 output[].url 下载视频。生产环境建议传 callback.url 收终态通知。

下一步