前言¶

在 Cursor、Claude Code 等環境裏做配圖，常見做法是手寫 HTTP 請求、自己管鑑權與上傳。Vidu Q2 的能力要接進對話流，還需要把參數、畫幅和結果 URL 整理成 Agent 能繼續用的格式。下面介紹 SkillHub 上的 viduq2 t2i（座標 @user_f95f21b8/dlazy-viduq2-t2i）：它把 dLazy CLI 的 viduq2-t2i 命令封裝成標準 SKILL.md，讓 Agent 按文檔調用雲端推理，而不是臨時拼腳本。

這是什麼¶

viduq2 t2i 是社區來源（source: community）、分類爲 design-media 的 Skill，當前版本 1.0.9。SkillHub 簡介寫明：使用 Vidu Q2 生成高質量圖像，支持 text-to-image 與 image-to-image（中文 SKILL 表述爲文生圖與圖生圖）。

技能本體由發佈者 user_f95f21b8 上架；實際推理通過 dlazyai 維護的 @dlazy/cli 訪問 dLazy 託管 API（api.dlazy.com、files.dlazy.com）。Skill 元數據要求本機具備 npm、npx，並標記 requires_api_key=true——使用前必須配置 dLazy API Key。

核心功能¶

依據 SKILL.md，可覈實的能力包括：

1. 文生圖 / 圖生圖：通過 dlazy viduq2-t2i 提交提示詞；可選最多 10 張參考圖（URL 或本地路徑，由 CLI 上傳至 files.dlazy.com）。
2. 畫幅與分辨率：--aspectRatio 支持 16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2，默認 9:16；--resolution 可選 1080p、2K、4K，默認 1080p。
3. 生成模式：--generation_mode 當前可選值爲 components（默認）。
4. 調試與異步：--dry-run 可打印請求體與費用估算而不真正調用 API；--no-wait 返回 generateId，可用 dlazy status <generateId> --wait 輪詢；--timeout 默認等待 1800 秒。
5. 結構化輸出：成功時 JSON 中含 modelId: "vidu-t2i-viduq2" 及 outputs[].url 等字段，便於 Agent 把圖片鏈接寫回對話或下游步驟。

觸發關鍵詞在文檔中列爲：vidu q2、生成/編輯圖片、文生圖/圖生圖（及英文對應表述）。

安裝與啓用¶

1. 安裝 Skill（SkillHub）¶

SkillHub 頁面給出的方式是讓 Agent 按 SkillHub 安裝說明 安裝座標包。命令行可先檢查 CLI：

command -v skillhub && skillhub --version

未安裝時，安裝文檔提供的完整安裝方式爲：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

將 Skill 裝到當前 Agent 實際使用的 skills 目錄（安裝時必須帶 --dir，否則默認 ./skills/ 可能不會被識別）。例如 Cursor 常用路徑爲 ~/.cursor/skills/：

skillhub install @user_f95f21b8/dlazy-viduq2-t2i --dir ~/.cursor/skills/

Claude Code 對應目錄爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下的 .agents/skills/。路徑以你當前客戶端爲準，與 安裝文檔第四節 一致即可。

2. 安裝 dLazy CLI¶

Skill 固定 CLI 版本 1.0.9，全局安裝命令爲：

npm install -g @dlazy/cli@1.0.9

若不想全局安裝，可按文檔使用：

npx @dlazy/cli@1.0.9 <command>

源碼與包信息見 github.com/dlazyai/cli 與 npm 包 @dlazy/cli。

3. 配置 API Key¶

所有請求需要 dLazy API Key。推薦通過 CLI 寫入用戶配置（Linux/macOS 爲 ~/.dlazy/config.json）：

dlazy auth set YOUR_API_KEY

也可按次使用環境變量 DLAZY_API_KEY。Key 在 dlazy.com/dashboard/organization/api-key 獲取。

典型用法¶

Agent 側的核心動作是執行 dlazy viduq2-t2i。先查看幫助確認當前參數名：

dlazy viduq2-t2i -h

文生圖示例（僅提示詞）：

dlazy viduq2-t2i --prompt 'a minimalist product photo on white background'

圖生圖可參考 SKILL 中的示例（文檔示例使用 --image；-h 中對應項爲 --images，以你本機 dlazy viduq2-t2i -h 輸出爲準）：

dlazy viduq2-t2i --prompt 'prompt text' --image '/path/to/image.png'

dlazy viduq2-t2i --prompt 'prompt text' --image 'https://files.dlazy.com/image.png'

指定畫幅與分辨率：

dlazy viduq2-t2i --prompt 'city skyline at dusk' --aspectRatio 16:9 --resolution 2K

調用前可用 --dry-run 覈對 payload 與費用估算；正式調用成功後，響應中 result.outputs 會包含圖片 URL（託管在 files.dlazy.com）。

適用場景與注意¶

適合誰：需要在 Agent 工作流裏快速出圖、改圖，且願意使用 dLazy 雲端計費與存儲的團隊或個人；設計類 Skill（design-media）與「對話裏一句話要配圖」的場景較匹配。

限制與注意：

1. 付費與餘額：API 爲 SaaS 模式；insufficient_balance 時需到 積分設置頁 充值。
2. 鑑權：未配置或無效 Key 會返回 unauthorized，需重新 dlazy auth set 或檢查 DLAZY_API_KEY。
3. 數據路徑：本地參考圖會上傳到 dLazy 媒體存儲；敏感素材需自行評估合規性，並閱讀 dlazy.com 服務條款。
4. 依賴環境：需 Node 生態下的 npm/npx；無網或受限沙箱中 CLI 安裝與 API 調用可能失敗。
5. SkillHub 側信息：截至資料抓取，該 Skill 評分 100000、下載 1038 次；安裝記錄爲 0（以 SkillHub 頁面統計爲準）。

結尾¶

viduq2 t2i 把 Vidu Q2 的文生圖、圖生圖能力收斂成 Agent 可讀的 SKILL 與一條 CLI 命令，減少自建 HTTP 客戶端與參數對照表的工作。安裝 Skill 後配置 dLazy API Key，即可在對話中用 dlazy viduq2-t2i 產出可鏈接的圖片結果。

官方入口：

• API 座標頁：https://api.skillhub.cn/user_f95f21b8/dlazy-viduq2-t2i
• SkillHub 展示頁：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-viduq2-t2i