Skip to main content
调用一个袋袋专家(AI Agent),通过 SSE 流式获取完整回复,包括文本输出、工具调用和 token 用量。

认证

string
必填
Bearer sk-pro-xxxx(API Key)或 Bearer <access_token>(OAuth)

请求体

string
必填
专家的唯一标识符。你可以在专家的市场页面或 Studio 中找到它。
string
必填
发送给专家的消息内容。
string
会话 ID,用于多轮对话。首次调用无需传入,响应头 X-Session-Id 中会返回新的 session_id。
string
指定使用的模型。不传则使用平台默认模型。可通过 GET /v1/models 查询可用模型。
string[]
附件文件 ID 列表,最多 20 个。ID 由 上传文件 接口返回。 平台会把这些文件放进专家的沙盒(/home/user/uploads/),专家可以用 read / grep 读取。只接受文件 ID,不接受 URL —— 平台不会去下载你提供的任意链接,所以你不需要把私有文档暴露成公开可读的链接。

请求示例

响应格式

响应为 SSE(Server-Sent Events)流,事件使用层级点分命名(对标 OpenAI Responses API)。响应头中包含 X-Session-Id,用于后续多轮对话。

SSE 事件类型

生命周期事件

输出事件

工具调用事件

用量事件

流式解析示例

计费

按 token 用量计费(计费单位 token_split),积分从 API Key 所属账户扣除,而不是从 X-End-User-Id 指定的终端用户扣除——终端用户 ID 只用于会话隔离与用量归因,不是计费主体。 计算方式:ceil(输入tokens × 输入费率 ÷ 1e6) + ceil(输出tokens × 输出费率 ÷ 1e6)(输入与输出分别取整后相加)。各模型的费率是运营数据,以模型选择器 / 模型列表接口的当前值为准;算法固定,完整说明见 计费公式 本次调用的实际消耗从 usage.token 事件读取——这是权威值,不要用自己的 tokenizer 估算后当账单用。

错误码

下一步

上传文件

把文件交给专家读取

对话补全

OpenAI 兼容的对话补全接口

Python SDK

Python SDK 完整指南