You can manage payments and billing for the Atlas Embedding and Reranking API through the billing and payments interface in the Atlas UI. Atlas sends billing charges to the Atlas account linked to your model API keys.
Overview
MongoDB uses a pay-as-you-go pricing model and charges for usage based on consumption:
For text-based models, charges apply per token.
For multimodal models that process images and videos, charges apply per pixel.
You configure billing settings at the organization level, which apply to all projects within that organization. You can examine costs and billing for your model API keys per project in the Atlas UI.
For model API keys usage, Atlas:
Tracks your usage of tokens and pixels on the Usage page. To learn more, see Monitor Usage.
Provides detailed cost breakdowns through the Cost Explorer.
Displays your current monthly costs on the Invoices page. To learn more, see Manage Invoices.
To learn more about billing in Atlas, see the Atlas documentation.
Note
The Public Preview does not support prepaid credits for the Embedding and Reranking API. This is subject to change.
Required Access
To view billing information, you must have
Organization Billing Vieweraccess or higher.To configure billing settings, such as the payment method and billing profile, you must have
Organization OwnerorOrganization Billing Adminaccess.
Rate Limits
The Atlas Embedding and Reranking API enforces rate limits based on requests per minute (RPM) and tokens per minute (TPM). MongoDB sets limits at the organization level, but you can configure lower limits at the project level. Higher rate limit tiers are available based on payment history and spending. To learn more, see Manage Rate Limits.
Model Pricing
Model pricing is usage-based, with charges billed to the Atlas account linked to the API key used for access. All models include a free tier. Get started with 200 million free tokens for most models, or 50 million tokens for specialized models.
Pricing is based on the number of tokens in your documents and queries.
The free tier includes 200 million tokens for most models, and 50 million tokens for the following
specialized models: voyage-finance-2, voyage-law-2, voyage-code-2.
Model | Price per 1K tokens | Price per 1M tokens | Free tokens |
|---|---|---|---|
| $0.00012 | $0.12 | 200 million |
| $0.00006 | $0.06 | 200 million |
| $0.00002 | $0.02 | 200 million |
| $0.00018 | $0.18 | 200 million |
| $0.00018 | $0.18 | 200 million |
voyage-finance-2voyage-law-2voyage-code-2 | $0.00012 | $0.12 | 50 million |
Pricing is based on the number of tokens in your documents and queries.
Model | Price per 1K tokens | Price per 1M tokens | Free tokens |
|---|---|---|---|
| $0.00018 | $0.18 | 200 million |
Pricing is based on text tokens and image pixels. The free tier includes 200 million text tokens and 150 billion pixels for multimodal models. Images are processed between 50,000 pixels (minimum) and 2 million pixels (maximum), with costs ranging from $0.00003 to $0.0012 per image. For pricing purposes, each video frame is considered an image.
Note
Images with fewer than 50,000 pixels are upscaled, processed, and charged as a 50,000-pixel image. Images containing over 2 million pixels are downsampled and charged as 2 million-pixel images.
Model | Price per 1M tokens | Price per 1B pixels | Free tier |
|---|---|---|---|
| $0.12 | $0.60 | 200M tokens, 150B pixels |
Image resolution | Number of pixels | Price per image | Price per 1K images |
|---|---|---|---|
200px × 200px | 40,000 | $0.00003 | $0.03 |
1000px × 1000px | 1 million | $0.0006 | $0.60 |
2000px × 2000px | 4 million | $0.0012 | $1.20 |
4000px × 4000px | 16 million | $0.0012 | $1.20 |
Example
The cost to vectorize a single input with 1,000 text tokens ($0.00012) and two 4 million-pixel images (2 × $0.0012) would be $0.00252.
Pricing is based on total processed tokens, calculated as
(query tokens × number of documents) + sum of tokens in all documents.
The free tier includes 200 million tokens for the latest reranker models.
Model | Price per 1K tokens | Price per 1M tokens | Est. price per request* | Free tokens |
|---|---|---|---|---|
| $0.00005 | $0.05 | $0.0025 | 200 million |
| $0.00002 | $0.02 | $0.001 | 200 million |
* Estimated price assumes 100 documents per request, with the sum of query tokens and tokens per document totaling 500.
Usage Tiers
As your API usage and spending increase, you are automatically graduated to higher usage tiers with increased rate limits. Your organization is assigned to a usage tier based on cumulative spending since account creation. Once you qualify for a tier, you remain at that tier unless your organization is unlinked from a parent organization.
Your organization's rate limits automatically increase when you move to the next usage tier based on the following criteria:
Usage Tier | Requirements to Advance |
|---|---|
Free trial | Add a payment method to move to Usage Tier 1. |
Usage tier 1 | Spend at least $100 since account creation to move to Usage Tier 2. |
Usage tier 2 | Spend at least $1,000 since account creation to move to Usage Tier 3. |
Usage tier 3 | If you still need a higher rate limit, please request a rate limit increase.
|
To manage your usage in real-time, you can view your organization's usage and spending in the Atlas UI. To learn more, see Monitor Usage.
How Usage Tiers are Determined
When determining an organization's usage tier, Atlas follows a priority order:
If the child organization has an established tier, that tier is used.
If the child organization does not yet have a tier but is linked to a parent organization, Atlas checks the parent's tier.
If the parent organization also does not have an established tier, Atlas evaluates the parent's payment method status:
Organizations with an active payment method default to Tier 1.
Organizations without a payment method default to the Free Tier.
Organization Linking and Tier Inheritance
When a child organization is linked to a parent organization, the child organization inherits the parent's usage tier if the parent's tier is higher than the child's current tier. To learn how to link organizations, see Cross-Organization Billing.
The following rules apply when linking and unlinking organizations:
When organization linking occurs, Atlas evaluates both the parent and child organization tiers and sets the child's tier to the maximum of the two. This ensures:
The child organization is never at a lower tier than its parent.
The child organization is never downgraded if it has already achieved a higher tier independently.
Example
If a child organization is at Tier 2 and is linked to a parent organization at Tier 1, the child organization remains at Tier 2.
If a child organization is at Tier 1 and is linked to a parent organization at Tier 3, the child organization is upgraded to Tier 3.
When an organization is unlinked from its parent, the child organization's tier is re-evaluated based on its own lifetime spend and payment method status.
Unlike the linking scenario, unlinking allows for tier downgrades:
If the child organization's individual spend history does not qualify it for its current tier, the tier is adjusted downward to match what the organization has earned on its own.
Organizations without a payment method and without qualifying spend are placed in the Free Tier after unlinking.
Example
If a child organization inherited Tier 3 from its parent but has only spent $50 on its own, unlinking will downgrade the child organization to the Free Tier (if no payment method is attached) or Tier 1 (if a payment method is attached).
Manage Billing
To access billing, log into the Atlas UI, navigate to your organization, and click the Billing icon in the upper-right corner of your screen. 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.
Tip
To understand how your usage translates to costs, use the Cost Explorer in the Atlas UI and filter by AI model. MongoDB derives costs from metering data and updates them every 24 hours. To learn more, see Monitor Usage.
Your billing profile for Atlas is the same as the billing profile for your model API keys. To view or edit your billing profile, see Atlas Billing.
Payment Method
To pay for your Embedding and Reranking API usage, use your configured payment method. MongoDB accepts the following payment methods through the Atlas console:
Credit card
To set your payment method for your model API keys in Atlas, see Atlas Payment Methods.
Through MongoDB Sales, you can 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, reach out to your card provider or banking institution. Verify whether they declined the initial charge, which would prevent Atlas from confirming your information.
Manage Invoices
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 PDF or CSV.
Explore invoice cost visualization charts that show total usage costs by service, such as the model API keys.
Review usage summaries by project and by service, such as the model API keys.
Examine payment and usage details that explain usage, as well as paid and pending charges for the model API keys.
To learn more, see Invoices.
View Invoices
To view the most recent and pending charges for your model API keys in an organization:
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 Overview under the Billing header.
The Billing page displays.
You can also access billing information directly from the Usage page by clicking the View Invoice button.
Invoice Page Features
On the Invoices page in Atlas, you can view your billing invoices for your model API keys.
The Invoice page displays the following columns:
Payment Status: Shows
PENDINGorSUCCESSFUL.Invoice Date: Shows the date when Atlas generates the invoice.
Invoice Period: Shows the billing period for the invoice. For example, you might see a usage summary for the billing period of
December 1, 2025 - January 1, 2026.Total Cost: Shows your total monthly charges in your selected currency. The total monthly charges include the billed amount and any applicable taxes, but don't include any payments you made.
For example, the Total Cost column might show
$29.98 (month-to-date). This indicates that your total charges for the month so far are $29.98, including taxes, but doesn't reflect any payments you might have made.Download: Provides an icon for downloading the invoice. You can download your Usage Summary in PDF or CSV format. The Usage Summary shows a detailed breakdown of daily usage activity for your model API keys.
For example, your model API keys invoice may show the following information:
Usage Summary Number: 692cff3069022138575632aa Organization: MyVoyageOrg This usage summary is for the billing period December 1, 2025 - January 1, 2026. Total Usage 29.98 credits Summary By Project ProjectA - 69268bd3878d033ecba8b582 5.42 credits ProjectB - 69268f47abcc0a315b1e027c 10.27 credits ProjectC - 6917a27c2e1a031d66d61650 14.29 credits Total Usage 29.98 credits Summary By Service AI Models Voyage Embedding 3.5 - Text - API Service 80.523 million tokens @ 0.06 credits / million tokens 4.83 credits Voyage Embedding 3.5 - Text Lite - API S... 67.553 million tokens @ 0.02 credits / million tokens 1.34 credits Voyage Embedding 2 - Finance - API Service 91.482 million tokens @ 0.12 credits / million tokens 10.98 credits Voyage Embedding 2 - Law - API Service 79.624 million tokens @ 0.12 credits / million tokens 9.55 credits Voyage Embedding 2 - Code - API Service 27.274 million tokens @ 0.12 credits / million tokens 3.28 credits Total Usage 29.98 Credits