前言¶
在 Cursor、Claude Code 等环境里做配图，常见做法是手写 HTTP 请求、自己维护模型名和参数，或在对话里反复粘贴 API 文档。Agnes 提供独立的图像生成接口，文生图与图生图模型版本也不相同，接进 Agent 后更适合用自然语言触发。下面介绍 SkillHub 社区 Skill agnes文生图（@user_c28beb7a/agnes-image-gen），把 Agnes 图片能力封装成可被 Agent 加载的 SKILL 流程。
这是什么¶
agnes文生图 是发布在 SkillHub 的社区 Skill（分类 design-media，当前版本 v2.0.5），由发布者 user_c28beb7a 维护。它调用 Agnes AI 的图片生成模型：文生图使用 agnes-image-2.1-flash，图生图使用 agnes-image-2.0-flash。Skill 标注 requires_api_key=true，支持配置你自己的 Agnes API Key。计费方面，官方说明为不消耗 WorkBuddy 积分，仅消耗 Agnes API 额度。
核心功能¶
依据 SkillHub 页面与 API 摘要，已核实能力如下。
- 文生图（text-to-image）：通过提示词生成图片，模型为
agnes-image-2.1-flash。 - 图生图（image-to-image）：在已有图片基础上按描述改写或延展，模型为
agnes-image-2.0-flash。 - 自定义 API Key：可使用自有 Agnes Key，额度与账号策略由 Agnes 侧决定。
- 生成取向：官方强调降低画面「AI 感」、增强自然真实感；对中文配文强调逻辑连贯、字体排版，并减少文字重影重叠。
- 触发加载：当用户说「用 Agnes 生成图片」「用 Agnes 画一张」「Agnes 生成」，或明确要求使用 Agnes API 做文生图/图生图时，Agent 应加载本 Skill。
安装与启用¶
SkillHub 提供的安装方式是指令式：让当前 AI 按统一安装文档拉取 Skill 包，而不是在本机手动 git clone。
向 Agent 发送下面这段话即可完成安装指引（原文来自 SkillHub 技能页）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c28beb7a/agnes-image-gen`。
安装文档 https://skillhub.cn/install/skillhub.md 会说明 Cursor、Codex CLI、Claude Code 等客户端的差异；按你使用的工具跟随该文档中的目录与配置步骤即可。本 Skill 需要 API Key，安装后按 SKILL 内说明配置 Agnes Key（具体字段名以安装后仓库中的 SKILL.md 为准）。
典型用法¶
本 Skill 面向对话触发，而非单独 CLI。在已安装并配置 Key 的前提下，可按场景这样说：
文生图示例（示意提示，非固定 API 参数）：
用 Agnes 画一张：秋日傍晚的城市天台，胶片质感，远处有暖色灯光，画面里不要水印。
图生图示例：
用 Agnes 生成：以当前这张产品图为参考，改成浅灰背景，保留产品主体，风格更写实。
或直接使用官方列出的触发语，例如「用 Agnes 生成图片」「Agnes 生成」，并在同一句里写清画面描述或修改意图。Agent 加载 Skill 后会按 SKILL.md 中的流程调用 Agnes 接口；返回结果一般为生成图片的路径或展示方式，以 Skill 实现为准。
适用场景与注意¶
适合谁
- 已在用 Agnes API，希望在 Agent 对话里统一走文生图/图生图，而不每次手写请求。
- 需要中文海报、配图类需求，且关注中文文字排版与少「AI 感」的官方优化方向。
- 希望配图消耗走 Agnes 额度，而不是 WorkBuddy 积分（以官方说明为准）。
限制与注意
- 必须自备并配置 Agnes API Key；未配置时 Skill 无法完成调用。
- 文生图与图生图对应不同模型版本，图生图需能提供参考图或上下文中的图片。
- SkillHub 统计（页面展示）：评分 100000，下载 5427 次；社区来源，升级以 SkillHub 上 v2.0.5 及后续版本为准。
- 额度、限速、内容策略以 Agnes 平台当前规则为准，本文不替代其官方文档。
结尾¶
agnes文生图 把 Agnes 的 agnes-image-2.1-flash（文生图）与 agnes-image-2.0-flash（图生图）接到 Agent 工作流里，用固定触发语即可加载，并支持自有 API Key。需要安装或查看说明时，打开 SkillHub 技能页或 API 摘要地址：
- SkillHub：https://www.skillhub.cn/skills/user_c28beb7a/agnes-image-gen
- API 摘要：https://api.skillhub.cn/user_c28beb7a/agnes-image-gen
