机器支付协议（MPP）

通过 HTTP 402、Tempo USDC 与支付回执，按次付费调用 TwexAPI 请求。

机器支付协议（MPP）

TwexAPI 对选定的按次付费请求支持机器支付协议（MPP）。MPP 客户端可用 Tempo USDC 为符合条件的请求付费，而无需发送 TwexAPI API 密钥。

MPP 适合只需为实际请求付费的AI Agent、脚本与服务。它不会替代未列在下方端点上的 API 密钥认证。

支持的操作

操作	说明	支付方式	价格
`POST /twitter/advanced_search/page`	返回一页基于游标的高级 Twitter 搜索结果。	Tempo USDC	每页 USD 0.0001

服务器仍是当前支付报价的权威来源。请读取请求返回的 WWW-Authenticate: Payment 挑战，而非硬编码金额、收款方或支付凭据格式。

支付流程

不带 API 密钥向已启用 MPP 的端点发送普通请求。
服务器返回 402 Payment Required 及 WWW-Authenticate: Payment 挑战。
MPP 客户端按挑战描述的 Tempo USDC 请求付款，并以 Authorization: Payment 凭据重试。
结算成功的响应包含 Payment-Receipt 头。请同时检查 HTTP 状态与响应体；回执仅确认支付已结算。

支付挑战

HTTP/2 402 Payment Required
WWW-Authenticate: Payment id="abc...", realm="api.twexapi.io", method="tempo", intent="charge", request="eyJhbW91bnQiOi..."

挑战中的 request 值为当前支付指令。对 MPP 客户端视为不透明数据；勿从缓存示例解析或构造支付。

付费重试与回执

POST /twitter/advanced_search/page HTTP/2
Host: api.twexapi.io
Authorization: Payment eyJjaGFsbGVuZ2UiOnsi...
Content-Type: application/json

{"searchTerms":["openai"],"sortBy":"Latest"}

HTTP/2 200 OK
Payment-Receipt: eyJzdGF0dXMiOiJzdWNjZXNzIiwi...
Content-Type: application/json

MPP 与 API 密钥

选择	适用场景
MPP	需要对支持的操作进行匿名、按次付费请求。
API 密钥	需要完整 TwexAPI 能力、账号级额度，或未发布 MPP 报价的端点。

MPP 支付使用充值了 USDC 的 Tempo 钱包。将钱包私钥放在环境变量中，切勿提交到源码、日志或聊天记录。

下一步

MPP 快速开始 — 安装客户端、配置 Tempo 钱包并完成付费搜索请求。
API 概览 — 使用 API 密钥认证并浏览完整 TwexAPI 端点目录。