Balance Services

Monitor your account balance and transaction history. Ensure you have sufficient credits for video generation.

GET

/balance

Retrieve your current account balance and credit status.

Response Example

{
  "credits": 1500,
  "is_premium": true,
  "language": "en"
}

POST

/balance/top-up

Initiate a balance top-up. This endpoint returns a checkout URL to complete the payment.

Request Body

Field	Type	Description
amount	integer	Amount to add (in cents). Minimum 1000 ($10.00).
currency	string	Currency code (e.g., "usd").

GET

/balance/transactions

Retrieve a history of all balance transactions (top-ups and usage).

Response Example

{
  "data": [
    {
      "id": "tx_123456789",
      "amount": 1000,
      "type": "purchase",
      "description": "Credits purchase",
      "platform": "stripe",
      "created_at": "2023-11-23T10:00:00Z"
    }
  ],
  "has_more": false
}