---
title: "机器支付协议（MPP）"
description: "通过 HTTP 402、Tempo USDC 与支付回执，按次付费调用 TwexAPI 请求。"
---

# 机器支付协议（MPP）

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

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

## 支持的操作

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

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

## 支付流程

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

### 支付挑战

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

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

### 付费重试与回执

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

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

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

## MPP 与 API 密钥

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

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

## 下一步

- [MPP 快速开始](/mpp/quickstart) — 安装客户端、配置 Tempo 钱包并完成付费搜索请求。
- [API 概览](/api-reference/overview) — 使用 API 密钥认证并浏览完整 TwexAPI 端点目录。