前言¶

在 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