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

# Pricing

> Pricing for Search and Embedding & RAG features.

Pricing for the Embedding & RAG section is broken down by feature. Search covers collection management, embedding, storage, and search events. Embedding covers document embedding and storage for use with RAG workflows.

<Tabs>
  <Tab title="Search" icon="microchip-ai">
    Search pricing has three parts: embedding and persisting content when it is indexed for search, storage retention beyond 30 days, and search events when you query a collection.

    ## Rates

    | Usage                 | Price                     | Notes                                                                                                                                                               |
    | --------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Embed and persist     | `$0.0015 / 1K characters` | Billed once on input content characters when the content is indexed. Adding an already-indexed source to another collection is free. Includes 30 days of retention. |
    | Storage after 30 days | `$0.60 / GiB-month`       | Applies only when extended retention is enabled.                                                                                                                    |
    | Search event          | `$0.003 / search`         | Charged per ranked search (a request with a `query` parameter). First 10,000 searches per month are free of charge.                                                 |
    | Catalog listing       | Free                      | Browsing a collection's documents without a `query` parameter is not billed.                                                                                        |

    ## How Billing Works

    ### Embed and Persist

    Content is billed once when it is indexed. A source is indexed when its content is first ingested for search; once indexed, the same source can be added to any number of collections at no additional cost. You are not billed for a source simply because it is part of a collection. Billing covers the input content characters and includes 30 days of retention. Storage after 30 days is billed at the extended retention rate only if extended retention is enabled.

    ### Search Events

    A **search event** is a single `GET /v2/ai/collections/{slug}/documents` request that includes a `query` parameter. Each ranked search counts as one billable event, regardless of the `top_k` value or the number of results returned. The first 10,000 searches per month are free.

    Requests without a `query` parameter (catalog listings) are free -- they return documents sorted by date without ranking, and are not counted as search events.

    ### Multi-Region Fan-Out

    When a collection's sources are stored across multiple regions, a search query fans out to all relevant regions in parallel. Each region retrieves its matching results independently, and the results are merged into a single ranked list by score. The user does not see or control which regions are searched -- the fan-out and merge happen automatically.

    Despite querying multiple regions, the entire fan-out counts as **one** billable search event, not one per region. The multi-region behavior does not increase the cost of a search.

    Region selection is automatic -- there is no region parameter on search requests.

    ## Example

    A collection with 10,000 characters of indexed content and one search within the free tier would be priced as:

    | Line Item              | Calculation                                     | Price     |
    | ---------------------- | ----------------------------------------------- | --------- |
    | Embed and persist      | `10K characters * $0.0015`                      | `$0.015`  |
    | Storage within 30 days | Included                                        | `$0.00`   |
    | One search             | Included in the first 10,000 searches per month | `$0.00`   |
    | Total                  |                                                 | `~$0.015` |
  </Tab>

  <Tab title="Embedding" icon="database">
    Embedding pricing covers document embedding and storage for use with RAG workflows. Documents uploaded to a Telnyx Storage bucket are embedded and indexed for similarity search and retrieval.

    ## Rates

    | Usage                 | Price                     | Notes                                                                                               |
    | --------------------- | ------------------------- | --------------------------------------------------------------------------------------------------- |
    | Embed and persist     | `$0.0015 / 1K characters` | Billed once on input content characters when documents are embedded. Includes 30 days of retention. |
    | Storage after 30 days | `$0.60 / GiB-month`       | Applies only when extended retention is enabled.                                                    |
    | Similarity search     | `$0.003 / search`         | Charged per similarity search request. First 10,000 searches per month are free of charge.          |

    ## How Billing Works

    ### Embed and Persist

    When you embed documents in a Telnyx Storage bucket, the content is processed into sections and each section is embedded into a vector. You are billed once on the input content characters. This includes 30 days of retention. Storage after 30 days is billed at the extended retention rate only if extended retention is enabled.

    ### Similarity Search

    A similarity search request retrieves the most relevant document sections for a given query. Each search counts as one billable event. The first 10,000 searches per month are free.

    ## Example

    A bucket with 50,000 characters of document content and 100 searches in a month would be priced as:

    | Line Item              | Calculation                                     | Price     |
    | ---------------------- | ----------------------------------------------- | --------- |
    | Embed and persist      | `50K characters * $0.0015`                      | `$0.075`  |
    | Storage within 30 days | Included                                        | `$0.00`   |
    | 100 searches           | Included in the first 10,000 searches per month | `$0.00`   |
    | Total                  |                                                 | `~$0.075` |
  </Tab>
</Tabs>
