袋袋AI API 接入指南：把 AI 专家集成到你的应用
袋袋AI 提供哪些 API？本文介绍 Agents Run、Chat Completions、Events、Models、Meters、API Key、OAuth 和官方 SDK，帮助开发者快速规划接入方案。
袋袋AI API 能解决什么问题？
开发者可以把平台上的 AI 专家集成到自己的后端、SaaS、企业工具或面向终端用户的 App 中。专家背后的人格、技能、记忆和工具对调用方保持透明，产品只需要关心输入、输出、权限和计费。
五类核心 API 能力
- Agents Run：通过 /v1/agents/run 调用已发布专家，支持多轮对话、工具调用、记忆和 SSE 流式回复。
- Chat Completions：通过 /v1/chat/completions 使用 OpenAI 兼容格式，模型名采用 profy-
，便于接入已有 SDK 和工具链。 - Events：为外部 App 上报自定义计费事件，支持按次计费和幂等性保障。
- Models：查询平台可用模型和能力信息，帮助选择合适的模型。
- Meters：查看 App 的计量器配置，了解事件与扣费规则。
API Key 还是 OAuth？
API Key 适合服务端直接调用、脚本和后台任务。密钥以 sk-pro- 开头，通过 Bearer Token 放在请求头中，费用从开发者账户扣除。密钥应保存在服务端密钥管理系统，不能写入前端代码或提交到仓库。
OAuth Bearer 适合需要让用户登录并授权的外部 App。App 可以复用袋袋的身份体系，再通过 Events API 上报自身的按次计费事件。
典型接入流程
- 在 Platform Console 创建 API Key 或配置 OAuth 应用；
- 确认要调用的专家标识符和计费模型；
- 先用 Models 或 Playground（开放后）验证能力；
- 在服务端调用 Agents Run 或 Chat Completions；
- 处理流式响应、错误、超时和重试；
- 通过 Events 上报业务事件，并在 Console 查看调用日志和用量。
SDK 与开发工具
平台提供 Python 和 TypeScript 官方 SDK，用于封装认证、流式解析和错误处理。若团队使用 Cursor、Codex 等 IDE，还可以通过 MCP Server 在编辑器内管理专家创建、配置、发布和收益查看。
计费设计建议
平台支持按 Token 用量计费（METERED）、按次计费（PER_USE）和一次性买断（ONE_TIME）。面向用户的产品应在自己的界面中清楚说明扣费时机，调用 Events 时使用稳定的幂等键，避免网络重试造成重复扣费。
袋袋AI API 的优势是把“专家能力”和“应用产品”分开：创作者负责专业方法，开发者负责体验、业务流程和商业化。建议先从一次简单的 Agents Run 调用开始，再逐步加入 OAuth、事件计费和 SDK。
Related articles
Guides过度承诺导致交付焦虑：先把你真正能负责的结果写清楚
知识服务为了吸引购买，常用“保证变现”“快速转型”等大结果承诺。成交之后，流量、执行和市场变化都会变成创作者的心理负担。缓解交付焦虑需要重新划定可控范围：清楚说明会处理哪些材料、交付什么、客户需要承担什么，以及什么情况应该停止或转向其他帮助。
Guides客户说“我考虑一下”：犹豫常常早在报价前就开始了
客户收到报价后说“我考虑一下”，价格只是其中一种可能。很多犹豫来自问题没有说清、服务结果难以想象，或者客户还没确认这件事值得现在处理。与其报价后反复催促，更有效的做法是让双方在报价前对同一个问题达成理解，并给尚未准备好的人一次低压力的判断体验。
Guides选赛道看兴趣还是付费：别用想象比较两种人生
选知识赛道时，只看兴趣容易忽略长期重复，只看付费又可能进入自己不愿持续研究的领域。更可靠的方法，是让两个方向接受规模接近的真实测试：面对相似数量的人，交付相近大小的结果，再比较需求、完成感、案例积累和后续意愿。赛道往往在做过几轮之后才逐渐清楚。
An AI expert marketplace, ready when you are
Describe what you need and let AI handle it. Preview results, pay only when satisfied.
Get started free