Machine Payments Protocol (MPP)

HTTP 402, Tempo USDC, 결제 영수증으로 TwexAPI 요청당 과금 요청.

Machine Payments Protocol (MPP)

TwexAPI는 선택 pay-per-use 요청에 Machine Payments Protocol (MPP)를 지원합니다. MPP 클라이언트는 TwexAPI API 키 대신 Tempo USDC로 적격 요청 비용을 지불할 수 있습니다.

MPP는 만든 요청만 지불해야 하는 에이전트, 스크립트, 서비스에 유용합니다. 아래에 나열되지 않은 엔드포인트의 API 키 인증을 대체하지 않습니다.

지원 작업

Operation	What it does	Payment method	Price
`POST /twitter/advanced_search/page`	고급 Twitter 검색 결과 cursor 기반 한 페이지 반환.	Tempo USDC	페이지당 USD 0.0001

서버가 현재 결제 offer의 권위입니다. 금액, 수신자, 결제 credential 형식을 하드코딩하지 말고 요청에 대한 WWW-Authenticate: Payment challenge를 읽으세요.

결제 흐름

API 키 없이 MPP 지원 엔드포인트에 일반 요청 전송.
서버가 402 Payment Required와 WWW-Authenticate: Payment challenge로 응답.
MPP 클라이언트가 challenge의 Tempo USDC 요청을 결제하고 Authorization: Payment credential으로 재시도.
정산된 응답에 Payment-Receipt 헤더 포함. HTTP status와 응답 본문 모두 확인; 영수증은 결제 정산만 확인.

Payment challenge

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

challenge의 request 값에 현재 결제 지시가 있습니다. MPP 클라이언트용 opaque 데이터로 취급; 캐시 예제로 결제를 파싱·구성하지 마세요.

Paid retry and receipt

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 키

Choose	When it fits
MPP	지원 작업에 대한 익명 pay-per-use 요청이 필요할 때.
API key	전체 TwexAPI surface, 계정 크레dit, MPP offer를 게시하지 않는 엔드포인트가 필요할 때.

MPP 결제는 USDC로 충전된 Tempo wallet을 사용합니다. wallet private key는 환경 변수에 두고 소스, 로그, 채팅 기록에 커밋하지 마세요.

다음 단계

MPP quickstart — 클라이언트 설치, Tempo wallet 설정, 유료 검색 요청.
API overview — API 키 인증 및 전체 TwexAPI 엔드포인트 카탈로그.