跳转到主要内容
袋袋开发者平台为你提供了一套完整的 API,让你能够将 AI 专家的能力集成到自己的应用中。无论你是想在后端服务中调用 AI Agent,还是构建一个面向终端用户的 AI 应用,袋袋平台都能满足你的需求。

能力全景

Agents Run

调用袋袋专家(AI Agent),通过 SSE 流式获取回复。支持多轮对话、工具调用、记忆等高级能力。

Chat Completions

OpenAI 兼容的对话补全接口。支持 profy-* 模型名直接调用专家,OpenAI SDK 零改动接入。

Events

上报自定义计费事件,用于 App 的按次计费场景。支持幂等性保障,防止重复扣费。

Models

获取平台可用模型列表及其能力信息,帮助你选择合适的模型。

Meters

查询 App 的计费计量器配置,了解事件对应的扣费规则。

两种认证方式

袋袋平台提供两种认证方式,适用于不同场景:
适用场景:服务端直接调用、脚本、后台任务
  • 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(即将推出)
Platform Console 与主站 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