共计 5353 个字符,预计需要花费 14 分钟才能阅读完成。
在 AI 大模型领域,调用 API 最大的痛点就是 ” 算成本 ”——文本按 Token 计费,图片按张计费,视频按秒计费,很多天马行空的创意还没来得及验证,就被预算拦在了门外。近日发现了一个叫 Agnes AI 的大模型平台,它把文本、图片、视频三类生成模型全部免费开放,而且不是那种 ” 尝鲜、限日期、限用量 ” 的假免费,是实实在在的账单“0 元”计费,今天就带大家详细折腾一下。

(该图片由 Agnes AI 生成)
Agnes AI 是什么
Agnes AI 是一个集成了文本、图像、视频生成能力的大模型平台,官网地址:https://agnes-ai.com/
它最大的卖点就两个字:免费。文本模型、图像模型、视频模型,全部免费调用,不限日期,不限用量。
但是免费的模型能力会不会很拉胯?据 Agnes AI 官网介绍,免费模型在 ClawEval 排行榜和 AA 排行榜上的排名还挺靠前。并且宣布完全免费之后,短短 7 天时间就交出了一份相当夸张的成绩单:
- 文本模型调用量超过 1 万亿 Token
- 图片模型生成量超过 200 万张
- 视频模型生成量超过 200 万秒
1 万亿 Token 大致相当于数十亿页中文文本的处理量,远超日常聊天问答的消耗水平,说明大量用户已经把它用到了 Agent、编程、自动化工作流等高频场景里。
由此可见,当生成成本被大幅降低甚至免费后,大家不再满足于 ” 生成一版看看 ”,而是会进行多版本对比、批量测试、自动化创作。从 ” 偶尔体验 ” 变成 ” 持续调用 ”,这恰恰是 AI 从工具变成基础设施的信号。
接入方式
接入 Agnes AI 非常简单,先到 API 平台 注册账号、创建一个 API Key,然后对照官方文档调用即可:
几个关键信息先记住,后面所有调用都离不开它们:
- Base URL:
https://apihub.agnes-ai.com/v1 - 鉴权方式:HTTP Header
Authorization: Bearer 你的 API_KEY - 协议兼容:OpenAI 兼容格式,用 OpenAI SDK 习惯的同学可以无缝迁移
- API Key 格式:
sk-agnes-xxxxxxxxxx
可用模型一共有这几个:
| 类型 | 模型名 | 说明 |
| 文本 | agnes-2.0-flash |
文本生成与推理(主力) |
| 文本 | agnes-1.5-flash |
轻量文本模型 |
| 图片 | agnes-image-2.1-flash |
文生图 / 图生图(最新) |
| 图片 | agnes-image-2.0-flash |
文生图 |
| 视频 | agnes-video-v2.0 |
文生视频 / 图生视频 |
文本模型调用
文本模型是最常用的,拿来做问答、写代码、分析长文本都很合适。
curl 示例:
curl https://apihub.agnes-ai.com/v1/chat/completions \
-H "Authorization: Bearer 你的 API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"agnes-2.0-flash","messages": [
{"role": "user", "content": "用一句话介绍你自己"}
]
}'
Python 示例:
import requests
url = "https://apihub.agnes-ai.com/v1/chat/completions"
headers = {
"Authorization": "Bearer 你的 API_KEY",
"Content-Type": "application/json"
}
data = {
"model": "agnes-2.0-flash",
"messages": [
{"role": "user", "content": "用一句话介绍你自己"}
]
}
resp = requests.post(url, headers=headers, json=data)
print(resp.json()["choices"][0]["message"]["content"])
提示:如果你用 OpenAI 的 SDK 习惯了,可以把 Agnes AI 的接口当成兼容接口来用,只需把
base_url换成https://apihub.agnes-ai.com/v1、api_key换成 Agnes 的 Key 即可,迁移成本几乎为零。
图片生成
图片模型支持文生图,也支持图生图。文生图最简单,给一段提示词就行:
import requests
url = "https://apihub.agnes-ai.com/v1/images/generations"
headers = {
"Authorization": "Bearer 你的 API_KEY",
"Content-Type": "application/json"
}
data = {
"model": "agnes-image-2.1-flash",
"prompt": "考古机器人在废弃数据中心挖掘,布满灰尘的服务器,发黄的机械键盘,CRT 显示器",
"n": 1
}
resp = requests.post(url, headers=headers, json=data)
print(resp.json())
随便试了几张,效果相当能打。比如让 Agnes AI 辅助生成一段提示词,画 ” 一艘巨大的钢铁军舰破浪航行,桅杆顶部的旗帜上写着 RayKS,背后是连绵群山,峭壁上雕刻着 ’RayKS.Com’,金色的黄昏逆光、丁达尔光束、海面波光粼粼——出来的图有了光线和气势,史诗感拉满。

