RawFrame
API referenceAccount

Start a credit top-up

POST
/v1/account/topups

Creates a Stripe Checkout Session. Redirect the user to url; credits are added when the payment succeeds (usually seconds later). A paid invoice is emailed for each top-up. Requires the billing:write scope.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key, e.g. rf_live_3f9k2q_….

Header Parameters

Idempotency-Key?string

Retries with the same key and body within 24 h return the original response.

Lengthlength <= 255

Request Body

application/json
  1. body
amount_micros*integer

Whole cents, $10 to $10,000. For example 25000000 is $25.

Formatint64
Range10000000 <= value <= 10000000000
success_url*string

Where Checkout returns after payment. HTTPS.

Formaturi
cancel_url*string

Where Checkout returns if the user cancels. HTTPS.

Formaturi
save_payment_method?boolean

Save the card for auto-recharge.

Defaulttrue

Response Body

Checkout Session created.

application/json
  1. response
object*unknown
id*string

Stripe Checkout Session id.

url*string
Formaturi
amount_micros*integer
Formatint64
Example Request
curl -X POST 'https://api.rawframe.dev/v1/account/topups' \  -H 'Content-Type: application/json' \  -d '{  "amount_micros": 10000000,  "success_url": "http://example.com",  "cancel_url": "http://example.com"}'
Example Response
{  "object": "checkout_session",  "id": "string",  "url": "http://example.com",  "amount_micros": 0}

API reference

Every endpoint and webhook event, generated from the OpenAPI spec.

Export usage as CSV GET

One row per generation created between `start` and `end` (inclusive, UTC dates), oldest first. Columns: `generation_id, created_at, completed_at, model, served_by, type, mode, status, error_code, billed_unit, billed_quantity, charge_micros, charge_usd, api_key_id, metadata`. At most 100,000 rows; narrow the range if you get `range_too_large`. Requires `account:read`.