Top Up Media Credits
Billing & Usage
Top Up Media Credits
Get a Stripe checkout link to buy extra media credits as a one-time purchase
GET
Top Up Media Credits
For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.
Overview
Get a Stripe Checkout link for a one-time media-credit top-up. This endpoint only returns a URL — nothing is charged until the user opens the link and completes payment in the browser. Top-ups work like this:- Credits are sold in packs of 100 media credits
- The purchase is one-time — it doesn’t change your subscription or renewal date
- Top-up credits never expire; monthly plan credits are always spent first
- Media credits only (clipping, captions, reframing, transcription, audiograms, editor processing) — AI credits can’t be topped up
Any valid API key on an active paid plan can call this endpoint — including member keys. (In the web app the top-up button is admin-only; the API is deliberately lower-friction.)
Query Parameters
integer
default:"1"
Number of 100-credit packs to preload in the checkout. Must be ≥ 1. The user can still adjust the quantity on the checkout page (up to 1,000 packs).
string
Optional promo code to apply at checkout. Invalid or expired codes return a
400. When omitted, any default top-up discount is applied automatically.Response
string
Stripe Checkout URL. Open it in a browser to review the purchase and pay. Credits are added to the account within a few seconds of payment.
Example Request
Example Response
Rate Limiting
This endpoint is subject to the standard rate limit of 10 requests per minute.Next Steps
- Check your balance first with Get Plan Usage
- How top-ups behave (expiry, freezing, spend order): see the help-center guide
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Number of 100-credit packs to preload in the checkout (adjustable on the checkout page)
Required range:
x >= 1Optional promo code to apply at checkout. Invalid or expired codes return a 400.
Response
200 - application/json
Successful response
Stripe URL to open in a browser