能力全景
Agents Run
调用袋袋专家(AI Agent),通过 SSE 流式获取回复。支持多轮对话、工具调用、记忆等高级能力。
Chat Completions
OpenAI 兼容的对话补全接口。支持
profy-* 模型名直接调用专家,OpenAI SDK 零改动接入。Events
上报自定义计费事件,用于 App 的按次计费场景。支持幂等性保障,防止重复扣费。
Models
获取平台可用模型列表及其能力信息,帮助你选择合适的模型。
Meters
查询 App 的计费计量器配置,了解事件对应的扣费规则。
两种认证方式
袋袋平台提供两种认证方式,适用于不同场景:- API Key
- OAuth Bearer
适用场景:服务端直接调用、脚本、后台任务
- 以
sk-pro-为前缀 - 在请求头中通过
Authorization: Bearer sk-pro-xxxx传递 - 积分从开发者自己的账户扣除
- 在 Platform Console 创建和管理
核心概念
专家(数字专家)
专家是袋袋平台的核心产品形态——一个具备人格、工具、记忆和技能的 AI Agent。通过/v1/agents/run 端点,你可以以 API 方式调用任意已发布的专家。
Expert-as-Model
通过/v1/chat/completions 端点使用 model="profy-<identifier>" 格式的模型名,即可用标准 OpenAI SDK 调用袋袋专家。专家背后的完整 Agent 能力(人格、工具、记忆、技能)对开发者完全透明——你只需像调用 gpt-4o 一样调用它。这让袋袋创作者定义的垂直领域 AI Agent 可以无缝接入任何支持 OpenAI API 的工具链(LangChain、Cursor 等)。
App(外部应用)
App 是通过 OAuth + Events API 接入袋袋身份与计费体系的外部应用。App 开发者可以利用袋袋的用户系统和积分计费,快速实现商业化。计费模型
开发者控制台
Platform Console 是你管理 API 接入的统一控制台:- API Keys:创建、查看、吊销 API Key
- Usage Stats:查看调用量趋势和分布
- Call Logs:搜索和查看每一次 API 调用的详情
- Playground:在线测试 API(即将推出)
app.profy.cn 共享登录态——在主站登录后即可直接访问。
SDK
袋袋提供 Python 和 TypeScript 两种官方 SDK,封装了认证、流式解析、错误处理等细节:MCP Server
袋袋提供 MCP(Model Context Protocol)Server,可直接在 Cursor、Codex 等 IDE 中使用。通过 MCP,你无需离开编辑器即可完成专家创建、配置、发布和收益查看等全部流程。 详情参阅 MCP Server 集成。下一步
快速开始
5 分钟完成第一次 API 调用
认证指南
了解 API Key 和 OAuth 的详细用法
API 参考
浏览完整的 API 端点文档
构建 App
学习如何构建一个袋袋 App

