跳转到主要内容
调用一个袋袋专家(AI Agent),通过 SSE 流式获取完整回复,包括文本输出、工具调用和 token 用量。

认证

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

请求体

expert_identifier
string
必填
专家的唯一标识符。你可以在专家的市场页面或 Studio 中找到它。
message
string
必填
发送给专家的消息内容。
session_id
string
会话 ID,用于多轮对话。首次调用无需传入,响应头 X-Session-Id 中会返回新的 session_id。
model
string
指定使用的模型。不传则使用平台默认模型。可通过 GET /v1/models 查询可用模型。

请求示例

响应格式

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

SSE 事件类型

生命周期事件

输出事件

工具调用事件

用量事件

流式解析示例

计费

按 token 用量计费(METERED),积分从调用者账户扣除。具体费率以产品内实时显示为准。你可以在 usage.token 事件中获取本次调用的 token 消耗。

错误码

下一步

对话补全

OpenAI 兼容的对话补全接口

Python SDK

Python SDK 完整指南