付费请求的工作流程
1
不带 key 调用端点
发送普通请求,例如
GET https://api.aisa.one/apis/v1/polymarket/oi,不附加 Authorization 头。2
读取 402 质询
AIsa 返回
402 Payment Required,响应体为 application/problem+json,并附带 WWW-Authenticate: Payment ... 头。质询指定了方法(目前为 tempo)、意图(charge)、过期时间以及 request 参数中的付款条款。实时质询即为该请求的权威价格。3
付款并重试
MPP 客户端完成质询付款,然后使用
Authorization: Payment <credential> 重新发送相同请求。成功后,响应携带数据,客户端保留付款凭证。mppx 以及其他 SDK 均列于 mpp.dev。同一请求使用 Authorization: Bearer $AISA_API_KEY 则跳过质询,直接从你的 AIsa 余额扣费。
哪些端点支持 MPP
完整列表维护在https://api.aisa.one/openapi.json(OpenAPI 3.1)的支付发现文档中。其中每个操作都包含 x-payment-info 及其 MPP 报价,并记录了 402 响应。目前覆盖预测市场、金融数据和网页搜索等同步只读数据;模型、账户端点(如积分余额)以及写操作需要 API key。
设计流程前请以该文档为准,而非本页面:未列于其中的端点不支持 MPP。文档不列出 MPP 价格;发现文档中的价格仅供参考,实时质询中的条款才是实际费用。
需要预先确定的控制措施
付费是具有财务副作用的操作。将其视为与其他特权操作一样对待,在智能体自主付费之前确定以下控制:
将工具选择与授权分开:智能体可以判断某个付费端点有用,但不一定被允许购买。先估算费用,与策略比较,在策略要求时获取批准,执行一次,然后同时验证凭证和数据后再记录结果。
智能体安全规则
- 持有钱包、key 或已连接的 MCP 服务器并不等于有权消费。
- 绝不打印钱包密钥、凭证、签名或授权头。
- 不要循环发起计费重试;每次新请求都是一笔新费用。
- 付款前阅读质询条款,超出批准金额时立即停止。
- 将已结算的付款视为“已付费”,而非“任务成功”:还须检查响应内容。
相关
计费与积分
余额计费、费用报价和按 key 限额的工作方式。
自主 API 采购
包含批准和对账步骤的完整采购工作流。
智能体发现
Agent Card、OpenAPI 和 MCP 入口,面向自主智能体。
安全与隐私
密钥处理、操作与支付安全。