一个 API key，文本、图片、视频全包，还免费、还 OpenAI 兼容、还有中国站国内直连——Agnes AI 听起来像"太好以至于不真实"。但把它的 5 个模型摊开看：对话编码有 agnes-2.5-flash，文生图有 image-2.1-flash，文生视频有 video-v2.0，全走同一个 base_url，openai SDK 改两行就能跑。这篇就把它当横评来拆：5 个模型各自的最佳射程、和付费方案的差距、以及免费额度到底卡在哪。
先说清边界：下面基于 AgnesAI-Labs/AgnesAI-Models 官方 README、agnes-ai.com 文档和 HN 公开讨论整理，截至 2026-08-10。三个相关仓库的星数经 GitHub 核实（AgnesAI-Models 2,728★、agnes-video-generator 222★、agnes-ai-skill 58★）。免费额度以官方平台 platform.agnes-ai.com 实时为准、随时可能调整；这是代表性对比，非亲自全量压测。
一、Agnes AI 是什么：免费 OpenAI 兼容多模态网关
Agnes AI 是官方的多模态 API 网关，卖点就一句话：一个 key、一套 OpenAI 兼容接口，文本图片视频全接。对开发者来说意味着迁移成本几乎为零——你原来用 openai SDK 写的代码，把 base_url 换成 https://apihub.agnes-ai.com/v1、api_key 换成 Agnes 的，其余不动。
两个关键细节。第一，双站点：国际站 agnes-ai.com + 中国站 agnes-ai.cn。国内开发者不用挂梯子，agnes-ai.cn 直连可用，这是它和多数海外免费网关最大的不同。第二，模型覆盖广：5 个模型覆盖文本对话、编码 agent、图片生成编辑、视频生成四类任务，不是只有聊天。文档在 agnes-ai.com/doc/overview，控制台在 platform.agnes-ai.com。
生态也已经在长：jomeswang/agnes-ai-skill（58★，MIT）把 Agnes 接进 Codex、Claude Code、WorkBuddy、Claude Desktop、Cherry 等 agent；lcy362/agnes-video-generator（222★，MIT）基于 Agnes 免费模型做了开源自托管视频生成器。本站的 Agnes 免费多模态工作流 SOP 讲怎么串，这篇先讲它到底有什么、值不值得用。
二、5 个模型横评：规格对比表
把 5 个模型按类型、端点、能力、最佳场景对一遍。
| 模型 | 类型 | 端点 | 核心能力 | 最佳场景 |
|---|---|---|---|---|
| agnes-2.5-flash | 文本+视觉语言 | /v1/chat/completions | 编码/agent/工具调用/多轮/推理/图像理解 | 对话+编码+看图主力 |
| agnes-2.0-flash | 文本+视觉语言 | /v1/chat/completions | 推理/编码/工具调用/流式/图像理解/agent | 轻量对话+agent 编排 |
| agnes-image-2.0-flash | 图片生成+编辑 | /v1/images/generations | 文生图/图生图，URL 或 Base64 | 基础出图+图生图 |
| agnes-image-2.1-flash | 图片生成+编辑 | /v1/images/generations | 高密度视觉生成/图片编辑/灵活尺寸 | 高质量出图+图片编辑 |
| agnes-video-v2.0 | 视频生成 | /v1/videos | 文生视频/图生视频/多图视频/关键帧动画 | 视频生成（异步任务） |
几个要点。第一，两个文本模型（2.5-flash 和 2.0-flash）都带视觉语言能力，能"看图"——不是只能聊天。第二，图片模型走的是 /v1/images/generations，和 OpenAI DALL-E 同一个端点命名，drop-in 友好。第三，视频模型走 /v1/videos，是异步任务 API——提交任务拿 task_id，轮询拿结果，不是同步返回（这点后面避坑会讲）。第四，2.5-flash 是最新旗舰，能力覆盖最全；2.0-flash 更轻量，适合不需要最新能力的场景省额度。
三、逐个拆：5 个模型各自的最佳射程
agnes-2.5-flash：对话编码看图主力，能力最全。 5 个里最新的旗舰文本模型，编码、agent、工具调用、多轮推理、图像理解全有。日常用它一个就能顶"聊天 + 写代码 + 看截图改 bug + 串工具调用"四件事，是 Agnes 的核心卖点。最佳射程：个人开发者的日常 AI 助手、agent 工作流的主脑、要带视觉理解的任务。
agnes-2.0-flash：轻量文本模型，省额度。 上一代 flash，推理/编码/工具调用/流式/图像理解/agent 都支持，只是不如 2.5 新。当你不需要最强能力、想把额度留给图片视频时，用它跑对话最划算。最佳射程：轻量对话、agent 编排的中间步骤、批量调用省额度。
agnes-image-2.0-flash：基础文生图。 支持文生图和图生图，输入输出走 URL 或 Base64。够做配图、封面、快速概念图。短板：分辨率和细节不如 2.1。最佳射程：快速出图、对画质要求不高的批量配图。
agnes-image-2.1-flash：高质量出图+图片编辑。 2.0 的升级版，主打"高密度视觉生成"（细节更密、画质更高）、图片编辑、灵活尺寸。要出能用的成品图、要改图、要非标准尺寸，选它。最佳射程：成品级出图、图片编辑、需要灵活尺寸的场景。
agnes-video-v2.0：视频生成，异步任务。 5 个里唯一做视频的，支持文生视频、图生视频、多图视频、关键帧动画四种模式。注意它是异步的：提交任务返回 task_id，轮询直到完成。免费额度下视频配额最紧（后面避坑讲）。最佳射程：短视频生成、概念视频、内容创作的视频素材。
四、Agnes vs 付费/其他方案
单平台也能横评——把 Agnes 放到"免费多模态 API"这个赛道里，和 OpenAI 官方付费、其他免费网关比，看它强在哪、弱在哪。
| 维度 | Agnes AI | OpenAI 官方付费 | 其他免费网关 |
|---|---|---|---|
| 价格 | 免费（有额度限制） | 按 token 付费 | 多数免费 |
| 中国站/国内可用 | 有 agnes-ai.cn 直连 | 无，需梯子 | 多数无 |
| OpenAI 兼容 | 是，drop-in | 原生 | 部分是 |
| 模态覆盖 | 文本+图片+视频 | 文本+图片+视频 | 多数只有文本 |
| 免费额度 | 文本 20 RPM、图片按分辨率、视频按配额 | 无免费档 | 文本为主，额度小 |
| 开源自托管生态 | agnes-video-generator 可零成本出视频 | 无 | 少 |
结论很直接：Agnes 的差异化在**"免费 + 中国站 + OpenAI 兼容 + 真多模态"四合一**。OpenAI 官方模态最全但要钱、国内不可用；其他免费网关多数只覆盖文本、没中国站。Agnes 把这四个叠加起来，对国内开发者尤其香——不用梯子、不用改代码、文本图片视频一个 key。和本站 大模型性价比横评 里的付费模型比，Agnes 胜在"零成本起步"；和 另一个免费窗口 WorkBuddy 比，Agnes 胜在多模态覆盖。
五、怎么用：OpenAI SDK drop-in
迁移成本是"好用"的关键指标。Agnes 全走 OpenAI 兼容，用 openai SDK 改两行：
from openai import OpenAI
client = OpenAI(
api_key="agnes-xxx", # 换成你的 Agnes key
base_url="https://apihub.agnes-ai.com/v1", # 换成 Agnes base
)
# 文本对话（流式）
stream = client.chat.completions.create(
model="agnes-2.5-flash",
messages=[{"role": "user", "content": "用一句话解释什么是 MCP"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")
# 图片生成
img = client.images.generate(
model="agnes-image-2.1-flash",
prompt="极简风格封面，AI 工具主题",
n=1,
)
print(img.data[0].url)图片编辑、视频生成同理，端点命名和 OpenAI 一致。视频走 /v1/videos 异步提交，需要轮询 task 状态。完整示例见官方文档 agnes-ai.com/doc/overview。
六、选型建议：按需求选谁
| 你的需求 | 首选 | 理由 |
|---|---|---|
| 日常对话+编码+看图 | agnes-2.5-flash | 能力最全，一个顶四个 |
| 轻量对话省额度 | agnes-2.0-flash | 上一代够用，省额度给图片视频 |
| 成品级出图/图片编辑 | agnes-image-2.1-flash | 高密度生成+灵活尺寸 |
| 快速配图不挑画质 | agnes-image-2.0-flash | 基础出图够用 |
| 视频生成 | agnes-video-v2.0 | 唯一视频模型，四种模式 |
| 要全本地零成本出视频 | agnes-video-generator 自托管 | 开源 MIT，基于 Agnes 免费模型 |
| 要让 Codex/Claude Code 直接调 | agnes-ai-skill | Agent Skill，一键接多个 agent |
最后一行是生态补充：想在自己的 agent 里用 Agnes，agnes-ai-skill 已经做好了适配。想完全离线零成本出视频，lcy362/agnes-video-generator 开源自托管，OpenMontage 也能接 Agnes 当免费模型源。
七、三个避坑
一、免费额度有限，视频配额紧，别当生产。 Free/default 档文本 20 RPM，图片按分辨率限 RPM，视频按 RPM+配额——视频是配额最紧的。拿它做原型验证、个人项目、内容创作没问题；要上生产环境扛流量，先在 platform.agnes-ai.com 看清楚档位和限额，免费档扛不住生产负载。
二、视频是异步任务，要轮询。 agnes-video-v2.0 走 /v1/videos，提交后返回 task_id，你得轮询任务状态直到完成，不是同步拿结果。第一次用容易写成同步等待然后卡死。照官方文档的异步轮询模式写，设好超时和重试。
三、中国站与国际站模型/额度可能差异，以官方为准。 agnes-ai.cn 和 agnes-ai.com 是两个站点，模型清单、免费额度、可用功能可能不完全一致。国内开发优先用中国站，但具体能力以 platform.agnes-ai.com 实时显示为准，别想当然认为两边完全对等。
八、常见问题
Q：Agnes AI 真的免费吗？有隐藏费用吗？ A：有免费档（Free/default），文本 20 RPM、图片按分辨率限速、视频按配额，不收钱。但免费额度有限，超出或商用高频要升档——具体价格以 platform.agnes-ai.com 为准。"免费"指有可用免费额度起步，不是无限免费。
Q：国内能用吗？要梯子吗？
A：不用。Agnes 有中国站 agnes-ai.cn，国内直连可用，这是它和多数海外免费网关最大的区别。API base 用 https://apihub.agnes-ai.com/v1。
Q：和 OpenAI 官方 API 完全一样吗？
A：接口兼容（端点命名、参数结构一致），openai SDK 改 base_url 和 api_key 就能用。但模型本身是 Agnes 自家的（agnes-2.5-flash 等），不是 GPT，能力和表现不同。视频端点 /v1/videos 是 Agnes 扩展，OpenAI 官方没有完全对应的同步视频 API。
Q：能让 Claude Code / Codex 直接用吗？
A：能。jomeswang/agnes-ai-skill（58★，MIT）是 Agent Skill，支持 Codex、Claude Code、OpenClaw、Claude Desktop、Hermes、WorkBuddy、Cherry，把 Agnes 接成这些 agent 的模型后端。
Q：免费额度用完了怎么办？
A：升档到付费档（以官方为准），或者用 lcy362/agnes-video-generator 开源自托管零成本出视频、把高频任务搬到本地。本站 Agnes 免费多模态工作流 SOP 专门讲怎么搭零成本工作流。
参考来源