The guitarist by the campfire strums a slow chord progression, sparks rising into the night sky, firelight flickering across the guitar body and the surrounding pines. Natural sound: fingerpicked acoustic guitar, crackling fire, crickets. Realistic motion, no text, no logos.
Veo 3.1 Lite Official Image-to-Video API
google/veo3.1-lite/image-to-videoVeo 3.1 Lite Official 是超高性价比的极速图生视频探索原型:以单张首帧唤醒画面,或以双图首尾帧快速打样过渡。保留运镜控制与可选原生音频,720p/1080p 极低按秒费率,让你在投入 Fast/Quality 成片前,用最小成本锁定最佳动势路径。
请先上传首帧图片,再添加用于引导结束画面的可选尾帧。
生成的视频会显示在这里
填写提示词并添加所需素材,确认设置后点击“运行”。
示例
REST API
快速开始
完成 API 认证,提交素材与生成指令,再通过任务 ID 获取视频结果。
连接 Vidgo API
创建 API Key,仅保存在服务端,并发送 Authorization: Bearer VIDGO_API_KEY。
- 接口
- POST
https://api.vidgo.ai/api/generate/submit - 认证
- Authorization: Bearer VIDGO_API_KEY
提交一次生成任务
按请求示例填写当前端点的素材与设置,提交后保存 task_id,用于后续查询生成进度和结果。
REQUEST_BODY=$(cat <<'JSON'
{
"model": "google/veo3.1-lite/image-to-video",
"input": {
"prompt": "The guitarist by the campfire strums a slow chord progression, sparks rising into the night sky, firelight flickering across the guitar body and the surrounding pines. Natural sound: fingerpicked acoustic guitar, crackling fire, crickets. Realistic motion, no text, no logos.",
"duration": 8,
"aspect_ratio": "16:9",
"sound": true,
"resolution": "720p",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/google/veo-3.1-lite-official/image-to-video/v1/01/input-start-frame.png"
]
}
}
JSON
)
RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
CODE=$(printf '%s' "$RESPONSE" | jq -r '.code // empty')
if [ "$CODE" != "0" ] && [ "$CODE" != "200" ]; then
printf 'API error: %s
' "$RESPONSE" >&2
exit 1
fi
printf '%s
' "$RESPONSE"等待结果
用 task_id 查询,not_started/running 继续,finished/failed 停止。成功后读取 data.files[].file_url。
查询状态
GET https://api.vidgo.ai/api/generate/status/{task_id}以 2 秒为基准间隔轮询状态,长时间任务可适当拉长间隔。仅在 not_started 或 running 时继续,遇到 finished 或 failed 立即停止。也可以在同一请求中配置 callback_url 接收回调通知。
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "task-unified-...",
"status": "running",
"created_time": "2026-09-17T10:00:00Z"
}
}{
"code": 200,
"data": {
"task_id": "task-unified-...",
"status": "finished",
"files": [
{
"file_url": "https://storage.vidgo.ai/generated/video.mp4",
"file_type": "video"
}
],
"created_time": "2026-08-22T10:00:00Z",
"progress": 100,
"error_message": null
}
}完整可运行示例
展开后可查看包含 HTTP 与业务码检查、task_id 校验、轮询、终态处理和超时边界的完整脚本。
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "google/veo3.1-lite/image-to-video",
"input": {
"prompt": "The guitarist by the campfire strums a slow chord progression, sparks rising into the night sky, firelight flickering across the guitar body and the surrounding pines. Natural sound: fingerpicked acoustic guitar, crackling fire, crickets. Realistic motion, no text, no logos.",
"duration": 8,
"aspect_ratio": "16:9",
"sound": true,
"resolution": "720p",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/google/veo-3.1-lite-official/image-to-video/v1/01/input-start-frame.png"
]
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
BUSINESS_CODE=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
printf 'Submit failed:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
START_TIME=$(date +%s)
POLL_DELAY=2
while true; do
if [ $(( $(date +%s) - START_TIME )) -ge 600 ]; then
printf 'Timed out after 600 seconds
' >&2
exit 1
fi
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
BUSINESS_CODE=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
printf 'Status request failed:
%s
' "$STATUS_RESPONSE" >&2
exit 1
fi
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep "$POLL_DELAY"
if [ "$POLL_DELAY" -lt 10 ]; then POLL_DELAY=$((POLL_DELAY + 1)); fi
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
doneinput 参数
下表列出 input 对象的可用参数、类型与默认值;请求示例同时展示顶层必填字段 model。按当前任务准备素材并配置输出。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| prompt | string | 是 | — | 去除首尾空格后为 1–1,000 个字符。 |
| image_urls | array | 是 | — | 1 或 2 个公开图片 URL。传入两张图时会同时发送 generation_type 为 frame。 |
| generation_type | string | 否 | 双图时为 frame | 可省略。单图省略时不发送该字段;双图省略时默认 frame。显式传 frame 必须提供两张图片。 |
| duration | integer | 否 | 8 | 4、6 或 8,单位为秒。 |
| aspect_ratio | string | 否 | 16:9 | auto、16:9 或 9:16。 |
| resolution | string | 否 | 720p | 720p / 1080p。 |
| sound | boolean | 否 | true | true 生成原生音频;false 返回静音片段。 |
响应字段
提交成功后返回任务 ID;状态查询提供任务进度、输出文件,以及任务失败时的错误详情。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 业务结果码;成功响应使用 0 或 200。 |
| message | string | 可读说明或错误详情。 |
| data.task_id | string | 用于状态查询路径的任务 ID。 |
| data.status | string | not_started、running、finished 或 failed。 |
| data.created_time | string | 任务创建时间,date-time 格式。 |
| data.progress | integer | 任务进度,范围为 0–100;仅在响应包含此字段时提供。 |
| data.files[] | array | 成功任务的全部输出文件,按响应顺序返回。 |
| data.files[].file_url | string | 生成视频的公开 URL。 |
| data.files[].file_type | string | 文件类型,例如 video。 |
| data.error_message | string | null | 状态为 failed 时的失败详情。 |
任务生命周期
在 not_started 或 running 状态下继续查询;收到 finished 或 failed 后结束轮询,并分别处理输出文件或错误详情。
not_started任务已接受,等待开始。
running正在生成。继续使用同一 task_id 轮询。
finished生成成功。从 data.files[].file_url 读取视频地址。
failed生成失败。读取 data.error_message 并停止轮询。
轮询与错误
- 认证收到 401 时,检查 Authorization 中的 Bearer API Key,更新凭据后重试。
- 校验收到 400 时,依据响应说明核对必填素材、参数取值与可用积分,完成相应调整后重新提交。
- 网络与超时状态查询遇到网络错误或超时时,保留原 task_id 并重试查询,再根据返回的任务状态处理结果。
- 轮询间隔以 2 秒为基准间隔发起状态查询;如任务耗时较长,可逐步增加查询间隔。
- 终态仅在 not_started 或 running 时继续。遇到 finished 或 failed 立即停止。
- 回调选项可在请求顶层提供 callback_url 接收终态任务对象;投递失败时仍可轮询。
模型规格
| 规格 | 取值 | 说明 |
|---|---|---|
| 输入模式 | 图片 + 文本 | 必须提供首帧图片;可选尾帧用于首尾帧控制。 |
| 输出 | 可选原生音频的视频 | 提交后返回异步任务 ID;完成后包含视频文件。 |
| 分辨率 | 720p / 1080p | 默认 720p。 |
| 时长 | 4 / 6 / 8 秒 | 默认 8 秒。 |
| 画面比例 | auto / 16:9 / 9:16 | 默认 16:9。 |
| 计费依据 | 按秒计费 | 720p 无音频 3.6 积分/秒; 带音频 6 积分/秒. 1080p 无音频 6 积分/秒; 带音频 9.6 积分/秒, 仅支持 8 秒. |
Veo 3.1 Lite Official Image-to-Video
Google Veo 3.1 Lite Official 图生视频端点专为视觉资产的低成本动态探索打造。以首帧启动镜头,或用首尾双帧验证过渡可行性,结合文本指令快速试跑运镜与可选声场,将产品图与概念原画批量转化为 4–8 秒动势草稿——提示词与关键帧打样的最佳第一站。
为什么选择此端点?
首帧动势极速打样继承输入图片的构图与光影,以极低成本快速验证第一秒运动是否成立,适合大批量素材筛选。
首尾帧过渡草稿验证用双图关键帧低成本试跑姿态与环境变迁,确认过渡节奏可行后再升级更高档位精渲染。
超高性价比探索吞吐系列最低按秒费率支撑并行试错,让电商主图动效、角色唤醒与转场方案都能大规模沙盘推演。
可选原生音频预览按需开启动作对齐的环境声预览;探索阶段也可关闭音频,把预算留给更多动势变体。
720p / 1080p 高效梯队专注高清探索分辨率,避免过早消耗 4K 预算;锁定动势后再切 Fast/Quality 做超清终版。
极低门槛的按秒计费支持精确时长与独立音频开关,让每一次首尾帧试跑的积分消耗清晰可见、随时可优化。
参数
| 参数 | 要求 | 说明 |
|---|---|---|
| prompt | 必填 | 字符串。描述场景、动作、运镜、光线和声音;去除首尾空格后为 1–1,000 个字符。 |
| image_urls | 必填 | 包含 1–2 个公开 URL 的字符串数组。第一张是首帧,可选第二张是尾帧,传入两张图时会发送 generation_type 为 frame。JPEG、PNG 或 WebP,每张最大 10 MB。 |
| generation_type | 可选 | 可省略。单图省略时不发送该字段;双图省略时默认 frame。显式传 frame 必须提供两张图片。 |
| duration | 可选 | 整数。设置输出时长;体验区默认预选 8 秒。Lite 的 1080p 仅支持 8 秒。Lite 首尾帧任务也仅支持 8 秒。 默认 846 |
| aspect_ratio | 可选 | 字符串。控制画面比例;体验区默认预选 16:9。图生视频还可使用 auto。 默认 16:9auto9:16 |
| resolution | 可选 | 字符串。设置输出分辨率;体验区默认预选 720p。 默认 720p1080p |
| sound | 可选 | 布尔值。是否生成原生音频;体验区默认预选 true。 默认 truefalse |
如何使用
上传清晰首帧图片选取主体鲜明、光影层次清晰的图片作为开场基准(JPEG/PNG/WebP,最大 10MB),为动势打样确立视觉起点。
选配尾帧做过渡草稿如需验证终点姿态或构图变迁,添加可选尾帧;双图模式会自动进入首尾帧演变,适合低成本过渡试跑。
用提示词指导动势与运镜描述从起始画面的动态演变,例如“人物从静止状态缓缓转身走向落地窗,摄影机平稳跟随推近”。探索阶段可暂缓复杂声效。
配置画幅、时长与音频可用 auto 继承原图比例,或指定 16:9 / 9:16;优先 720p + 关闭音频做大批量试错(Lite 1080p 与首尾帧任务仅支持 8 秒)。
确认预估并筛选升级查看按秒积分预估后批量运行,筛选最佳动势与过渡方案,再升级至 Fast 或 Quality 完成带音频的高清/超清交付。
价格
Veo 3.1 Lite Official 按生成秒数计费。最终费用 = 时长 × 所选每秒费率。美元换算采用当前基础 API 计费:2,000 积分 = $10。示例:Lite 8 秒 720p 带音频任务为 8 × 6 = 48 积分,按基础 API 积分汇率约 $0.24。
| 用量 | 费率 | 说明 |
|---|---|---|
| 720p,无音频 | 3.6 积分/秒($0.018/秒) | 8 秒 = 28.8 积分($0.144)。 |
| 720p,带音频 | 6 积分/秒($0.03/秒) | 默认 720p / 8 秒带音频为 48 积分($0.24)。 |
| 1080p,无音频(仅 8 秒) | 6 积分/秒($0.03/秒) | Lite 的 1080p 仅支持 8 秒。 |
| 1080p,带音频(仅 8 秒) | 9.6 积分/秒($0.048/秒) | Lite 的 1080p 仅支持 8 秒。 |
适用场景
电商主图动效大批量打样用极低成本验证产品图的环绕、微距与光影流动是否成立,筛选胜出方案后再升级量产渲染。
角色与概念原画唤醒试错为立绘与设定图并行试跑多种肢体节奏与呼吸动势,快速找到最自然的唤醒方式。
首尾帧转场方案沙盘低成本对比多种关键帧过渡路径与摄影机漂移,锁定可行节奏后再投入更高档位精修。
阶梯工作流的图生入口作为 Lite → Fast → Quality 管线的图生第一站:确认主体一致性与过渡可行性后,再升级终版交付。
专业建议
- 尊重首帧既有物理逻辑:提示词应基于首帧已有的主体形态、光影朝向与空间纵深展开,避免在探索阶段提出违背原图结构的突兀指令。
- 首尾帧提示词聚焦中间过程:双图模式下重点描述“如何从 A 到 B”,明确动作路径、摄影机漂移与过渡节奏,便于并行对比多套方案。
- 用 auto 画幅保持构图完整:探索阶段将 aspect_ratio 设为 auto,避免裁剪干扰对动势本身的判断。
- 先无音频、后补声音:大批量打样时关闭 sound;锁定动势后再开启原生音频验证声画对齐。
- 阶梯升级不回头浪费:在 Lite 上把首尾帧与提示词打磨到可复用后,再迁移到 Fast/Quality,避免在高费率档位反复试错。
使用说明
- Veo 3.1 Lite Official Image-to-Video 使用必填文本提示词生成视频,并可通过时长、分辨率、画面比例和音频设置配置输出。
- 提示词上限为 1,000 个字符。时长支持 4、6 或 8 秒。
- 通过 sound 参数请求带音频或静音输出。带音频与无音频任务使用不同的按秒费率。
- Lite Official 仅支持 720p 和 1080p。Lite 的 1080p 仅支持 8 秒。
- 图生视频可传入一张首帧,或两张图做首尾帧控制。
- 通过 API 提交后保存 task_id,用于查询任务进度和获取生成结果。
相关模型
Veo 3.1 Lite Official Image-to-Video API 常见问题
Veo 3.1 Lite Official Image-to-Video API 是什么?
Veo 3.1 Lite Official Image-to-Video 是 Google Veo 3.1 系列中超高性价比的极速图生视频探索档位。它能以单张静态图片作为首帧打样动势,或通过两张图片低成本验证首尾关键帧过渡,支持 720p/1080p 与可选原生音效,专为大批量素材筛选与关键帧草稿设计。可通过 Vidgo API 程序化调用,或在上方工作区直接体验。
在 API 请求中应使用哪个 model 标识?
在提交请求的 model 字段中请填入 google/veo3.1-lite/image-to-video。如需使用 Fast 或 Quality 变体,请分别填入 google/veo3.1-fast/image-to-video 或 google/veo3.1/image-to-video。请勿使用包含 -official 的页面路径作为模型 ID。
图生视频支持传入几张图片?工作模式有何区别?
支持传入 1 张或 2 张图片:传入 1 张图片时为首帧启动模式,用于快速验证开场动势;传入 2 张图片时为首尾帧模式,系统会自动发送 generation_type: "frame",适合低成本过渡打样(Lite 双图任务仅支持 8 秒)。
Lite 图生视频如何使用原生音频最划算?
Lite 支持 sound: true 生成动作对齐的原生音轨。建议在大批量动势/关帧试错时先关闭音频;锁定过渡方案后再开启音频做声画预览,确认无误后升级到 Fast/Quality 成片。
画幅比例选择 auto 对探索有什么帮助?
选择 auto 可自适应原图比例,避免裁剪干扰你对动势与过渡本身的判断;当需要面向特定渠道评审时,再主动指定 16:9 或 9:16。
什么时候该选 Lite、Fast 或 Quality?
需要低成本、超高速验证动画可行性与关帧过渡时选 Lite;需要兼顾出片效率、主流画质与 4K 支持时选 Fast;需要最高画质保真度与旗舰成片交付时选用 Quality。Lite 是图生阶梯工作流最高效的第一站。
Lite 的分辨率与时长有哪些实用注意点?
Lite 支持 720p 与 1080p,不支持 4K;其中 1080p 以及首尾帧(双图)任务仅支持 8 秒。探索阶段优先 720p,需要更清晰内部评审画面时再切 1080p。
对上传的图片素材有什么要求?
支持 JPEG、PNG 和 WebP 格式,每张图片大小不超过 10 MB。建议上传主体轮廓清晰、光影分明的图像,以便模型更稳定地提取结构与深度,提升打样成功率。