这个资源提供什么What this offer provides
Agnes AI 官方文档提供 OpenAI 兼容 API，官方定价页逐项列出中国站模型的刊例价与现价，其中 agnes-3.0-flash、agnes-2.5-flash、agnes-image-2.0/2.1/2.5-flash与 agnes-video-2.5-flash 现价均为 ¥0（agnes-video-v2.0 已于 2026-09-25 下线）；官方同时运营国内站（api.agnes-ai.cn）与国际站（apihub.agnes-ai.com）两套入口，国内站可在大陆直连。适合作为可直接试用的多模态 API 入口，但不是无限免费承诺：限速、优惠期与模型可用性都可能调整。Agnes AI documents an OpenAI-compatible API, and its official pricing page lists every China-site model with list and current prices: agnes-3.0-flash, agnes-2.5-flash, the agnes-image-2.0/2.1/2.5-flash line, and agnes-video-2.5-flash all currently price at zero (agnes-video-v2.0 was retired on 2026-09-25). It runs two official entry points - a mainland-CN host (api.agnes-ai.cn) and a global host (apihub.agnes-ai.com). A practical multimodal API entry point, not an unlimited-free promise.
关键信息Key details
快速上手Quick start
通过 Agnes AI 的 OpenAI 兼容 API 调用文本、图片和视频模型；中国大陆用国内站地址，其他地区用国际站地址；免费/default 层受速率限制Call Agnes AI text, image and video models through its OpenAI-compatible API; mainland China uses the CN host and other regions use the global host. Free/default access is rate limited
注册与接入步骤Registration and access steps
准备条件Prerequisites
- Agnes AI account
- Agnes AI API key
- 在 platform.agnes-ai.cn（国内站）或 platform.agnes-ai.com（国际站）注册并创建 API Key；官方称原国际站用户无需重新注册，Key 也无需更换platform.agnes-ai.cn（ ） platform.agnes-ai.com（ ） API Key； ，Key
- 中国大陆环境把 Base URL 设为 https://api.agnes-ai.cn/v1，其他地区设为 https://apihub.agnes-ai.com/v1Base URL https://api.agnes-ai.cn/v1， https://apihub.agnes-ai.com/v1
- 用目录中的模型 ID 发送 OpenAI 兼容请求，并核对官方文档的最新速率限制与图片/视频请求格式ID OpenAI ，
发送第一条请求Send first request
使用下方命令开始调用。Use the command below to make your first request.
export AGNES_API_KEY="你的 Key"
curl https://api.agnes-ai.cn/v1/chat/completions --header "Authorization: Bearer $AGNES_API_KEY" --header 'Content-Type: application/json' --data '{"model":"agnes-2.5-flash","messages":[{"role":"user","content":"Hello"}]}'使用入口Access paths
| 入口Path | 用途Use | 免费状态Free status | 访问条件Access | 官方链接Official links |
|---|---|---|---|---|
| 国内站入口Access path api | 官方中文文档指定的国内站 Base URL：https://api.agnes-ai.cn/v1（控制台 platform.agnes-ai.cn）Base URL：https://api.agnes-ai.cn/v1（ platform.agnes-ai.cn） | 免费 / 默认层限速访问See official terms | Agnes AI 账号 + API Key；可沿用国际站已有 KeyAgnes AI + API Key； Key | 国内站文档（中文）（ ） ↗ 国内站控制台Official link ↗ |
| 国际站入口Access path api | 官方英文文档指定的国际站 Base URL：https://apihub.agnes-ai.com/v1（控制台 platform.agnes-ai.com）Base URL：https://apihub.agnes-ai.com/v1（ platform.agnes-ai.com） | Free/default rate-limited accessFree/default rate-limited access | Agnes AI account and API keyAgnes AI account and API key | 国际站文档（英文）（ ） ↗ 国际站控制台Official link ↗ |
免费模型逐个看Free models by entry
| 模型Model | 上下文窗口Context window | 免费额度Free quota | 备注Notes |
|---|---|---|---|
agnes-3.0-flashagnes-3.0-flash新一代文本模型（文本 + 图像 URL）（ + URL） | 512K tokens512K tokens | 文本 实际 20 RPM20 RPM | 官方定价页标注现价 ¥0；文档标注最大输出 65,536 Token¥0； 65,536 Token |
agnes-2.5-flashagnes-2.5-flash文本模型（文本 + 图像 URL）（ + URL） | 512K tokens512K tokens | 文本 实际 20 RPM20 RPM | 官方定价页标注现价 ¥0；文档标注最大输出 65.5K¥0； 65.5K |
agnes-image-2.5-flashagnes-image-2.5-flash最新一代图像模型（文生图 / 图生图 / 多图合成）（ / / ） | —— | 图片 1K 20 / 2K 10 / 3K 1 / 4K 1 RPM1K 20 / 2K 10 / 3K 1 / 4K 1 RPM | 官方定价页标注所有输出分辨率档位与输入参考图片当前免费See official terms |
agnes-image-2.1-flashagnes-image-2.1-flash图像模型（文生图 / 图生图 / 多图合成）（ / / ） | —— | 图片 1K 20 / 2K 10 / 3K 1 / 4K 1 RPM1K 20 / 2K 10 / 3K 1 / 4K 1 RPM | 官方定价页标注所有输出分辨率档位与输入参考图片当前免费See official terms |
agnes-image-2.0-flashagnes-image-2.0-flash图像模型（文生图 / 图生图 / 多图合成）（ / / ） | —— | 图片 1K 20 / 2K 10 / 3K 1 / 4K 1 RPM1K 20 / 2K 10 / 3K 1 / 4K 1 RPM | 官方定价页标注所有输出分辨率档位与输入参考图片当前免费See official terms |
agnes-video-2.5-flashagnes-video-2.5-flash视频模型（OpenAI Videos 兼容）（OpenAI Videos ） | —— | 视频 1 RPM1 RPM | 官方定价页标注限时免费，注明可能按模型或活动阶段调整， |
额度以官方页面和控制台实时显示为准；公测或限免额度可能随时调整。Quota follows the official page and console; preview or limited free access can change.
如何使用How to use
通过 Agnes AI 的 OpenAI 兼容 API 调用文本、图片和视频模型；中国大陆用国内站地址，其他地区用国际站地址；免费/default 层受速率限制Agnes AI OpenAI API 、 ； ， ； /default
前置条件Prerequisites
- Agnes AI accountAgnes AI account
- Agnes AI API keyAgnes AI API key
步骤Steps
- 在 platform.agnes-ai.cn（国内站）或 platform.agnes-ai.com（国际站）注册并创建 API Key；官方称原国际站用户无需重新注册，Key 也无需更换platform.agnes-ai.cn（ ） platform.agnes-ai.com（ ） API Key； ，Key
- 中国大陆环境把 Base URL 设为 https://api.agnes-ai.cn/v1，其他地区设为 https://apihub.agnes-ai.com/v1Base URL https://api.agnes-ai.cn/v1， https://apihub.agnes-ai.com/v1
- 用目录中的模型 ID 发送 OpenAI 兼容请求，并核对官方文档的最新速率限制与图片/视频请求格式ID OpenAI ，
官方来源Official sources
Agnes 国内站官方中文文档（agnes-ai.cn/zh-Hans/docs/overview）把 Base URL 写作 https://api.agnes-ai.cn/v1；国际站官方英文文档（agnes-ai.com/en/docs/overview）写作 https://apihub.agnes-ai.com/v1。两个域名在 2026-09-19 无 Key 探测均返回 401「未提供令牌 / Token not provided」，说明端点存活且鉴权正常；国内站解析到大陆 IP，国际站走 Cloudflare。官方定价页（agnes-ai.cn/zh-Hans/docs/pricing）逐项给出中国站模型的人民币刊例价与现价，明确 agnes-2.5-flash 与 agnes-3.0-flash 的输入缓存命中、输入 Token、输出 Token 当前均免费，agnes-image-2.0/2.1/2.5-flash 所有输出分辨率档位与输入参考图片免费，agnes-video-2.5-flash 限时免费；agnes-2.5-pro 与 agnes-video-2.5 为付费；agnes-video-v2.0 已于 2026-09-25 下线、agnes-2.5-pro-beta 文档已下线（2026-10-12 复核）。国内站 Token Plan FAQ 给出免费 / 默认用户的文本、图片、视频 RPM 公开参考值，并注明可能调整。Agnes （agnes-ai.cn/zh-Hans/docs/overview） Base URL https://api.agnes-ai.cn/v1； （agnes-ai.com/en/docs/overview） https://apihub.agnes-ai.com/v1。 2026-09-19 Key 401「 / Token not provided」， ； IP， Cloudflare。 （agnes-ai.cn/zh-Hans/docs/pricing） ， agnes-2.5-flash agnes-3.0-flash 、 Token、 Token ，agnes-image-2.0/2.1/2.5-flash ，agnes-video-2.5-flash ；agnes-2.5-pro agnes-video-2.5 ；agnes-video-v2.0 2026-09-25 、agnes-2.5-pro-beta （2026-10-12 ）。 Token Plan FAQ / 、 、 RPM ， 。