认证
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 完整指南

