> This page location: /docs.md > /docs/voyageai.md

> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

<!--
Tab options on this page. Append to the .md URL to filter:
  ?tabs=<id,...>   select specific tabs (e.g. ?tabs=nodejs,shell)
  ?allTabs=true    include every tab
  (no param)       default: one tab per tabset

Available tabs:
  other tabs: text, contextualized-chunk, multimodal, rerankers, linking-organizations, unlinking-organizations
-->

# Manage Billing for the Embedding and Reranking API

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.](https://www.mongodb.com/docs/voyageai/index.md#std-term-tokens)

- 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.](https://www.mongodb.com/docs/voyageai/management/monitor-usage.md#std-label-voyage-monitor-usage)

- Provides detailed cost breakdowns through the [Cost Explorer.](https://www.mongodb.com/docs/atlas/billing.md#std-label-cost-explorer)

- Displays your current monthly costs on the Invoices page. To learn more, see [Manage Invoices.](https://www.mongodb.com/docs/atlas/billing/invoices.md#std-label-atlas-invoices)

To learn more about billing in Atlas, see the [Atlas documentation.](https://www.mongodb.com/docs/atlas/billing.md#std-label-atlas-billing)

### Required Access

- To view billing information, you must have [`Organization Billing Viewer`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Viewer) access or higher.

- To configure billing settings, such as the payment method and billing profile, you must have [`Organization Owner`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Owner) or [`Organization Billing Admin`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Admin) access.

### 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.](https://www.mongodb.com/docs/voyageai/management/rate-limits.md#std-label-voyage-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.

### Text Embeddings

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 |
| --- | --- | --- | --- |
| `voyage-4-large` | $0.00012 | $0.12 | 200 million |
| `voyage-4` | $0.00006 | $0.06 | 200 million |
| `voyage-4-lite` | $0.00002 | $0.02 | 200 million |
| `voyage-code-4` | $0.00012 | $0.12 | 200 million |
| `voyage-finance-2``voyage-law-2``voyage-code-2` | $0.00012 | $0.12 | 50 million |

### Older Text Embedding Models

#### The following table shows the pricing for older text embedding models. Free tokens are not offered for these models.

| Model | Price per 1K tokens | Price per 1M tokens | Free tokens |
| --- | --- | --- | --- |
| `voyage-3-large` | $0.00018 | $0.18 | 0 |
| `voyage-3.5` | $0.00006 | $0.06 | 0 |
| `voyage-3.5-lite` | $0.00002 | $0.02 | 0 |
| `voyage-code-3` | $0.00018 | $0.18 | 0 |

## Usage Tiers

As your API usage and spending increase, you are automatically graduated to higher usage tiers with increased [rate limits](https://www.mongodb.com/docs/voyageai/api-reference/overview.md#std-label-voyage-rate-limits-overview). 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](https://www.mongodb.com/docs/voyageai/management/billing.md#std-label-voyage-org-linking) 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. Atlas customers with a [paid support plan](https://www.mongodb.com/services/support/atlas-support-plans): Submit a support ticket through the [MongoDB Support portal.](https://www.mongodb.com/services/support); All other customers: Email [contact@voyageai.com](mailto:contact@voyageai.com). |

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.](https://www.mongodb.com/docs/voyageai/management/monitor-usage.md#std-label-voyage-monitor-usage)

### How Usage Tiers are Determined

When determining an organization's usage tier, Atlas follows a priority order:

1. If the child organization has an established tier, that tier is used.

2. If the child organization does not yet have a tier but is [linked](https://www.mongodb.com/docs/voyageai/management/billing.md#std-label-voyage-org-linking) to a parent organization, Atlas checks the parent's tier.

3. 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.](https://www.mongodb.com/docs/atlas/billing.md#std-label-cross-org-billing)

The following rules apply when linking and unlinking organizations:

### Linking 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.

## 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 icon is only visible to users with the access described in [Required Access](https://www.mongodb.com/docs/voyageai/management/billing.md#std-label-voyage-billing-required-access). 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](https://www.mongodb.com/docs/atlas/billing.md#std-label-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.](https://www.mongodb.com/docs/voyageai/management/monitor-usage.md#std-label-voyage-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.](https://www.mongodb.com/docs/atlas/billing.md#std-label-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

- [PayPal](https://www.paypal.com/us/home)

To set your payment method for your model API keys in Atlas, see [Atlas Payment Methods.](https://www.mongodb.com/docs/atlas/billing.md#std-label-atlas-billing-methods)

Through [MongoDB Sales](https://www.mongodb.com/contact/atlas?tck=docs), 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.](https://www.mongodb.com/docs/atlas/billing.md#std-label-examine-invoices)

### View Invoices

To view the most recent and pending charges for your model API keys in an organization:

1. Log in to [Atlas](https://cloud.mongodb.com).

2. 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](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2Foverview) 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 `PENDING` or `SUCCESSFUL`.

- 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:

```text
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 Model APIs

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
```
