mcpField
A
agnes-free-image

agnes-free-image

github.com/kangarooking创意与媒体200131 次安装21 周前更新
代码仓库

关于 agnes-free-image

使用 agnes-image-2.1-flash 通过 Agnes API 生成或转换图像的技能，提供提示词组织建议及 Python 脚本，用于请求、试运行和保存返回的图像链接。

主要功能

  1. 01文本生成图像
  2. 02基于公开链接转换图像
  3. 03提示词结构指导
  4. 04通过 dry-run 验证请求
  5. 05将返回图像保存到本地

适用场景

  1. 01根据文字场景描述生成图像
  2. 02保留构图并改造参考图风格
  3. 03调用 API 前检查请求参数
  4. 04将生成结果保存到本地目录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kangarooking/agnes-free-model-skills --skill agnes-free-image

安装后在 Claude Code 中输入/agnes-free-image确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
api.md
scripts/
agnes_image.py

详细介绍

Agnes Free Image

使用此技能，通过 agnes-image-2.1-flash 生成或转换图像。

凭据规则

从环境中读取 API 密钥。不要将密钥硬编码到提示词、脚本、技能文件、提交记录或 Shell 历史记录中。

首选变量：

export AGNES_API_KEY="..."

该辅助工具也接受 AGNES_TOKEN 作为备用变量。

快速开始

文生图：

python3 scripts/agnes_image.py generate \
  --prompt "A luminous floating city above a misty canyon at sunrise, cinematic realism" \
  --size 1024x768 \
  --output-dir ./outputs/agnes-free-image

使用公开图像 URL 进行图生图：

python3 scripts/agnes_image.py generate \
  --prompt "Transform the scene into a rain-soaked cyberpunk night while preserving the composition" \
  --image-url "https://example.com/input.png" \
  --size 1024x768 \
  --output-dir ./outputs/agnes-free-image

在不调用 API 的情况下验证请求格式：

python3 scripts/agnes_image.py generate \
  --prompt "A detailed AI workflow dashboard poster, clean editorial style" \
  --size 1024x1024 \
  --dry-run

提示词模式

文生图使用此结构：

[Subject] + [Scene / Environment] + [Style] + [Lighting] + [Composition] + [Quality Requirements]

对于图生图，请同时说明要更改的内容和要保持不变的内容。

工作流

  1. 判断请求属于文生图还是图生图。
  2. 将模糊的视觉需求转化为具体的提示词，包含主体、环境、风格、光线、构图和细节程度。
  3. 使用 scripts/agnes_image.py generate。对于复杂提示词或参考图，建议先使用 --dry-run。
  4. 如果响应中包含可下载的 URL，请使用 --output-dir 在本地保存返回的图像 URL。
  5. 当原始响应格式或高级参数很重要时，请阅读 references/api.md。

备注

  • 端点：POST https://apihub.agnes-ai.com/v1/images/generations
  • 模型：agnes-image-2.1-flash
  • 辅助工具的默认尺寸为 1024x768。
  • 对于图生图，输入图像必须可通过 URL 访问，并通过 extra_body.image 发送。
  • 辅助工具通过 extra_body.response_format: "url" 请求 URL 格式的响应。

参考

需要请求字段、响应处理或源文档中的提示词示例时，请阅读 references/api.md。

评论

支持 Markdown