前言¶
在 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。
