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

# Limits and Usage

> How plan credits, usage limits, and concurrency limits work across Hamsa services

## Overview

Hamsa offers six plans: Free, Starter, Creator, Pro, Business, and Enterprise. Paid plans renew monthly — with a 15% discount when billed annually — and include a monthly credit allocation plus per-service usage limits. The Free plan works differently: it is a one-time credit grant, not a subscription.

***

## Plans and Credits

Credits are consumed when using Hamsa services — Voice Agents, Speech to Text, and Text to Speech.

| Plan           | Credits              | Description                                   |
| -------------- | -------------------- | --------------------------------------------- |
| **Free**       | 50 credits, one-time | For trying out the platform                   |
| **Starter**    | 100 credits/month    | For hobbyists creating projects with AI audio |
| **Creator**    | 500 credits/month    | For creators making premium content           |
| **Pro**        | 5,000 credits/month  | For creators ramping up their production      |
| **Business**   | 20,000 credits/month | For rapidly scaling startups and publishers   |
| **Enterprise** | Custom               | Volume-based discounts and custom terms       |

<Note>
  **The Free plan never renews.** Every new account gets 50 free credits to try Hamsa — granted once at signup, and you're never charged. When you're ready to build, pick a paid plan that renews monthly.
</Note>

<Warning>
  Credits on paid plans **reset at the start of each billing cycle**. Unused credits do not roll over to the next month.
</Warning>

### What credits get you

Each service consumes credits at a different rate:

| Service        | Credit cost          |
| -------------- | -------------------- |
| Speech to Text | 1 credit per minute  |
| Text to Speech | 2 credits per minute |
| Voice Agents   | 6 credits per minute |

Which translates to the following per plan:

| Plan           | Voice Agent minutes | Speech to Text minutes | Text to Speech minutes |
| -------------- | ------------------- | ---------------------- | ---------------------- |
| **Free**       | 9 (one-time)        | 50 (one-time)          | 25 (one-time)          |
| **Starter**    | 17/month            | 100/month              | 50/month               |
| **Creator**    | 84/month            | 500/month              | 250/month              |
| **Pro**        | 834/month           | 5,000/month            | 2,500/month            |
| **Business**   | 3,334/month         | 20,000/month           | 10,000/month           |
| **Enterprise** | Custom              | Custom                 | Custom                 |

<Info>
  Minute equivalents assume a single service consumes your full credit allocation. In practice you can split credits across services in any combination.
</Info>

***

## Additional Credits

Are you on the Creator, Pro, or Business plan and need more credits? You can purchase additional credit packs at any time to supplement your plan allocation.

### Credit Packs

| Plan     | Top-Up Price | Credits Given |
| -------- | ------------ | ------------- |
| Creator  | \$5          | 100 Credits   |
| Pro      | \$10         | 300 Credits   |
| Business | \$25         | 1,000 Credits |

