Agnes免费生图API实战：从效果评测到自建生图工具全解析

July 22, 2026

此前介绍免费大模型时曾提及Agnes平台，其不仅提供文字模型，还开放了图片与视频模型的免费API。经过实测，视频模型仍需排队，但图片生成功能已经稳定可用。实际验证表明，平台可正常完成文生图与图生图（P图）任务，这促使作者开发了一款简易的AI生图软件。本文将分享该生图模型的实际表现，并介绍基于API自建图像处理工具的过程。借助AI技术，许多场景下可以直接定制软件，从而摆脱对第三方工具的依赖。

首先，通过官方文档了解Agnes Image模型。

网址：https://agnes-ai.com

当前最新版本为 Agnes Image 2.1 Flash，2.5预览版即将到来。该模型由Sapiens AI推出，支持文生图与图生图两种工作流。

与之前版本相比，Agnes Image 2.1 Flash 在高信息密度图像生成方面的性能有所提升，更适合需要复杂视觉细节、更丰富构图以及更清晰语义对齐的场景。

作者初次接触该平台，对历史版本并无概念，因此直接通过极简提示词进行测试。若简单指令便能生成较好画面，说明模型的下限较为可靠。

一、效果预览

提示词：

1apple

真实度表现不错。

提示词：

1girl

整体真实感较好，未出现某些模型常见的过度修饰，不过人像的颜值并非个人偏好。

提示词：

一个木质的电脑桌上放着一台苹果电脑，清晨的阳光打在桌上

整体氛围不错，但屏幕细节一般，光线虽佳却不太像清晨的感觉。

接着尝试修改图片：

修改电脑的壁纸，改成 macOS 26 的经典壁纸，电脑画面属于登录状态。

它成功定位到屏幕区域并进行修改，说明图像理解能力尚可。但对“macOS 26”和“登录状态”这两个较新或模糊的概念处理欠佳，导致画面混杂，反映出对这类内容的训练不足。

继续修改图片：

把衣服改成黑色，然后胸口有一个很有设计感的Jarivs。

原图生成的是一件米色T恤，修改后成功改变了颜色并在胸部添加了指定文字。执行相当到位，并且未自动纠正拼写错误（Jarvis被拼成Jarvis），保持了指令的忠实度。

以上粗略测试证实了生成与修改能力基本可用。接下来看如何通过API调用。

二、API文档解析

由于平台提供的是API接口，需通过HTTP调用实现生成。以下梳理关键信息。

Base URL：

https://apihub.agnes-ai.com

Endpoint：

POST https://apihub.agnes-ai.com/v1/images/generations

模型名称：

agnes-image-2.1-flash

这些是调用API的核心信息。

请求参数：

参数	类型	是否必填	描述
model	string	是	模型名称，使用 agnes-image-2.1-flash
prompt	string	是	图像生成或编辑的文本指令
size	string	是	输出图像尺寸，例如 1024x768
image	string[]	图生图必填	输入图像数组，支持公共URL或Data URI Base64
return_base64	boolean	否	文生图输出以Base64返回时使用
extra_body	object	否	高级工作流附加参数
extra_body.response_format	string	否	输出格式，常见值：url, b64_json

cURL 示例：

curl https://apihub.agnes-ai.com/v1/images/generations \  
  -H "Authorization: Bearer YOUR_API_KEY" \  
  -H "Content-Type: application/json" \  
  -d '{  
    "model": "agnes-image-2.1-flash",  
    "prompt": "A luminous floating city above a misty canyon at sunrise, cinematic realism",  
    "size": "1024x768",  
    "extra_body": {  
      "response_format": "url"  
    }  
  }'

接口支持文生图与图生图，可传入base64或URL格式的图片，也可选择返回URL或base64图片数据。

官方提示词结构示例：

[主体] + [场景 / 环境] + [风格] + [光照] + [构图] + [质量要求]  
  
日出时分薄雾峡谷上方的发光浮空城市，电影级写实风格，广角构图，丰富的建筑细节，柔和的金色光线，高视觉密度  
  
将场景转换为霓虹倒影的雨浸赛博朋克夜晚，同时保留原始构图和主体布局。  
  
充满飞行器、全息招牌、密集人群、霓虹灯光的未来城市市场，电影级写实风格，超精细，高信息密度构图

定价方面，尽管文档标出了每张0.003美元的收费标准，但当前所有文字、图片及视频模型均免费开放，实际使用成本为零。

三、自建生图软件实战

掌握API文档后，可以方便地将文档交给AI Agent来编写可视化软件。图形化界面在管理操作、节省tokens以及规避模型不稳定性方面更具优势。此前，作者在测试Opus时曾生成一个图像工具雏形，参照“美图秀秀”布局实现了图片压缩、格式转换、裁剪与拼图等功能。

该界面支持拖拽裁剪，提供常用媒体比例与格式选项，主要用于公众号封面制作。AI生成的图片有时体积过大，可通过该工具快速转换格式与压缩。

拼图功能则用于将多张图片合成为一张，使文章排版更紧凑。此外，还模仿QQ截图开发了截图功能，解决了截图后体积过大、无法选择格式的痛点，自动压缩后便于上传到自建对象存储。

在此基础上，新增了AI生图模块：

生图功能界面简洁：

左侧为输入区域，右侧为预览区域。选择生成类型、输入提示词、设定比例后点击生成即可完成。

使用软件仅需获取Agnes的API Key并配置。点击右上角设置按钮，找到“AI生图”选项：

填入API Key后便能立即使用。整个过程只需邮箱注册，无需复杂的授权与认证，门槛极低。免费资源遵循先到先得原则，早用早受益。

以上是Agnes免费生图API的体验测评以及基于此API自建图像处理软件的全过程，希望能为读者带来实际帮助。