(该图片由 Agnes AI 生成)
再比如画 ” 考古机器人在废弃数据中心挖掘,布满灰尘的服务器,发黄的机械键盘,CRT 显示器 ” 这种带点叙事感的场景,它也能很好地理解并呈现。

(该图片由 Agnes AI 生成)
建议:生成图片不满意就多试几次,反正免费,毫无心理负担。多版本对比、反复打磨提示词,才能把脑海里的创意更完美地呈现出来。
视频生成
视频生成有两种方式:
- 文生视频:直接用文字描述生成视频
- 图生视频:基于一张图片生成动态视频(推荐,效果更可控)
图生视频的话,可以传入一张主图,再传入一张参考图,Agnes AI 会把它们合成到同一个画面里。比如用一张考古机器人图片作为主图,再把 Java Logo 作为参考图,它能把 Logo 合理地 ” 放 ” 到老旧的 CRT 显示器屏幕上,合成得相当自然。
import requests
url = "https://apihub.agnes-ai.com/v1/videos/generations"
headers = {
"Authorization": "Bearer 你的 API_KEY",
"Content-Type": "application/json"
}
data = {
"model": "agnes-video-v2.0",
"prompt": "一个考古机器人在废弃数据中心挖掘,突然间一个显示器亮了,屏幕上显示 Java logo",
"image": "https:// 你的图片地址 /archaeology.jpg",
"reference_image": "https:// 你的图片地址 /java-logo-rgb.jpg"
}
resp = requests.post(url, headers=headers, json=data)
print(resp.json())
演示:一个考古机器人在废弃数据中心挖掘,突然间一个显示器亮了,屏幕上显示“RayKs.Com”。
(该视频由 Agnes AI 生成)
玩时间长了会有些上瘾,总想把脑海里的创意一点点变成画面。以前用别的模型,每生成一段视频都要心疼一下成本,现在随便试,试到自己满意为止。
接入龙虾客户端(WorkBuddy、OpenClaw 等)
前面是直接调 API,适合写脚本、做自动化。但日常用得最多的其实是各种 AI Agent 客户端——大家习惯叫 ” 龙虾 ”,比如 WorkBuddy、OpenClaw、Cherry Studio 这类。好在 Agnes AI 官方文档里直接给出了这些客户端的接入指南,配置都很简单,核心就三样东西:Base URL、API Key、模型名。
第一步:获取 API Key
先到 API 平台 注册登录,进入【设置 → API 密钥】页面,点击【创建新的密钥】,给密钥起个名字(比如 workbuddy),复制保存好。
注意:API Key 只在创建时显示一次,格式类似
sk-agnes-xxxxxxxxxx,务必保存好,不要泄露给他人。
第二步:在 WorkBuddy(或者其他龙虾)中接入
通过 WorkBuddy(或者是支持配置自定义模型的其他龙虾),不用改配置文件,在界面里点点就行。
打开 WorkBuddy,在对话框的模型选择处,点击【添加配置自定义模型】
提供商选择【其他 / 自定义(Custom)】
按下表填写:
| 字段 | 填入内容 |
| API Base URL | https://apihub.agnes-ai.com/v1 |
| API Key | 你的 Agnes API Key |
| Model Name | agnes-2.0-flash |
保存后,在对话框模型列表里就能选到 Agnes 2.0 Flash 了,无限使用,不扣减 WorkBuddy 积分
提示:文本模型配置好之后,图片和视频生成可以通过 WorkBuddy 的 Skill 机制来挂载。在会话里安装
agnes-image-gen和agnes-video-gen这两个技能,之后直接用自然语言说 ” 生成一张……” 或 ” 生成一段视频……” 即可,助手会自动调用对应模型。
或者在 OpenClaw 中接入
OpenClaw 是开源的 AI Agent 客户端,支持命令行配置,一条命令就能把文本、图片、视频三个模型一起加进来。
方式一:命令行一键配置(推荐)
把下面命令里的 sk-xxxx 替换成你自己的 Agnes 密钥,在终端依次执行:
# 1. 添加 Agnes 提供商(文本 + 图片 + 视频一次性配好)openclaw config set models.providers.agnes --json '{"baseUrl":"https://apihub.agnes-ai.com/v1","apiKey":"sk-xxxx 替换成你的 xxxx","api":"openai-completions","models": [
{"id": "agnes-2.0-flash", "name": "Agnes 2.0 Flash(文本)", "contextWindow": 262144, "maxTokens": 65536},
{"id": "agnes-image-2.1-flash", "name": "Agnes Image 2.1(生图)"},
{"id": "agnes-video-v2.0", "name": "Agnes Video V2.0(生视频)"}
]
}'
# 2. 设置默认文本模型为 Agnes
openclaw config set agents.defaults.model.primary "agnes/agnes-2.0-flash"
# 3. 重启网关生效
openclaw gateway restart
方式二:交互式向导
运行 openclaw config,依次选择 Local → Model → Custom Provider,然后填:
- API Base URL:
https://apihub.agnes-ai.com/v1 - API Key:你的 Agnes 密钥
- Model:
agnes-2.0-flash
保存后随便发句话测试一下连通性即可。
警告:Base URL 只填到
https://apihub.agnes-ai.com/v1为止,不要 再手动加/chat/completions,否则会报 404。OpenClaw 会自动拼接路径。
配置图片 / 视频技能:
OpenClaw 的玩法更 ” 智能 ” 一点——在会话里把模型切换到 agnes-2.0-flash,然后直接用自然语言告诉助手:
“ 我想要使用 agnes image 2.1 模型生图,访问它的 api 平台 agnes-ai.com/doc,这是 api 密钥:[粘贴你的 Key]”
助手会自动访问 Agnes API 文档、理解接口,然后把图片生成能力保存成一项可复用的技能。视频生成技能同理。之后你直接说 ” 生成一只橘猫坐在毯子上 ”,它就会自动调用 Agnes 图片模型生图。
其它客户端
除了 WorkBuddy 和 OpenClaw,Agnes AI 官方文档里还提供了 Cherry Studio、Opencode、Codex++、Claude CLI、Claude Desktop 等客户端的接入指南,套路完全一样——都是填 Base URL、API Key、模型名这三样,因为 Agnes 走的是标准 OpenAI 兼容协议。遇到 Anthropic 协议的客户端(如 Claude Code),则需要借助 cc-switch 做一层协议转换,具体可参考官方的 Common Integration Docs 章节。
写在最后
一路折腾下来,我发现 Agnes AI 带来的最大变化并不是省下了多少钱,而是改变了使用 AI 的方式。
过去调用大模型,尤其是图像和视频,总会下意识算一下成本,很多创意还没落地就被预算和顾虑拦住了。现在,图片生成不好?重来。视频效果不满意?继续试。Agent 跑一整天?随便!
以前需要精打细算的事情,现在都可以大胆尝试,再无后顾之忧。AI 不再是一个偶尔打开体验一下的新奇工具,而开始像水、电、网络一样,成为随手可得的基础能力。
狸卡司 · 澄光自媒体 / 文