<Info>
  Additional credits are available for purchase from your [Agents](https://agents.tryhamsa.com/app/billing) or [Media](https://media.tryhamsa.com/app/billing) billing page. Credit packs are one-time purchases, not recurring subscriptions. Free, Starter, and Enterprise plans do not have top-up packs.

  <img src="https://mintcdn.com/hamsa-452fa79a/faqA0g16HZbxfVQ3/images/add-top-up.png?fit=max&auto=format&n=faqA0g16HZbxfVQ3&q=85&s=92a26b5e0b8ff32712ab106b31eb1d53" alt="Add a top-up package." width="3022" height="1896" data-path="images/add-top-up.png" />
</Info>

***

## Usage Limits

In addition to credits, some services have per-plan job limits. A job is one API request (for example, one transcription job or one synthesis request). Limits apply on a monthly or daily basis depending on the service.

### Speech to Text (Monthly Limit)

| Plan           | Monthly Job Limit                              |
| -------------- | ---------------------------------------------- |
| **Free**       | No separate cap — limited by available credits |
| **Starter**    | 50 jobs                                        |
| **Creator**    | 300 jobs                                       |
| **Pro**        | 2,500 jobs                                     |
| **Business**   | 8,000 jobs                                     |
| **Enterprise** | Custom                                         |

### Text to Speech (Daily Limit)

| Plan           | Daily Job Limit                                |
| -------------- | ---------------------------------------------- |
| **Free**       | No separate cap — limited by available credits |
| **Starter**    | No separate cap — limited by available credits |
| **Creator**    | 1,500 jobs                                     |
| **Pro**        | 1,500 jobs                                     |
| **Business**   | 5,000 jobs                                     |
| **Enterprise** | Custom                                         |

***

## Concurrency Limits

Voice Agents have a per-plan limit on simultaneous calls:

| Plan           | Concurrent Calls |
| -------------- | ---------------- |
| **Free**       | 1 call           |
| **Starter**    | 1 call           |
| **Creator**    | 2 calls          |
| **Pro**        | 5 calls          |
| **Business**   | 10 calls         |
| **Enterprise** | Custom           |

Speech to Text and Text to Speech have no separate concurrency caps on standard plans.

***

## Knowledge Base Storage

Voice agents can be grounded on uploaded knowledge base documents. Storage is limited per plan:

| Plan           | Knowledge Base Storage |
| -------------- | ---------------------- |
| **Free**       | 1 MB                   |
| **Starter**    | 5 MB                   |
| **Creator**    | 10 MB                  |
| **Pro**        | 50 MB                  |
| **Business**   | 100 MB                 |
| **Enterprise** | Custom                 |

***

## When You Run Out of Credits

When your credits are exhausted, API requests return an HTTP `402 Payment Required` error, and the dashboard prompts you to upgrade your plan or — on Creator, Pro, and Business — purchase a credit pack.

***

## Monitoring Your Usage

You can monitor your credit usage and limits from Hamsa Agents or Hamsa Media.

<Steps>
  <Step title="Navigate to Hamsa Agents or Hamsa Media">
    Go to [Hamsa Agents](https://agents.tryhamsa.com) or [Hamsa Media](https://media.tryhamsa.com) and log in
  </Step>

  <Step title="View Usage">
    On the left-hand or right-hand side depending on the language you choose, you will find a box containing the current credits in total and the consumed number.

    <img src="https://mintcdn.com/hamsa-452fa79a/faqA0g16HZbxfVQ3/images/credits-usage.png?fit=max&auto=format&n=faqA0g16HZbxfVQ3&q=85&s=633ec8714933b37a9f381a766eb05b36" alt="Credits Usage component" width="3022" height="1896" data-path="images/credits-usage.png" />
  </Step>
</Steps>

***

## Upgrading Your Plan

If you regularly run out of credits or hit your usage limits, consider upgrading to a higher plan for increased allocations.

<CardGroup cols={2}>
  <Card title="Compare Plans" icon="scale-balanced" href="https://tryhamsa.com/pricing">
    View detailed plan comparison and pricing
  </Card>

  <Card title="Contact Sales" icon="phone" href="https://tryhamsa.com/contact">
    Discuss custom Enterprise solutions
  </Card>
</CardGroup>

***

## FAQs

<AccordionGroup>
  <Accordion title="Does the Free plan renew every month?">
    No. The Free plan is a one-time grant of 50 credits when you create your account. It never renews, and you're never charged. To keep using Hamsa after your free credits run out, upgrade to a paid plan.
  </Accordion>

  <Accordion title="Do unused credits roll over?">
    No. Credits on paid plans reset at the start of each billing cycle and do not carry over to the next month.
  </Accordion>

  <Accordion title="What happens when I run out of credits?">
    API requests return an HTTP `402 Payment Required` error until your credits renew with the next billing cycle, you upgrade your plan, or you purchase a credit pack.
  </Accordion>

  <Accordion title="Can I purchase additional credits on any plan?">
    Additional credit packs are available for the Creator, Pro, and Business plans. Free, Starter, and Enterprise plans do not have top-up options.
  </Accordion>

  <Accordion title="How is Speech to Text usage calculated?">
    Speech to Text consumes 1 credit per minute of audio, and each plan has a monthly limit on the number of transcription jobs.
  </Accordion>

  <Accordion title="How is Text to Speech usage calculated?">
    Text to Speech consumes 2 credits per minute of generated audio, and higher-tier plans have a daily limit on the number of synthesis jobs.
  </Accordion>
</AccordionGroup>

***

## Support

Need help understanding your usage or have questions about limits?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset" href="mailto:support@tryhamsa.com">
    Get help from our technical team
  </Card>

  <Card title="Documentation" icon="book" href="https://docs.tryhamsa.com">
    Browse complete documentation
  </Card>
</CardGroup>