Skip to main content
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

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

quantity
integer
default:1

Number of 100-credit packs to preload in the checkout (adjustable on the checkout page)

Required range: x >= 1
promoCode
string

Optional promo code to apply at checkout. Invalid or expired codes return a 400.

Response

200 - application/json

Successful response

url
string

Stripe URL to open in a browser