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

Veo 3.1 Fast Image to Video API

POST /v1/tasks

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

模型概览

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

Google Veo 3.1 Fast 图生视频 API，高速、高性价比的图片动画化，原生音频、最高 4K、支持 4 / 6 / 8 秒，适合批量内容生产与快速迭代。

生产建议

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

适用场景

批量图转视频

生成速度快、单价低，适合电商产品图、素材库静图的批量动画化。

image_urlprompt
成本敏感的内容生产

720p 无音低至入门价，量大场景先用 Fast 出片，重点素材再切 veo-3.1 旗舰档。

resolutiongenerate_audio
快速动效迭代

4 / 6 / 8 秒短片快速返回，适合动效方向验证与 A/B 试片。

duration
横竖屏与画幅跟随

aspect_ratio 默认 auto 跟随输入图，也可强制 16:9 / 9:16 适配投放位。

aspect_ratio

请求参数

model string 必填

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

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

业务参数对象；Veo 3.1 Fast 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-fast/image-to-video",
  "input": {
    "prompt": "热汤蒸汽升腾，筷子慢动作夹起晶亮的面条，居酒屋轻声细语与滋滋声",
    "image_url": "https://static.hiapi.ai/example/2026/07/02/1782991317440-de8da2297e385e22-veo-3-1-fast-image-to-video.webp",
    "resolution": "4k",
    "duration": 8,
    "generate_audio": true
  }
}
1080p 标准档出片

1080p / 8 秒含音，多数投放场景的性价比档位。

请求体
{
  "model": "veo-3.1-fast/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": "1080p",
    "duration": 8,
    "generate_audio": true
  }
}

获取结果

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

常见问题

Fast 和 veo-3.1 旗舰图生视频怎么选？

veo-3.1-fast 生成更快、单价更低，适合批量与迭代；veo-3.1 画质与音频更好，适合成片交付。两者参数相同，可随时切换。

对输入图有什么要求？

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

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

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

怎么拿到生成的视频？

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

下一步