前言¶
在 Cursor、Claude Code 等環境裏做配圖或改圖時，常見做法是手寫 HTTP 請求、自己管鑑權與上傳，再把返回 URL 塞回對話。步驟多、參數也容易和官方文檔對不齊。下面介紹 SkillHub 上的 kling image o1（座標 @user_f95f21b8/dlazy-kling-image-o1）：把可靈 Kling o1 的圖像能力封裝成標準 SKILL.md，由 Agent 按文檔調用 dLazy CLI 的 kling-image-o1 子命令，統一走文生圖與參考圖生圖。
這是什麼¶
kling image o1 是社區來源（community）的 design-media 類 Skill，SkillHub 發佈者爲 user_f95f21b8，當前列表版本爲 1.0.4。官方簡介爲：Generate exquisite images with Kling o1 model. Supports text-to-image and image-to-image.
技能本體是對 dLazy 託管 API 的薄封裝：維護方在文檔中寫明 CLI 來自 dlazyai（github.com/dlazyai/cli），推理請求發往 api.dlazy.com，本地參考圖經 CLI 上傳到 oss.dlazy.com。SkillHub 標籤含 requires_api_key=true，使用前需配置 dLazy API Key。
核心功能¶
依據技能包內 SKILL.md / SKILL-cn.md，已覈實能力如下：
- 文生圖（text-to-image）：通過
--prompt提交提示詞生成圖像。 - 圖生圖 / 參考圖（image-to-image）：通過
--images傳入最多 10 張參考圖，支持本地路徑或 URL。 - 輸出規格：
--clarity可選2k、4k（默認2k）；--aspect_ratio支持16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9、auto（默認16:9）。 - 高級入參：
--promptRefs、--input（JSON，支持內聯、@file或 stdin）；--dry-run可預估費用且不真正調用 API；異步場景可用--no-wait與--timeout（默認等待上限 1800 秒）。 - Agent 觸發詞（便於在對話裏喚起技能）：如「kling o1」「kling image」「文生圖、圖生圖」等，見技能文檔「觸發關鍵詞」一節。
成功時 CLI 返回 JSON，kind 爲 urls，data.urls 中爲託管在 oss.dlazy.com 的結果鏈接。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
按 SkillHub 安裝說明 檢查或安裝：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝腳本（文檔推薦）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 將 Skill 裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。常見路徑（摘自 SkillHub 文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
安裝本 Skill 的命令示例：
skillhub install @user_f95f21b8/dlazy-kling-image-o1 --dir ~/.cursor/skills/
SkillHub 頁面也支持把下面提示交給 AI，讓其按安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_f95f21b8/dlazy-kling-image-o1`。
3. 安裝並配置 dLazy CLI¶
技能 metadata 要求本機具備 npm、npx，並固定使用 @dlazy/cli@1.0.8：
npm install -g @dlazy/cli@1.0.8
或不全局安裝、按需調用：
npx @dlazy/cli@1.0.8 <command>
配置 API Key（亦可使用環境變量 DLAZY_API_KEY）：
dlazy auth set YOUR_API_KEY
Key 保存在 ~/.dlazy/config.json（Windows 爲 %USERPROFILE%\.dlazy\config.json）。獲取地址：dlazy.com/dashboard/organization/api-key。
安裝或升級 Skill 後，按你所用客戶端說明重啓或刷新 Agent，以便加載新技能。
典型用法¶
技能要求 Agent 執行 dlazy kling-image-o1 獲取結果。先查看完整參數：
dlazy kling-image-o1 -h
文生圖示例（僅提示詞）：
dlazy kling-image-o1 --prompt '一隻坐在窗臺上的橘貓，午後暖光，膠片質感'
帶參考圖（幫助裏參數名爲 --images；技能文檔示例中寫作 --image，以 -h 輸出爲準）：
dlazy kling-image-o1 --prompt '保持主體，換成賽博朋克夜景背景' --images '/path/to/reference.png'
使用遠程參考圖並指定清晰度與畫幅：
dlazy kling-image-o1 \
--prompt '同款構圖，水彩插畫風格' \
--images 'https://oss.dlazy.com/image.png' \
--clarity 4k \
--aspect_ratio 1:1
調用前可用 --dry-run 查看 payload 與費用估算；長任務可配合 --no-wait，再按 dLazy CLI 的 status 子命令輪詢（見技能錯誤處理與異步說明）。
適用場景與注意¶
適合誰
- 已在用 Cursor / Claude Code / Codex 等、希望用自然語言驅動 Kling o1 出圖或改圖，又不想在對話裏重複拼 API 的開發者或設計師。
- 願意使用 dLazy 賬號與積分、接受提示詞與參考圖上傳到其雲端推理與存儲的團隊。
限制與注意
- 付費與配額：401 表示 Key 無效或缺失；503 且
code: "insufficient_balance"表示餘額不足，需在 dLazy 積分設置 充值。 - 合規與安全：異步失敗或策略攔截時，後端可能返回如 Prompt violates safety policy 等具體原因（技能錯誤表中的 504 類場景）。
- 本地文件：路徑錯誤會觸發 502 類本地讀取失敗；上傳參考圖意味着文件會經 CLI 進入
oss.dlazy.com。 - 版本：SkillHub 列表爲 1.0.4，技能包內 front matter 可能爲 1.0.2 且綁定 CLI 1.0.8；以你
skillhub install拉取的包與dlazy kling-image-o1 -h爲準。 - 社區 Skill：來源爲 community，安裝前可在 SkillHub 查看評分與下載量（當前資料：評分 100000，下載 1163，安裝 3），並自行審閱 CLI 源碼。
結尾¶
kling image o1 把可靈 o1 的文生圖、參考圖生圖收斂成 Agent 可執行的 dlazy kling-image-o1 工作流：Skill 負責觸發詞與參數約定，dLazy CLI 負責鑑權、上傳與回傳 URL。若你要在 Agent 裏穩定調用 Kling o1 圖像能力，可從 SkillHub 安裝該技能並配好 API Key。
