agnes-image-gen:在 Agent 里接入 Agnes 文生图与图生图

前言

在对话式 Agent 里出图,常见做法是接通用多模态接口或平台内置绘图。前者往往要自己在 SKILL 里封装鉴权、模型选择与参数;后者则容易和宿主产品的积分、配额绑在一起。若你已经在用 Agnes AI 的图片能力,或希望出图更偏自然真实、中文配文更稳,需要一个按 Agnes 模型规格写好、且能用自有 Key 的 Skill,agnes-image-gen 就是面向这一场景的社区技能。

这是什么

agnes-image-gen 是 SkillHub 上坐标为 @user_15292d5a/yjkj-agnes-image-gen 的社区 Skill(design-media 分类,当前版本 1.0.0)。发布者为 user_15292d5a,标签标明 requires_api_key=true,即运行前需配置 Agnes API Key。

它把 Agnes AI 的图片生成模型接到符合通用 SKILL.md 约定的 Agent 工作流里:用户用自然语言描述需求时,Agent 加载本 Skill,按规则调用 Agnes 完成文生图或图生图。官方说明中强调:调用 不消耗 WorkBuddy 积分,只消耗 Agnes API 额度。

核心功能

以下能力均来自 SkillHub 页面与已抓取简介,未单独列出的接口字段或脚本不在本文展开。

文生图

使用模型 agnes-image-2.1-flash,根据文本提示生成图片。

图生图

使用模型 agnes-image-2.0-flash,在参考图基础上按提示改写或延展画面。

自定义 API Key

支持配置用户自己的 Agnes Key,由用户在自有 Agnes 账户下计费与控量,而不是走宿主产品的绘图积分。

生成效果取向

Skill 简介中的优化重点包括:

  • 降低画面「AI 感」,增强自然、真实感;
  • 改善中文配文的逻辑连贯性、字体与排版;
  • 减轻文字重影、重叠类常见问题。

何时加载本 Skill

当用户说出例如「用 Agnes 生成图片」「用 Agnes 画一张」「Agnes 生成」,或明确要求使用 Agnes API 做文生图 / 图生图时,Agent 应加载本 Skill。具体触发与参数约定以安装后的 SKILL.md 为准。

安装与启用

SkillHub 官方给出的安装方式有两类:让 AI 按安装文档操作,或在本机用 skillhub CLI 安装到当前 Agent 的 skills 目录。

方式一:提示词交给 AI

将下面意图发给支持 Skill 的客户端(表述以 SkillHub 页面为准):

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_15292d5a/yjkj-agnes-image-gen`。

方式二:skillhub CLI

1、若尚未安装 CLI,可先检查:

command -v skillhub && skillhub --version

2、未安装时,可按 SkillHub 安装文档执行完整安装或仅 CLI(文档地址:https://skillhub.cn/install/skillhub.md)。

3、安装本 Skill 时 必须 使用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别:

skillhub install @user_15292d5a/yjkj-agnes-image-gen --dir <skills 目录>

常见客户端 skills 路径(摘自 SkillHub 安装文档,以你本机实际为准):

客户端 skills 目录
Claude Code ~/.claude/skills/
Cursor ~/.cursor/skills/
Codex ~/.codex/skills/ 或项目下 .agents/skills/
Gemini CLI ~/.gemini/skills/

安装完成后,按各客户端要求配置 Agnes API Key(Skill 标签要求 requires_api_key=true)。密钥字段名与示例以 Skill 包内 SKILL.md 为准;本文不臆造配置项名称。

典型用法

公开页面未提供独立 REST 示例或固定 prompt 模板,用法以 对话触发 + Skill 内说明 为主。可复现的入口如下。

1、确认 Skill 已装入对应 --dir,且 Agnes Key 已配置。

2、在对话中明确走 Agnes,例如:

用 Agnes 画一张:清晨城市天际线,薄雾,纪实摄影风格,不要夸张 HDR。

3、图生图场景下,在支持附件的客户端上传参考图,并说明意图,例如:

用 Agnes 生成:保持这张产品图的光影,把背景换成简约浅灰展台,中文标题「秋日限定」排版清晰、无重影。

Agent 加载 agnes-image-gen 后,应分别选用 agnes-image-2.1-flash(文生图)或 agnes-image-2.0-flash(图生图)。生成结果路径、格式以 Skill 实现与 Agnes API 返回为准。

适用场景与注意

适合谁

  • 已在使用或计划使用 Agnes 图片 API,希望在 Cursor、Claude Code、Codex 等 Agent 里用同一套 Key 出图;
  • 需要海报、配图等带 中文文案 的画面,且希望 Skill 侧针对「AI 感」与文字排版做过取向说明;
  • 希望绘图计费与 WorkBuddy 积分 脱钩,只走 Agnes 额度。

限制与注意

  • 必须自备并妥善保管 Agnes API Key;勿将 Key 写进公开仓库或聊天记录。
  • SkillHub 统计(以脚本抓取为准):评分 100000,下载 1944;页面展示的安装次数为 0,可能与统计口径有关,不影响按上述命令安装。
  • 社区来源(community),升级与维护节奏取决于发布者;生产环境使用前建议在测试 Key 下验证效果与配额。
  • 未在官方简介中出现的模型版本、价格、速率限制,请以 Agnes 官方文档为准。

结尾

agnes-image-gen 把 Agnes 的 agnes-image-2.1-flash 文生图与 agnes-image-2.0-flash 图生图封装成可安装的 Agent Skill,支持自有 Key,并针对更自然的画面与更稳的中文配文做了产品向说明。安装与坐标以 SkillHub 为准。

  • SkillHub 页面:https://www.skillhub.cn/skills/user_15292d5a/yjkj-agnes-image-gen
  • 资源地址:https://api.skillhub.cn/user_15292d5a/yjkj-agnes-image-gen
  • 安装说明:https://skillhub.cn/install/skillhub.md
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye