前言¶
在 Cursor、Claude Code 等环境里写稿或做设计时，经常需要「根据一段话出一张图」，或「拿参考图改风格、补细节」。自己接火山引擎视觉智能平台的异步任务、轮询结果、再下载图片，步骤多且容易在 AK/SK 和路径上踩坑。Jimeng AI Image 4.6 把即梦 AI 图片生成 4.6 封装成 Skill：对话里用自然语言触发，底层用统一脚本完成提交与轮询。
这是什么¶
Jimeng AI Image 4.6（坐标 @user_393c9577/jimeng-image-gen-46）是 SkillHub 社区 Skill，分类为 design-media，当前版本 1.0.1，由发布者 user_393c9577 维护。它通过火山引擎视觉智能平台（Visual Intelligence）生成图片，支持文生图（text2img）与图生图（img2img），采用异步提交加轮询取结果。SkillHub 页面标注 requires_api_key=true，使用前需配置火山引擎访问密钥。
核心功能¶
下面介绍 Skill 已写明的能力，均来自其 SKILL.md 说明。
- 文生图（text2img）：用提示词生成图片，可设尺寸预设或自定义
WxH、--scale（文本影响程度 1–100）等。 - 图生图（img2img）：在参考图 URL 与提示词基础上生成变体，适合风格迁移、修复类需求。
- 任务与结果：除自动轮询外，提供
result查询、download落盘、status检查配置。 - 异步模式：
--async仅提交任务并返回task_id，便于批量或自行控制轮询节奏。 - Agent 对话：官方列出触发词，例如「生成图片」「文生图」「图生图」「即梦」「jimeng」「配图」「插图」等，可在聊天中直接描述需求，由 Agent 调用脚本。
默认模型标识为 jimeng_seedream46_cvtob；若 4.6 不可用，可通过环境变量 JIMENG_REQ_KEY=jimeng_t2i_v40 回退到即梦 AI 4.0。
安装与启用¶
安装 Skill¶
SkillHub 页面建议按 SkillHub 安装文档 安装本 Skill。先确认是否已有 skillhub CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装（文档中的推荐方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。示例：
skillhub install @user_393c9577/jimeng-image-gen-46 --dir ~/.cursor/skills/
不同客户端常见路径（摘自安装文档）：Cursor 为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。按你实际使用的环境选择目录即可。
也可将提示词发给 AI：「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_393c9577/jimeng-image-gen-46。」
配置火山引擎密钥¶
使用前设置环境变量（不要在对话里粘贴明文密钥）：
export VOLC_ACCESS_KEY=your-ak-here
export VOLC_SECRET_KEY=your-sk-here
AK/SK 获取：火山引擎密钥管理。开通相关能力：视觉智能服务入口。
可选环境变量包括：JIMENG_REQ_KEY（模型版本）、JIMENG_POLL_MAX / JIMENG_POLL_MS（轮询）、JIMENG_RETRY_MAX / JIMENG_RETRY_MS（重试与退避）。默认值见 Skill 内 SKILL.md。
典型用法¶
核心入口为 Skill 目录下的 Node 脚本，需在该目录执行或使用绝对路径：
node scripts/jimeng.mjs <command> [选项]
文生图¶
提交后脚本会自动轮询（文档说明单张通常约 10–60 秒，2k/4k 可能更久）：
node scripts/jimeng.mjs text2img -p "赛博朋克城市夜景,霓虹灯光"
node scripts/jimeng.mjs text2img \
-p "一只穿西装的猫在咖啡馆喝咖啡,吉卜力风格" \
-s "16:9" \
--scale 60
尺寸预设包括 1:1、3:4、4:3、9:16、16:9、2:3、3:2、21:9、1k、2k、4k，也支持如 2560x1440 的自定义比例。
图生图¶
参考图须为可公网访问的 URL（本地文件需先上传到对象存储或图床等）：
node scripts/jimeng.mjs img2img \
-p "添加梵高星月夜风格,油画质感" \
-i "https://example.com/my-photo.jpg" \
--scale 70
在对话里使用¶
官方示例流程：用户说「帮我生成一张赛博朋克风格的猫咪图片，16:9 尺寸」，Agent 执行 text2img、等待轮询、返回图片链接；图生图则需先拿到图片 URL 再执行 img2img。更细的 API 与错误码见 Skill 包内 references/api_reference.md，排错见 FAQ.md。
Skill 还提到可与 cloud-upload-backup（上传云端）、文档类 Skill（插图）、canvas-design（二次设计）等配合，具体以各 Skill 自身文档为准。
适用场景与注意¶
适合：需要根据文字快速出配图；有参考图要做风格或细节变体；在 Agent 工作流里批量绘图；与其他 Skill 串联完成「写稿 + 配图」。
注意：
- 依赖火山引擎账户与余额，产生费用需自行关注控制台。
- 网络波动时脚本会按配置重试，认证或参数错误不会重试。
- 图生图依赖可访问的图片 URL，本地路径不能直接作为
-i参数。 - SkillHub 统计（以页面抓取为准）：评分 100000，下载 974，标签含
requires_api_key=true。
结尾¶
Jimeng AI Image 4.6 把即梦 4.6 的 text2img / img2img 和异步轮询封装进 Agent 可读的 Skill，减少手写对接成本。安装与详情见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/user_393c9577/jimeng-image-gen-46
- API 入口：https://api.skillhub.cn/user_393c9577/jimeng-image-gen-46
