Important
Native Reranking is available as a Preview feature. The feature and the corresponding documentation might change at any time during the Preview period. Therefore, we don't recommend using this feature in production environments. We do not use any customer data from this feature to train our models at this time. To learn more, see Preview Features.
You can manage payments and billing for Native Reranking through the billing and payments interface in the Atlas UI. Atlas sends billing charges to the Atlas account linked to your cluster. Your billing profile for Atlas is the same as the billing profile for your Native Reranking. To view or edit your billing profile, see Atlas Billing.
Overview
Native Reranking uses a token-based pricing model where Atlas charges you based on the number of tokens that the $rerank stage processes. Atlas charges the $rerank stage separately from other Voyage AI operations in your Atlas project.
Token-Based Pricing
Atlas uses a pay-as-you-go pricing model and charges for usage based on the total number of processed tokens. The following formula calculates the total:
total number of processed tokens = (number of query tokens * numDocsToRerank) + sum(number of tokens across all documents)
Free Tokens
For the latest models, Atlas includes a one-time allocation of 200 million free tokens at the organization level. The organization shares free tokens across all Atlas projects and clusters within the organization. Free tokens do not refresh. To learn more about rate limits and usage tiers, see Usage Tiers and Rate Limits.
Token Usage
Monitor your token usage on the Usage page in the Atlas UI. Usage is constrained by requests per minute (RPM) and tokens per minute (TPM) per cluster. To learn more, see Usage Tiers and Rate Limits.
The Usage page provides several views to monitor and analyze your token usage. Click the Free Usage tab to view remaining free tokens by model for your organization.
In the Usage Activity tab, the Total Usage chart displays the total tokens used across your project over time. You can filter usage data by using the following options:
Option | Description |
|---|---|
Usage Period | View usage data for a specific time range. |
Models | Filter by specific Voyage AI models. |
To learn how to monitor token usage on a more granular level, see Monitor Token Usage.
Model Pricing
The cost for each model is as follows:
Model | Price per 1K tokens | Price per 1M tokens | Free Tokens |
|---|---|---|---|
| $0.00005 | $0.05 | 200,000,000 |
| $0.00002 | $0.02 | 200,000,000 |
| $0.00005 | $0.05 | |
| $0.00002 | $0.02 |
Manage Billing
Required Access
To view billing information, you must have at least
Organization Billing Vieweraccess.To configure billing settings, such as the payment method and billing profile, you must have
Organization OwnerorOrganization Billing Adminaccess.
Procedure
To access billing:
Billing Page Features
The Billing > Overview page includes the following:
- The Pending Invoice, which includes
- Net Month-to-Date Amount, showing the total amount due for your usage so far this month. It also shows the Month-to-Date Usage, including whether usage went up or down compared to this time last month, the usage for This Time Last Month, the Billing Period, and the Invoice Date. Click View Pending Invoice to view details.
- The Last Invoice, which shows the
- Amount Due, Total Usage, Billing Period, and Invoice Date. Click View Invoice to view details.
- The Usage chart, which displays your organization's
Native Reranking usage over the past one year in the By Service tab. You can hover over the point in the chart to see the usage for that month.
Tip
To understand your usage's cost, use the Cost Explorer in the Atlas UI and filter by Native Reranking. MongoDB derives costs from metering data and updates them every 24 hours.
Payment Method
To pay for Native Reranking, use your configured payment method. MongoDB accepts the following payment methods through the Atlas console:
Credit card
To set your payment method for Native Reranking in Atlas, see Atlas Payment Methods.
Through MongoDB Sales, you can also pay using:
A currency other than USD
A method other than a credit card or PayPal
Important
To confirm your credit card information, Atlas charges $1.00 when you first connect a credit card to your account. After Atlas confirms your information, it refunds the $1.00 charge. If you encounter any issues with connecting a credit card to your account, contact your card provider or banking institution. Verify whether they declined the initial charge, which would prevent Atlas from confirming your information.
Manage Invoices
View Invoices
To view the most recent and pending charges for your $rerank stage usage in an organization:
In Atlas, go to the Billing page for your organization.
If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.
In the sidebar, click Invoices under the Billing header.
The Invoices page displays.
Tip
You can also access billing information directly from the Usage page by clicking the View Invoice button.
Invoice Page Features
For each of your invoices, including your current invoice, you can:
View the payment amount due, the total cost of your usage for the billing period, and your billing information.
Export the invoice details to a PDF or CSV file.
Explore invoice cost visualization charts that show total usage costs by service, such as Native Reranking.
Review usage summaries by project and by service, such as Native Reranking.
Examine payment and usage details that explain usage and paid and pending charges for Native Reranking.
Your invoice shows usage categorized by reranker model, such as rerank-2.5 and rerank-2.5-lite, including the number of tokens processed and the cost per model.
To learn more about invoice features, see Invoices.
Review the Costs
You can use the Cost Explorer to understand your Native Reranking costs. The Billing Cost Explorer helps you understand your organization's billing data on a month-to-month basis. You can view monthly billing data in chart and table form.
Costs are based on the total number of tokens that the $rerank stage processes. To monitor your token usage, see Monitor Token Usage.
Procedure
Log in to Atlas.
Go to the Billing page for your organization.
If it's not already displayed, select your desired organization from the Organizations menu in the navigation bar.
In the sidebar, click Cost Explorer under the Billing header.
The cost explorer provides a visual representation of your billing data, including Native Reranking costs. To learn more, see Billing Cost Explorer.