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 | 伺服器錯誤 | 重試或簡化提示詞 |