User GuideAPI ReferenceAI Applications

💳 Wallet & Subscriptions

View and manage balance, top-up, redeem codes, referral rewards, and subscription plans.

After logging in, click "Wallet" in the left navigation bar, or navigate directly to /wallet to access the Wallet page. The Wallet page centrally provides balance statistics, online top-up, redeem codes, order history, subscription plans, my subscriptions, and referral rewards.

View Balance & Usage

The wallet statistics section includes the following information:

  • Current Balance: Account quota available for model calls or other billed operations.
  • Total Consumed: Total quota used over the account's history.
  • API Requests: Cumulative number of API requests initiated by the account.
  1. The display units for balance and usage are determined by the platform's billing rules and quota units.
  2. Actual deductions are affected by multiple factors, including model ratios, channel groups, and completion token consumption.

Online Top-up

If online payment is enabled on the platform, the top-up section of the wallet will display available top-up options.

  1. In the "Top-up" section, select a preset amount provided on the page or enter a custom top-up amount.
  2. Review the automatically converted top-up quota and the payable amount calculated by the system.
  3. Select a payment method currently supported by the platform.
  4. In the confirmation window, verify the top-up quota, payable amount, discounts, and payment channel.
  5. Confirm to redirect to the third-party payment page and complete the payment.
  6. Return to the wallet after payment and wait for the order status and balance to refresh automatically.
  1. The supported payment methods depend on the currently enabled payment gateways; please refer to the actual options available on the page.
  2. Successful payments require callback confirmation from the third-party payment gateway, usually arriving within seconds. If a delay occurs due to network fluctuations, please retain the order number and contact support—do not make duplicate payments.

Redeem Codes

When the platform supports redeem codes, an input field for redeem codes is provided in the top-up section. If the platform has configured an external card dispenser URL, an external purchase link will also be provided on the page.

  1. Locate the "Redeem Code" input field in the top-up section.
  2. Enter the acquired redeem code.
  3. Click "Redeem", and wait for the system success notification and automatic balance update.
  1. The redeem code must be within its validity period and unused. Each redeem code can only be used once.
  2. Upon successful redemption, the quota is immediately credited to the account's main balance and can be directly used for API calls.

Subscription Plans

Subscription plans are located in the subscription section of the wallet page. Available plans will be displayed when the platform enables subscription packages; if no subscription plans are currently configured, this section will automatically be hidden.

A plan card typically includes the following information:

ItemDescription
Title & DescriptionSubscription plan name and benefit details.
PriceAmount or balance required to purchase the plan.
Validity PeriodBilled yearly, monthly, daily, hourly, or on a custom cycle.
Total Quota per CycleSubscription quota included in each reset cycle; 0 indicates unlimited total quota.
Quota ResetQuota refresh cycle (no reset, daily, weekly, monthly, or custom cycle).
Purchase LimitMaximum number of subscriptions that a single user can hold.
Dedicated GroupWhether high-priority channel groups are unlocked upon successful purchase.

"Unlimited total quota" means no hard cap is set on total quota for the subscription cycle, but requests are still subject to concurrency throttling, rate limits, and model availability rules.

Purchase a Subscription Plan

  1. Open the "Subscription Plans" section on the Wallet page.
  2. Choose your preferred plan and check its validity period, quota, reset cycle, and included perks.
  3. Select a payment method (supports direct deduction from wallet balance or online payment).
  4. Verify the order information and complete the payment.
  5. Return to the wallet after payment is successful and verify that the subscription is activated.

View Subscription Status

In the "My Subscriptions" section, you can track real-time details of your current subscriptions:

  • Active: Displays remaining days, expiration date, next quota reset time, and the quota usage progress bar for the current cycle.
  • Expired: The subscription has expired, and the subscription quota is no longer available.
  • Cancelled: The subscription has been terminated or cancelled early.
  1. Once the quota reset time is reached, the used quota counter resets to zero, starting a brand-new cycle quota.
  2. To continue enjoying perks after a subscription expires, please purchase a new plan or renew in a timely manner.

Select Billing Preferences

The Wallet page supports flexible configuration of the quota deduction priority for model calls. The system will strictly execute deductions according to your preference:

Billing PreferenceDeduction Rule
Prioritize SubscriptionSubscription quota is consumed first when an active subscription exists; if the subscription quota is exhausted and fallback is allowed, wallet balance is automatically used.
Wallet balance is used when there is no active subscription.
Prioritize WalletAccount wallet balance is deducted first; subscription quota is attempted only after the balance is exhausted.
Subscription OnlyOnly subscription quota deductions are allowed. If there is no active subscription or quota is insufficient, requests are directly rejected without deducting from the wallet.
Wallet OnlyOnly wallet balance deductions are allowed. When balance is insufficient, requests are rejected without deducting subscription quota.

Referral Rewards

The referral rewards section provides your dedicated referral link and commission records:

https://api.openrely.ai/sign-up?aff=<your_referral_code>

Workflow:

  1. Copy your unique referral link and share it with friends or developer peers.
  2. Friends register via the link and top up or consume quota on the platform.
  3. Once agreed settlement conditions are met, commission rewards are automatically credited to your "Pending Rewards".
  4. Click "Transfer to Balance" to transfer commissions directly to your account's main balance for API calls.

Order History

  • Click "Order History" in the top-right corner of the wallet top-up section to view historical top-up records and billing details.
  • Supports search by order number and displays order time, payment method, top-up quota, actual amount paid, and status.

Troubleshooting

  1. Balance not updated after top-up: Third-party gateways may experience brief callback delays during peak periods. Please wait 1–2 minutes and refresh the page; if it does not arrive after a prolonged period, please provide the order number and contact support.
  2. Invalid redeem code: Check for leading or trailing whitespace in the input, and verify whether the code has already been redeemed or expired.
  3. Subscription quota not deducted as expected: Check whether "Billing Preference" is set to "Prioritize Subscription", and verify whether the requested model is included in the model groups supported by your active subscription.

Was this page helpful?

💳 Wallet & Subscriptions | OpenRely Docs