Note: This guide is for self-serve customers using Contextual AI in On-Demand mode. Customers on Provisioned Throughput should contact their account managers for any billing-related questions.

Usage Modes

Contextual AI supports two usage modes:
ModeDescriptionGood For
On-Demand

Get started immediately by creating a Contextual Workspace. New workspaces receive $25 in free credits.
Pay-as-you-go with no commitments or minimums

- Purchase credits upfront, which are then drawn-down based on your usage, according to the pricing below

- Easily gradaute to Provisioned Throughput as your needs evolve
Customers who:

- Are experimenting with, or evaluating, the platform

- Need the flexiblity to scale usage and costs up or down quickly

- Don’t require SLAs or QPS guarantees
Provisioned Throughput

Contact sales (sales@contextual.ai) or your account team.
Purchase model units (MUs) to reserve guaranteed capacity and predictable throughputCustomers who:

- Need guaranteed and predictable QPS levels to satisfy expected production volumes

- Require service level agreements (SLAs) to meet production standards

Services

Regardless of usage mode, customers can also purchase expert support services for fixed terms. With a service package, you get dedicated support from our Sales Engineering and Customer Machine Learning Engineering team to optimize performance and design full solutions. Contact sales or your account manager for more information.

On-Demand Pricing

In on-demand mode, usage of Contextual — whether through the UI or APIs — is charged as follows:
Note: Pricing is subject to change. This pricing sheet reflects the latest information as of July 2025.

Query

  • /query is the endpoint called when you interact with an Agent. It invokes a multi-step RAG pipeline, and the cost of a given query is the sum of the costs for each step in the pipeline. These steps can be configured via Agent Settings. The average cost per query is ~$0.05.
StepPrice
Query Optimization
(reformulation and decomposition)
$1/1M toks
Encode
(encode the user query for search)
$0.03/1M toks
Rerank
(rerank the retrieved chunks)
$0.12/1M toks
Filter
(filter chunks prior to generation)
$1/1M toks
Generate
(final response generation)
Input:
$3/1M toks

Output:
$15/1M toks
Groundedness & Safety
(post-generation groundedness checks)
$1/1M toks

Component APIs

  • Component APIs allow you to leverage key capabilities and models in a modular way.
ComponentPrice
Parse

Parse unstructured documents into markdown and/or JSON.
(Parse API Docs)
Basic:
$3/1K pages

Standard:
$40/1K pages
Rerank

Rerank based on natural language instructions
(Rerank API Docs)
$0.12/1M toks
Generate

Generate using the most grounded language model in the world
(Generate API Docs)
Input:
$3/1M toks

Output:
$15/1M toks
LMUnit

Evaluate LLM output using natural language unit tests
(LMUnit API Docs)
$3/1M toks

Ingestion

  • Documents added to Datastores are sent through our ingestion pipeline where they are parsed, chunked, and indexed in a vector store.
StepPrice
Ingestion$48.50/1K pages

  • Relevant API documentation: Ingest

Usage Stats and Credit Top Up

Viewing Usage and Spend

To see usage stats, click on Usage in the sidebar. Screenshot2025 07 10at1 22 42PM Pn The usage page shows a month-by-month breakdown of your usage and spend across the various charged components and endpoints. Screenshot2025 07 10at1 25 34PM Pn

Credit Top-Up

To continue using Contextual once your credits are depleted, you must top-up. To top-up credits:
  1. Navigate to the Billing page in your workspace Screenshot2025 07 10at3 24 55PM Pn
  2. Add a valid credit card under Payment Methods, if you havent already Screenshot2025 07 10at3 26 02PM Pn
  3. Click Add Credits and fill out the corresponding form Screenshot2025 07 10at3 29 24PM Pn
  4. Click Next and confirm the payment Screenshot2025 07 10at3 30 04PM Pn

Adding and Managing Payment Methods

In order to top-up credits, you must have a valid payment method linked to your Contextual workspace. To link a payment method:
  1. Navigate to the Billing page in your workspace Screenshot2025 07 10at3 24 55PM Pn
  2. Click on Payment Methods in the Learn More section Screenshot2025 07 10at3 26 02PM Pn
  3. Click the +New button in the upper right of the page Screenshot2025 07 10at3 33 57PM Pn
  4. Fill out the card or bank information in the form, then click Next Screenshot2025 07 10at3 36 34PM Pn
  5. Fill out your billing address, then click Save Payment Method Screenshot2025 07 10at3 36 46PM Pn
To remove an existing stored payment method:
  1. Locate it in the list of payment methods
  2. Click the menu icon
  3. Click Remove Payment Method
Screenshot2025 07 10at3 38 33PM Pn