For the complete documentation index, see llms.txt. This page is also available as Markdown.

Agentic Payments

Add credits via MPP (Machine Payments Protocol)

post

Pay via MPP to add credits and obtain (or refresh) an API key, then call the standard /v1/openai/* endpoints with it as a Bearer token.

Payment rails: every challenge offers both, as two separate WWW-Authenticate header instances. Pay whichever one you can and retry with that rail's credential:

  • Stripe (method="stripe"): pay with a Stripe card or Link Shared Payment Token. Retry with Authorization: Payment <stripe-credential>.

  • Tempo (method="tempo"): pay with on-chain USDC on the Tempo network. Retry with Authorization: Payment <tempo-credential>.

Amount: defaults to $5.00; pass amount_cents to choose a size (clamped to the credit-purchase limits). Send the same amount_cents on the paid retry as on the challenge call.

Headers:

  • Authorization: Payment <credential> — the MPP payment credential.

  • X-API-Key: sk_… (optional) — refill an existing org; omit to mint a new org + key (returned once in the response body).

Body
amount_centsinteger · min: 100 · max: 1000000Optional

Top-up size in cents. Defaults to 500 ($5.00). Range $1.00–$10,000.00. Must be identical on the challenge call and the paid retry.

Default: 500
Responses
200

Successful Response

application/json
organization_idstringRequired
credited_centsintegerRequired
api_keystring · nullableOptional
api_key_idstring · nullableOptional
post/v1/mpp/topup

Last updated

Was this helpful?