一、基础背景

     Agnes AI 是新加坡 Sapiens AI 公司推出的全栈多模态 AI 平台，主打无限期免费 API 服务，核心面向开发者、创作者与团队办公场景，团队源自南洋理工、新加坡国立大学等院校AITOP100。

二、两大产品形态

1. 开发者 API 平台（最热门）

      提供兼容 OpenAI 格式的接口，文本 / 图像 / 视频模型永久免费、无需绑定信用卡，个人 / 小开发者无成本接入开发工具、AI 应用、自动化工作流今日头条。 三大核心模型：

1. Agnes-2.0-Flash（文本大模型）
   • 上下文窗口最高 512K（灰度 100 万），擅长对话、代码、工具调用、AI 智能体 Agent、识图理解；在 Agent 专项榜单排名靠前wiki.agnes...。
2. Agnes Image 2.1 Flash（图像模型）
   • 文生图、图生图、修图，支持最高 4K（4096×4096）高清输出。
3. Agnes Video V2.0（视频模型）
   • 文生视频、图生视频，原生同步生成音频，支持 720P/1080P。

优势：改少量代码就能替换 GPT、Midjourney、Runway 等付费接口，适合搭建聊天机器人、素材生成工具、自动化后台任务wiki.agnes...。

2. 面向普通用户的协作办公端（Agnes App）

一站式团队 AI 协作工作台：

• 多人实时文档 / 幻灯片协同编辑；
• 独创共享团队记忆，跨项目保存任务、历史对话，长文档连贯处理；
• 内置 AI 写作、数据分析、思维导图、多语言翻译；
• 基于自研 7B 参数 Agnes-R1 模型，支持复杂多步骤任务拆解、自动工具调用 Agent 工作流AITOP100

三、核心特色

1. 真正永久免费：文本、图片、视频 API Token 全部 0 元，无限时试用、无额度上限（仅限制每分钟请求数 RPM）抖音；
2. 覆盖 108 个国家，上线短时间总调用 Token 超 3.12 万亿，大量独立开发者、小创业项目在用；
3. 多模态一体化：一套 API Key 同时调用文字、图像、视频能力；
4. 兼顾普通用户可视化办公与开发者底层模型调用两种需求。

四、适用人群

• 程序员：低成本搭建 AI 工具、自动化脚本、智能客服；
• 设计师 / 剪辑：免费批量生成插画、短视频素材；
• 职场团队：多人协同写方案、做项目管理、自动整理资料。

五、Agnes AI API 完整开发

一、前置核心信息（必记）

1. 基础接口配置

• Base URL：https://apihub.agnes-ai.com/v1
• 认证方式：请求头 Authorization: Bearer {你的API Key}
• 兼容协议：完全兼容 OpenAI v1 接口格式，原有 OpenAI 代码仅改 2 个参数即可切换

2. 可用模型列表

模型名称	用途	接口地址
agnes-2.0-flash	对话 / 代码 / 识图 / Agent	/chat/completions
agnes-image-2.1-flash	文生图、图生图、4K 绘图	/images/generations
agnes-video-v2.0	文生视频、图生视频（带音频）	/videos

二、注册并获取 API Key

1. 访问开发者平台：https://platform.agnes-ai.com/  
2. 注册登录：支持邮箱、Google、GitHub 登录，无需手机号
3. 进入密钥页面：侧边栏「设置」→「API 密钥」

         

4、点击创建新密钥，自定义名称（如 my-dev-key）

5、复制生成的 sk-xxxx 密钥，仅展示一次，丢失需重新创建

三、使用方式

 方式 1：Python 快速调用（最常用，兼容 openai 库）

安装依赖包：pip install openai

1、文本对话模型

from openai import OpenAI

client=OpenAI(
    api_key="sk-你的密钥",
    base_url="https://apihub.agnes-ai.com/v1"
)

# 普通对话
response = client.chat.completions.create(
    model="agnes-2.0-flash",
    messages=[
        {"role": "user", "content": "你好，你是谁？"},
        {"role": "assistant", "content": "你好，我是AgnesAI。"},
        ],
    temperature=0.7, # 控制回复的随机性，数值越高回复越随机
    stream=False  # 是否流式输出，如果为True，则可以实时获取回复内容
 
)

print(response.choices[0].message.content)

  运行效果：

  

2、多模态识图（传入图片 URL）

from openai import OpenAI

client=OpenAI(
    api_key="sk-你的密钥",
    base_url="https://apihub.agnes-ai.com/v1"
)

# 普通对话
response = client.chat.completions.create(
    model="agnes-2.0-flash",
    messages=[
        {
            "role": "user",
            "content": [
                {"type":"text", "text": "描述这张图片的内容"},
                {"type":"image_url", "image_url": "https://img0.baidu.com/it/u=3591665277,2616537962&fm=253&app=138&f=JPEG?w=800&h=1333"}
            ]
        }
    ]

)

print(response.choices[0].message.content)

原图：https://img0.baidu.com/it/u=3591665277,2616537962&fm=253&app=138&f=JPEG?w=800&h=1333

运行效果：

3、文生图调用

from openai import OpenAI

client=OpenAI(
    api_key="sk-你的密钥",
    base_url="https://apihub.agnes-ai.com/v1"
)

#图片
response = client.images.generate(
    model="agnes-image-2.1-flash",  # 模型名称
    prompt="在大自然中，有花有草，有一只可爱漂亮的小猫在玩耍，8K高清",  # 描述图片的词语
    size="1280x1024",   # 支持最高4096×4096
    n=1   # 生成图片数量

)

print(response.data[0].url)

单击运行效果：

方式3：第三方 AI 工具一键接入（Cursor/Claude Code） 后面整合！

六、官方文档地址

   完整参数、视频接口、工具调用文档：https://wiki.agnes-ai.com/zh-Hans/docs/overview

总结：

1. 无限免费：文本 / 图片 / 视频无 Token 上限，仅限制每分钟请求数 RPM，过载稍等重试
2. 流式输出 stream：支持打字机实时返回内容，适合聊天界面
3. 工具调用 Tool Calling：可开发 AI 智能体，联网、调用函数、自动化工作流
4. 超长上下文：agnes-2.0-flash 最高 1M 上下文，可直接读取完整项目代码
5. 全模态一套 Key：文本、绘图、视频共用同一个 API 密钥