> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sinarcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Token credits

> Prepaid tokens for one AI model that are used before your balance is charged. Get them from subscription plans and gifts, and track how they apply and expire.

Token credits are prepaid tokens for one specific AI model. When you send a request to that model, your token credits pay for its tokens before anything is charged to your balance. Requests to other models are charged to your balance as usual.

Token credits come in grants. A grant is a fixed number of tokens for one model, usually valid until an expiry time. You get grants from an [AI subscription plan](https://docs.sinarcloud.com/ai/subscriptions.md), by claiming a gift from a SinarCloud promotion, or from SinarCloud directly. See [Get token credits](#get-token-credits).

To see your token credits, click **Token credits** under **AI** in the console sidebar.

![The Token credits page with Refresh and View usage buttons and two model cards under Available now, each showing the model name and alias, tokens available and the next expiry. Below, the Grants tab is open next to Activity, with a table of Model, Source, Status, Used / granted, Left, Valid and Note.](https://mintcdn.com/sinar-cloud/Zz311Jgf5s_A88RD/images/ai-credits.png?fit=max\&auto=format\&n=Zz311Jgf5s_A88RD\&q=85\&s=2b26bf0bf6d79b12be40ba965908e24f)

The Token credits page

## How token credits work

* **One model per grant.** Each grant covers a single model. Credits for one model never pay for another.
* **Tokens, not money.** Token credits don't add to your balance and can't pay for VPS or other charges.
* **Every token counts.** Each input token, including cached input, and each output token uses one token of credit. The exception is a Cache-Free subscription plan, whose tokens don't count cached input. See [How plans count tokens](https://docs.sinarcloud.com/ai/subscriptions.md#how-plans-count-tokens).
* **Applied when the request finishes.** Credits are deducted when the request is charged, after it completes.
* **Soonest expiry first.** If you have several grants for the same model, the grant that expires first is used first. Grants that never expire, from No Expiry plans, are used last, oldest first.
* **Free requests don't use credits.** If a request costs nothing, for example on a free model, your credits stay untouched.

## When credits cover only part of a request

If a request uses more tokens than you have left for the model, credits cover what they can and the rest is charged to your balance. Credits pay the same share of the request's full price as the share of its tokens they cover.

For example, a request uses 10,000 tokens and its full price is Rp 200. You have 4,000 tokens of credit left for that model. Credits cover 4,000 tokens, which is 40% of the request, so they pay Rp 80. The remaining Rp 120 is charged to your balance.

> [!WARNING]
>
> The part that credits don't cover is always charged to your balance, even if this takes your balance below zero. This can happen when a large request, or several requests running at once, use up your last credits.

## Requests with an empty balance

When your balance is zero or below, you can still send requests to a model as long as you have token credits left for it. Requests that would cost money and have no token credits for their model are refused, unless a promotion makes the model free. The API returns HTTP status `402`, error code `insufficient_balance`, and this message:

```text theme={null}
Your balance is empty or negative and no token credits remain for this model. Top up to continue.
```

To send requests that your token credits don't cover, [add balance](https://docs.sinarcloud.com/billing/top-up.md).

## Available now

The **Available now** section shows one card for each model you can use credits on right now. Each card shows:

* The model name, with the model alias you put in the `model` field of your requests.
* The **tokens available**, added up across all active grants for that model.
* **Next expiry**, the soonest expiry among those grants. The date is highlighted when it is less than seven days away.

If you have no usable credits, you see **No token credits right now**, and your requests are charged to your balance. Click **Refresh** to reload the cards after sending requests.

## Grants

The **Grants** tab lists every grant your account has received, newest first, 20 per page. Each row shows the **Model**, the **Source**, the **Status**, **Used / granted** tokens with a progress bar, the tokens **Left**, the **Valid** period and an optional **Note**.

**Source** shows where a grant came from: **Plan allowance** for a week of an AI subscription plan, **Gift** for a gift you claimed, or **From SinarCloud** for token credits SinarCloud added to your account. The console also has the labels **Promotion** and **Token pack** for sources that aren't available yet.

| Status | Meaning |
| - | - |
| **Active** | The grant has tokens left and hasn't expired. |
| **Used up** | Every token on the grant has been used. |
| **Expired** | The expiry time has passed. Unused tokens can no longer be used. |
| **Revoked** | SinarCloud ended the grant early and removed its remaining tokens. |

**Left** reads zero once a grant is used up, expired or revoked.

## Expiry

Most grants have an expiry time, shown under **Valid**. Grants from No Expiry subscription plans never expire. When an expiry time passes, the grant shows **Expired** and its unused tokens no longer count toward **Available now**. Unused tokens are not refunded or added to your balance.

A request that was already running at the expiry time can still use the grant when it finishes. The matching **Expired** entry in **Activity** can appear some time after the expiry time. The grant shows **Expired** from the expiry time on.

## Activity

The **Activity** tab lists every change to your token credits, newest first. Each entry shows the **Date**, **Event**, **Model**, **Tokens**, the tokens **Left on grant** after the change, and **Details**.

| Event | What happened |
| - | - |
| **Granted** | Tokens were added to your account. Shown as a positive number. **Details** shows the grant's note, if it has one. |
| **Used** | A request used tokens from the grant. **Details** shows an ID for the request. |
| **Expired** | The grant expired and its unused tokens were removed. |
| **Revoked** | SinarCloud revoked the grant. **Details** can show the reason. |

To see what credits paid on a specific request, use the usage log as described in the next section.

## See credits on your requests

1. Click **View usage** at the top of the **Token credits** page, or click **Usage** under **AI**. The **Log** tab opens first.
2. Click **Show details** on one of your recent requests. The log lists your latest settled requests. In the **Cost** column, a request that credits paid for shows its full price struck through.
3. Under **Charge breakdown**, **Token credits** shows the amount credits paid and how many tokens they covered. **Charged** is the amount taken from your balance.

On the **Usage** page, the **Total saved** card includes what token credits paid in the selected period, and the **Spending** tab shows a **Covered by token credits** total for the current and previous periods. See [Usage and spending](https://docs.sinarcloud.com/ai/usage.md).

## Get token credits

Token credits come from three places today:

* **Subscription plans.** Each week of an AI subscription plan adds a grant of the plan's tokens, with the source **Plan allowance**. See [AI subscription plans](https://docs.sinarcloud.com/ai/subscriptions.md).
* **Gifts.** A SinarCloud promotion can give your account a gift of free tokens for one model. You claim it in a popup in the console, or by redeeming a gift code. Its grant shows **Gift** as its source. See [Claim a gift](#claim-a-gift) and [Redeem a gift code](#redeem-a-gift-code).
* **SinarCloud.** SinarCloud can add token credits to your account. These grants show **From SinarCloud**.

The **Token credits** page also names promotions and token packs as sources. These aren't available yet. You can't buy token credits on their own, but a subscription plan gives you tokens every week. Coupons don't add token credits, but gift codes do, and you enter both in the same **Redeem coupon** dialog. To ask about token credits for your account, [contact support](https://docs.sinarcloud.com/help/support.md).

### Claim a gift

When a SinarCloud promotion has a gift for your account, a gift popup opens over the console page you're on. Nothing is added to your account until you click **Claim gift**.

![A gift popup over the Virtual private servers page, with a party popper illustration, the A gift for you label, the gift's title and message, and a box showing the free tokens, the model they pay for and how many days they stay usable after you claim them. Below the box are a Claim by date and the Later and Claim gift buttons, with a close button in the top corner.](https://mintcdn.com/sinar-cloud/Zz311Jgf5s_A88RD/images/gift-popup.png?fit=max\&auto=format\&n=Zz311Jgf5s_A88RD\&q=85\&s=40751052de8a8037846a27d167313b37)

A gift popup

The popup shows:

* **A gift for you** above the gift's title. If you have several gifts waiting, it shows **Gift 1 of** and the number of gifts instead. Gifts open one at a time, newest first.
* The promotion's message, if it has one.
* The number of free tokens, for example **1M free tokens**, and the model they pay for. The line below gives the exact number of tokens and how many days they stay usable after you claim them.
* **Claim by** and a date, if the gift has a claim deadline.

To claim the gift:

1. Click **Claim gift**. The button shows **Claiming…** while it works.
2. The popup closes, or shows your next gift if one is waiting. A **Gift claimed** message shows the number of tokens from the gift, the model and when they expire, and tells you to find them under **AI › Token credits**.
3. The tokens appear under **Available now**. The **Grants** tab lists them with the source **Gift**.

The tokens' validity starts when you claim the gift, not when the popup first appears. A gift's grant has no note, so its **Note** and the **Details** of its **Granted** entry under **Activity** show "—".

To decide later, click **Later**. The close button, the Escape key and a click outside the popup do the same. The popup opens again when you reload the page or next open the console. Once someone in your account claims a gift, it doesn't show again, and a gift can only be claimed once.

> [!WARNING]
>
> If you don't claim a gift by its **Claim by** date, it expires and you can no longer claim it. A gift also expires if its promotion ends before you claim it.

> [!NOTE]
>
> A gift offered to your account appears only as a popup in the console, and you don't need a code to claim it. SinarCloud doesn't send an email when a gift is waiting. Other gifts come with a gift code instead. See [Redeem a gift code](#redeem-a-gift-code).

#### If a gift can't be claimed

If claiming fails, the popup shows **The gift could not be claimed** with the reason. The most common ones are:

| Message | What it means |
| - | - |
| This gift can no longer be claimed. | Its **Claim by** date passed or its promotion ended. The gift drops out of the popup. |
| This gift cannot be claimed right now. | The promotion is paused, or the gift's model isn't available at the moment. A gift from a paused promotion drops out of the popup and comes back if the promotion resumes before the **Claim by** date. If the model isn't available, try again later, before the **Claim by** date. |

When a gift drops out, the popup closes, or shows your next gift if one is waiting.

If the problem continues, [contact support](https://docs.sinarcloud.com/help/support.md).

### Redeem a gift code

Some gifts come with a gift code instead of a popup. Redeeming the code claims the gift at once, so you don't click **Claim gift**.

1. In the console sidebar, under **Account**, click **Billing**. Then click **Redeem** at the top of the page.
2. Enter the code in **Coupon code** and click **Redeem coupon**. Codes are case-insensitive. If a checkbox appears under **Coupon code**, tick it.
3. The **Redeem coupon** dialog closes and the gift popup opens, with **Gift claimed** above the gift's title. It shows your free tokens, the model they pay for and when they expire. Click **View token credits** to open the **Token credits** page.

The tokens' validity starts when you redeem the code. The grant shows **Gift** as its source, like a gift you claim in the popup.

Your account can redeem each gift code once. If you enter it again, the popup shows the same gift with the tokens that are left. Once those tokens have expired, been used up or been revoked, it shows **Already claimed** instead.

If the code can't be redeemed, the dialog shows **Failed to redeem** with the reason, for example that the promotion has ended or that the code has been fully redeemed. For what each message means, see the error messages in [Redeem a coupon](https://docs.sinarcloud.com/billing/coupons.md#on-the-billing-page).

> [accordion] How do token credits work with promotions?
>
> If a promotion discounts a model, token credits pay first at the full price. The promotion discount then applies only to the part charged to your balance. If a promotion makes the model free, the promotion pays and your token credits stay untouched. If the promotion stops covering the full price, for example because it has reached its limit, your credits pay the rest before your balance does. You can see promotional prices on [Models and pricing](https://docs.sinarcloud.com/ai/models.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.