Google

Veo 3.1 Lite

veo-3.1-lite/image-to-video

Google 低成本高吞吐视频生成档位，速度与 Veo 3.1 Fast 持平，支持图生视频、多种画幅与时长

veo-3.1-lite/image-to-video veo-3.1-lite/text-to-video

试用 veo-3.1-lite/image-to-video

输入

作品灵感

查看全部作品

输出

video

填写参数并生成，结果会显示在这里。

价格

veo-3.1-lite/image-to-video 每秒

规格	720P	1080P
Sound Off	$0.060	$0.100
Sound On	—	$0.140

定位简介

veo-3.1-lite/image-to-video 是 Google Veo 3.1 Lite 系列的图生视频模型，通过 HiAPI.ai 统一接口调用。它以一张输入图像为起点，结合提示词把静态画面转化为带原生音频的视频片段，输出支持 720p 与 1080p、16:9 与 9:16 画幅，时长可选 4、6、8 秒。适合需要把已有图像素材批量转成短视频的开发者，以及在成本敏感的产品中集成视频生成能力的团队。

核心亮点

以图为锚，画面起点可控——以输入图像作为生成条件，配合提示词描述运动方式，减少纯文本生成带来的画面漂移。
原生音频随视频一起生成——默认生成原生音频，可直接得到带声音的视频片段，省去单独的配音或音效合成环节。
画幅与时长按需组合——支持 16:9 与 9:16 两种画幅、720p 与 1080p 两档分辨率，时长可在 4、6、8 秒中选择。
生成过程可调可控——提供负向提示词、随机种子与安全容忍度参数，便于复现结果并约束输出内容。

能力说明

图像驱动的视频生成：传入图片地址与描述运动的提示词，即可生成对应视频；输入图像建议使用 720p 或更高分辨率，并采用 16:9 或 9:16 画幅。

分辨率与画幅选择：输出可选 720p 或 1080p，画幅支持 16:9、9:16 或由图像自动推断，可同时覆盖横屏内容与竖屏短视频的需求。

时长可控：单次生成时长可在 4、6、8 秒之间设置，默认 8 秒，按输出秒数计费，方便按片段长度控制开销。

音频开关：可开启或关闭原生音频生成，需要静音素材做后期配音时可直接关闭，减少不必要的处理。

输出约束与复现：通过负向提示词排除不希望出现的内容，用安全容忍度调节审核强度，并用固定种子复现同一生成结果。

适用场景

电商与广告团队：商品静态图转动态短片——将商品图转为数秒动态展示片段，用于详情页、信息流广告与社交媒体投放素材。
内容运营：竖屏短视频批量产出——以 9:16 画幅和 4 至 8 秒时长将图像素材转成短视频，用于短视频平台的日常内容更新。
产品团队：图像转视频功能集成——在产品内接入图生视频能力，让用户上传图片即可获得带音频的短视频片段。
创意验证：分镜草图快速预览——把分镜或概念图快速转成动态预览，用于方案评审与创意方向确认，再决定是否投入后续制作。

限制与选型建议

分辨率上限为 1080p、单次时长上限为 8 秒，不适合长视频或更高分辨率的成片需求；输入依赖一张 720p 以上的图像，纯文本起稿应改用同系列文生视频线路。生成结果受提示词与审核参数影响，需预留重试与筛选成本。若需要更长时长、更高分辨率或更强的画面一致性控制，应评估更高档位的视频模型。

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：veo-3.1-lite/image-to-video

routestring可选

当前固定值：default

inputobject必填

veo-3.1-lite/image-to-video 和线路 default 的业务参数对象，见下方参数表。

seedinteger可选

随机种子，取值整数，用于使生成结果可复现；相同种子在其他参数一致时可得到相同输出。

promptstring必填minLength 1

文本提示词，描述希望如何驱动输入图像产生动画，取值为字符串。

auto_fixboolean可选默认值: false

是否自动改写未通过校验的提示词，布尔值，默认 false。

durationinteger可选默认值: 8min 4max 8

生成视频片段时长，单位为秒，整数，默认 8。

可选项：468

image_urlstring必填

待动画化的输入图像 URL，字符串；建议使用 16:9 或 9:16 比例、分辨率不低于 720p 的图像。

resolutionstring可选默认值: "720p"

输出视频分辨率，字符串，默认 720p。

可选项：720p1080p

aspect_ratiostring可选默认值: "auto"

输出视频宽高比，字符串，默认 auto。

可选项：auto16:99:16

generate_audioboolean可选默认值: true

是否生成原生音频，布尔值，默认 true。

negative_promptstring可选

反向提示词，描述生成视频中需要避免出现的内容，取值为字符串。

safety_tolerancestring可选默认值: "4"

内容审核容忍度等级，字符串，默认 4。

可选项：123456

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3.1-lite/image-to-video",
  "input": {
    "prompt": "…",
    "auto_fix": false,
    "duration": 8,
    "image_url": "…",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true,
    "safety_tolerance": "4"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "veo-3.1-lite/image-to-video",
    input: {
      "prompt": "…",
      "auto_fix": false,
      "duration": 8,
      "image_url": "…",
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true,
      "safety_tolerance": "4"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "veo-3.1-lite/image-to-video",
        "input": {
          "prompt": "…",
          "auto_fix": False,
          "duration": 8,
          "image_url": "…",
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True,
          "safety_tolerance": "4"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}