NanoPhoto.AI文档Veo 3.1
通过 OpenClaw 使用 NanoPhoto.AI Veo 3.1 API 生成多镜头长视频。
通过 NanoPhoto.AI Veo 3.1 API 生成视频，支持最多 21 个镜头（168 秒）。
安装：npx clawhub@latest install veo-3-1
ClawHub：clawhub.ai/u/nanophotohq
前置条件
- 在 nanophoto.ai/settings/apikeys 获取 API Key
- 在 OpenClaw 技能设置中配置
NANOPHOTO_API_KEY
{
"skills": {
"entries": {
"veo-3-1": {
"enabled": true,
"env": {
"NANOPHOTO_API_KEY": "your_api_key_here"
}
}
}
}
}镜头规则
- 每次生成最多 21 个镜头
- 每个镜头 8 秒
- 最大总时长：168 秒
生成类型
| 类型 | 描述 | 图片 URL |
|---|---|---|
TEXT_2_VIDEO | 纯文本生成 | 无 |
FIRST_AND_LAST_FRAMES_2_VIDEO | 首末帧生成 | 1-2 个 URL |
REFERENCE_2_VIDEO | 参考图生成 | 1-3 个 URL |
参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
shots | array | 是 | 镜头对象数组 |
shots[].id | string | 是 | 镜头唯一标识 |
shots[].prompt | string | 是 | 镜头提示词 |
shots[].generationType | string | 是 | TEXT_2_VIDEO、FIRST_AND_LAST_FRAMES_2_VIDEO 或 REFERENCE_2_VIDEO |
shots[].aspectRatio | string | 是 | 16:9 或 9:16 |
shots[].imageUrls | string[] | 条件必填 | 帧/参考类型时必填 |
resolution | string | 否 | 720p（默认）、1080p、4k（1080p/4k 仅限单镜头） |
使用方法
单镜头文生视频
python3 scripts/veo_3_1.py submit \
--shots-json '[{"id":"shot-1","prompt":"一只金毛犬在日落海滩上奔跑","generationType":"TEXT_2_VIDEO","aspectRatio":"16:9"}]' \
--resolution 720p参考图镜头并自动轮询
python3 scripts/veo_3_1.py submit \
--shots-json '[{"id":"shot-1","prompt":"角色活了过来，穿行在森林中","generationType":"REFERENCE_2_VIDEO","aspectRatio":"16:9","imageUrls":["https://example.com/character.webp"]}]' \
--resolution 720p \
--follow查询状态
python3 scripts/veo_3_1.py status \
--task-ids-json '[{"shotId":"shot-1","taskId":"task_abc123"}]' \
--resolution 720p错误码
| 错误码 | 原因 | 处理方式 |
|---|---|---|
LOGIN_REQUIRED | API Key 无效 | 在 settings/apikeys 验证 |
INSUFFICIENT_CREDITS | 积分不足 | 充值积分 |
SHOTS_REQUIRED | 缺少镜头数组 | 构建有效的镜头数据 |
INVALID_IMAGE_COUNT | 图片数量不正确 | 修正 imageUrls |
GENERATION_FAILED | 服务器错误 | 重试或简化提示词 |