跳转到主要内容

Agnes AI API 在线文档

一、关于 Sapiens AI

Sapiens AI 是 Agnes AI 的母公司,专注于研发先进的多模态 AI 模型与基础设施,致力于为下一代智能应用、创意应用和交互式产品提供强大的 AI 能力支持。 我们的使命是: 让世界级 AI 属于每一个人。 通过 Agnes AI,我们希望降低高质量 AI 技术的使用门槛,让开发者、创作者、创业团队和企业都能够以更简单、更稳定、更低成本的方式,将先进的 AI 能力接入自己的产品与业务中。 我们相信,世界级 AI 不应该只属于少数大型机构,而应该成为每一位开发者都能使用、每一个产品都能集成、每一个用户都能受益的基础能力。 Agnes AI,让世界级 AI 属于每一个人。

二、Agnes AI API 简介

Agnes AI API 为开发者提供统一、稳定、易接入的多模态 AI 模型服务,支持文本、图像、视频等多种生成与理解能力。 开发者可以通过 Agnes AI API 快速构建 AI 原生应用,包括但不限于:
  • AI 对话与文本生成
  • 逻辑推理与内容理解
  • 文生图与图像编辑
  • 图生视频与视频生成
  • 音视频同步生成
  • Agent 工具与自动化工作流
  • 创意内容生成与多模态交互应用
Agnes AI API 兼容 OpenAI 风格接口,方便开发者基于现有代码快速迁移和接入,减少开发成本,提高集成效率。

三、核心能力

Agnes AI API 目前主要支持以下核心能力:

1. 文本生成与推理

支持高质量文本生成、内容续写、摘要提取、逻辑推理、问答对话、代码辅助和 Agent 任务处理等场景。 适用场景包括:
  • AI 聊天助手
  • 内容创作
  • 文档总结
  • 智能问答
  • 代码生成
  • Agent 自动化任务

2. 图像生成与编辑

支持根据文本提示词生成高清图像,也支持对已有图片进行修改、优化和风格化处理。 适用场景包括:
  • 文生图
  • 图像编辑
  • 商品图生成
  • 创意海报生成
  • 角色形象生成
  • 社交媒体素材制作

3. 视频与音视频同步生成

支持生成高质量视频内容,并可支持音频与画面同步生成,减少后期制作流程,提升内容生产效率。 适用场景包括:
  • AI 视频生成
  • 图生视频
  • 短视频创作
  • 创意广告素材
  • 角色动画
  • 音视频同步内容生成

4. 多模态理解与创作

支持文本、图像、视频等多种模态能力组合,帮助开发者构建更智能、更自然的交互体验。 适用场景包括:
  • 多模态 AI 助手
  • 图片理解
  • 视频理解
  • 创意工作流
  • AI 社交互动
  • 教育、娱乐与生产力工具

四、模型能力概览

Agnes AI 提供多类型模型能力,包括文本模型、图像模型、视频模型和多模态模型。 其中,Sapiens AI 的模型体系包括高精度的 Claw 系列模型,以及面向创意生成场景的图像、视频和音视频模型。 这些模型可以帮助开发者快速完成从内容理解、文本生成,到图像生成、图像编辑、视频生成的完整 AI 能力接入。

五、接口兼容性

Agnes AI API 兼容 OpenAI 风格接口。 如果你已经使用过 OpenAI-Compatible API,通常只需要修改以下配置即可完成接入:
  • Base URL
  • API Key
  • Model Name
这种兼容方式可以帮助开发者快速迁移现有项目,降低接入成本,并减少重复开发工作。

六、Base URL

所有 API 请求都应基于以下 Base URL 发起: ```plain text https://apihub.agnes-ai.com/v1 ``` 请确保请求路径基于该地址拼接,避免因路径错误导致接口请求失败。

七、身份认证

所有 API 请求都需要通过 API Key 进行身份认证。 请在请求 Header 中携带以下参数,并将 YOUR_API_KEY 替换为你自己的有效 API Key: ```plain text Authorization: Bearer YOUR_API_KEY ```

八、安全提醒

API Key 属于敏感信息,请妥善保管。 请勿将 API Key 暴露在以下位置:
  • 公开代码仓库
  • 前端客户端代码
  • 截图或录屏内容
  • 公开文档
  • 可被他人访问的配置文件
如发现 API Key 泄露,建议立即在控制台删除或重置该 Key,以避免产生非授权调用。

九、快速开始

你可以按照以下步骤快速开始使用 Agnes AI API:

第一步:创建 API Key

登录 Agnes AI 控制台,进入 API Key 管理页面,创建并复制你的 API Key。

第二步:选择模型

根据你的使用场景选择对应模型,例如文本模型、图像模型、视频模型或多模态模型。

第三步:配置请求地址

将 API Base URL 配置为: ```plain text https://apihub.agnes-ai.com/v1 ```

第四步:发起 API 请求

在请求 Header 中加入 API Key,并按照 OpenAI-Compatible API 格式发起请求。

十、适用开发场景

Agnes AI API 适合用于以下产品和业务场景:
  • AI 聊天应用
  • AI 搜索与研究工具
  • AI 写作与办公工具
  • AI 图片生成工具
  • AI 视频生成工具
  • AI 角色与互动应用
  • AI 社交产品
  • Agent 自动化平台
  • 创意内容生产平台
  • 教育、娱乐、电商与营销工具

十一、文档说明

本文档用于帮助开发者快速了解 Agnes AI API 的基础能力、接入方式和使用规范。 如需查看具体模型参数、请求示例、返回格式和错误码说明,请继续阅读对应模型的详细接入文档。