前言¶
在 IDE 或對話式 Agent 裏做視頻，常見做法是單獨打開控制台、手寫 HTTP 請求或切到第三方網頁，提示詞、參考圖和參數很難和當前任務上下文連在一起。若希望 Agent 在對話中直接發起文生視頻、圖生視頻，並把結果以可下載 URL 返回，需要一份約定好的 Skill 說明書，而不是零散的 API 文檔。
下面介紹 SkillHub 社區技能 veo 3.1（座標 @user_f95f21b8/dlazy-veo-3-1）：它把 Google Veo 3.1 的生成能力封裝進通用 SKILL.md 格式，通過 dLazy CLI 調用託管 API，適合已具備 API Key、希望在 Cursor 等客戶端裏用自然語言驅動視頻生成的開發者。
這是什麼¶
veo 3.1 的定位是：使用 Google Veo 3.1 生成高質量、偏電影特效風格的視頻，支持文生視頻與圖生視頻（Skill 中文說明中的表述）。
- 發佈渠道：SkillHub，來源標記爲
community，發佈者賬號爲user_f95f21b8，當前版本 1.0.9，分類 design-media。 - 運行時依賴：Skill 元數據要求本機具備
npm/npx，並安裝或按需調用 @dlazy/cli@1.0.9；CLI 維護方爲 dlazyai，源碼見 github.com/dlazyai/cli。 - 鑑權：SkillHub 標籤
requires_api_key=true；實際請求使用 dLazy API Key，經dlazy auth set寫入~/.dlazy/config.json，或通過環境變量DLAZY_API_KEY傳入。
Skill 本身是 dLazy 託管 API（api.dlazy.com、files.dlazy.com）的薄封裝：提示詞與參數發往 API，本地圖片路徑由 CLI 上傳至媒體存儲，生成結果以 URL 形式返回。
核心功能¶
以下能力均來自 Skill 自帶的 SKILL.md / SKILL-cn.md，未在文檔中出現的能力不寫。
- 文本驅動生成：通過
--prompt提交提示詞（必填）。 - 兩種生成模式（
--generation_mode，默認frames）：
-frames：首幀 / 尾幀圖生視頻（--firstFrame、--lastFrame）。
-components：最多 3 張參考圖（--images）。 - 畫幅與清晰度：
--size支持16:9、9:16；--resolution支持720P、1080P、4K。 - 調試與異步：
--dry-run可打印請求體與費用估算而不真正調用；--no-wait立即返回generateId，可用dlazy status <generateId> --wait輪詢；--timeout默認最長等待 1800 秒。 - Agent 側約定：觸發詞包括
veo 3.1、generate video、文生視頻 / 圖生視頻等；執行結果以 JSON 信封返回（tool: "veo-3.1"，modelId: "veo_3_1"）。
SkillHub 頁面統計（以抓取資料爲準）：評分 100000，下載 1058 次，安裝計數 0（平臺展示字段，不代表本地是否已裝）。
安裝與啓用¶
安裝分兩層：先把 Skill 裝進 Agent 的 skills 目錄，再準備 dLazy CLI 與 API Key。
1. 安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 官方說明執行完整安裝或僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 將 veo 3.1 安裝到當前 Agent 的 skills 目錄¶
SkillHub 頁面給出的安裝提示爲：依據 skillhub.cn/install/skillhub.md，安裝座標 @user_f95f21b8/dlazy-veo-3-1。命令行示例：
skillhub install @user_f95f21b8/dlazy-veo-3-1 --dir <你的 Agent skills 目錄>
常用路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
--dir 必須指向當前客戶端實際識別的目錄，否則 Skill 不會被加載。
也可把下面提示詞發給支持 Skill 的 AI，由其按官方安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_f95f21b8/dlazy-veo-3-1`。
3. 安裝 dLazy CLI 並配置 Key¶
全局安裝（與 Skill 元數據 pinned 版本一致）：
npm install -g @dlazy/cli@1.0.9
或按需調用、不持久化全局包：
npx @dlazy/cli@1.0.9 <command>
配置 API Key（在 dlazy.com/dashboard/organization/api-key 獲取）：
dlazy auth set YOUR_API_KEY
經過上面的步驟，Agent 讀取 Skill 後應執行 dlazy veo-3.1 完成實際生成；OpenClaw 類客戶端的系統提示亦指向 dlazy veo-3.1 -h 查看幫助。
典型用法¶
先看完整參數（Agent 應按 Skill 要求執行）：
dlazy veo-3.1 -h
Skill 文檔中的示例（保留原文參數名；完整選項列表以 -h 爲準）：
# 基礎調用
dlazy veo-3.1 --prompt '提示詞內容' --image '/path/to/image.png'
# 使用遠程圖片 URL
dlazy veo-3.1 --prompt '提示詞內容' --image 'https://files.dlazy.com/image.png'
純文生視頻時，至少提供 --prompt；圖生視頻需按 generation_mode 選擇 frames（首尾幀）或 components（多張 --images）。提交前可用 --dry-run 覈對載荷與預估費用。
成功時返回結構類似：
{
"ok": true,
"result": {
"tool": "veo-3.1",
"modelId": "veo_3_1",
"outputs": [
{
"type": "image",
"id": "o_xxxxxxxx",
"url": "https://files.dlazy.com/result.png",
"mimeType": "image/png"
}
]
}
}
（示例 JSON 摘自 Skill 文檔；實際 type / mimeType 以 API 返回爲準。）
適用場景與注意¶
適合誰
- 已在 dLazy 開通賬號、願意用 API Key 按量計費的使用者。
- 希望在 Cursor、Claude Code、Codex 等環境中，用對話觸發 Veo 3.1 文生視頻 / 圖生視頻，而不是每次手寫 curl 的團隊。
限制與注意
- 網絡與合規：請求發往 dLazy 雲端，本地媒體會上傳至
files.dlazy.com；需接受其服務條款與內容安全策略（失敗時後端可能返回如 Prompt violates safety policy 等信息）。 - 餘額：
code: "insufficient_balance"表示積分不足，需在 dlazy.com 充值頁 處理。 - 鑑權失敗：
unauthorized時需檢查 Key 是否已通過dlazy auth set或DLAZY_API_KEY配置。 - 版本綁定：Skill 1.0.9 與 CLI 1.0.9 配套；升級任一側前建議對照 SkillHub 上的新版本說明。
結尾¶
veo 3.1 把 Google Veo 3.1 的生成流程收斂成 Agent 可讀的 Skill 加 dlazy veo-3.1 命令：安裝座標、配置 dLazy Key、在對話裏描述畫面即可發起任務。官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-veo-3-1
- API 座標鏈接：https://api.skillhub.cn/user_f95f21b8/dlazy-veo-3-1
更多 CLI 與計費說明見 dlazy.com。
