Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added fern/assets/img/faq/api-key.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/assets/img/faq/autopay.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/assets/img/faq/error.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/assets/img/faq/error2.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/assets/img/faq/playground.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/assets/img/faq/playground2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/assets/img/faq/support.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/assets/img/faq/support2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
445 changes: 444 additions & 1 deletion fern/docs.yml

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Can an account have more than one API key?"
---

Yes, accounts can have multiple API keys! You can create additional API keys in your [dashboard](https://www.assemblyai.com/app/api-keys). You can also organize those API keys within "Projects". See [our official documentation](https://www.assemblyai.com/docs/deployment/account-management) to learn more.
16 changes: 16 additions & 0 deletions fern/pages/faq/accounts-billing-pricing/can-i-sign-up-for-free.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: "Can I sign up for free?"
---

Yes! You can use the API for free on a limited trial. Simply add a credit card to your account at any time to upgrade from the trial.

An account on the free tier has access to our pre-recorded audio transcription and Audio Intelligence features using our Async `/v2/transcript` endpoint. It also has access to our streaming STT feature using our `wss://streaming.assemblyai.com/v3/ws` endpoint.

An account on the free tier can transcribe up to \$50 in transcription and will be able to process up to five files concurrently. If you upgrade your account before using \$50 in transcription any unused amount will be retained on your account.

Once you have transcribed \$50 worth of files you will need to upgrade your account to continue using the API.

<Note>
The free tier does not include access to LeMUR. To use LeMUR, you will need to
upgrade your account by adding a credit card.
</Note>
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Do my free credits expire?"
---

No - your free credits don't expire and will remain in your account until used, even if you upgrade your account.
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Do you have any type of special pricing for non-profit companies?"
---

In some cases we are able to offer discounts to non-profit companies. To learn more please reach out to [support@assemblyai.com](mailto:support@assemblyai.com) with more information about your company and use case and we would happy to discuss how we might be able to help.
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Do you offer a student discount?"
---

We do offer student discounts for accounts associated with valid educational email addresses. To learn more please reach out to [support@assemblyai.com](mailto:support@assemblyai.com) with the email address associated with your account and information on your educational institution and we would be happy to help!
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Do you offer special pricing for start-ups?"
---

Startups can apply for our AssemblyAI Startup Program which is designed for early-stage startups to innovate and build powerful products from voice data without financial constraints, using the industry-leading speech-to-text API. [Apply here](https://www.assemblyai.com/startup-program).
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Do you offer special pricing for YCombinator companies?"
---

We do offer special pricing for YCombinator companies! Please reach out to us [here](https://www.assemblyai.com/contact) to discuss this discount and see if you qualify.
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Do you offer volume discounts?"
---

Absolutely! If you plan to send large volumes of audio and video content through our API, please reach out to us [here](https://www.assemblyai.com/contact) to see if you qualify for a volume discount.
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: "How do I add developers to my account?"
---

Currently, our system supports only one email account per user account. This means that adding multiple developers to a single team account is not directly possible at this time.

## Recommended workaround

To share access among team members, we recommend using a password manager like 1Password. This allows you to securely share the account credentials between multiple developers.

## Steps to share access:

1. Set up a shared vault in your password manager
2. Store the account credentials in this shared vault
3. Invite team members to access the shared vault
4. Team members can now use the shared credentials to access the account

<Note>
When sharing credentials, ensure all team members follow best practices for
security, such as using strong, unique passwords and enabling two-factor
authentication where possible.
</Note>

## Future updates

We are actively working on improving our dashboard to support multi-user accounts. These improvements are expected to be available towards the end of Q4. Once released, you'll be able to add multiple developers to your team directly within the platform.

<Note>
If you are not already, consider following [our
Changelog](https://www.assemblyai.com/changelog) to learn about new features
and improvements as they are released.
</Note>
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "How do I change my account email address?"
---

To change your email address, send a request to [support@assemblyai.com](mailto:support@assemblyai.com) from your current registered email address, specifying the new email you'd like to use.
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "How do I update company information on my invoices?"
---

To update your billing information, please email [support@assemblyai.com](mailto:support@assemblyai.com) with the details you would like to appear on your invoices.
27 changes: 27 additions & 0 deletions fern/pages/faq/accounts-billing-pricing/how-does-auto-pay-work.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
title: "How does Auto-pay work?"
---

Auto-pay automatically recharges your account when your balance falls below a specified threshold. When triggered, it charges your card to bring your balance back to a predetermined amount. Auto-pay is recommended for production environments to prevent service interruptions.

<Frame>
<img src="/assets/img/faq/autopay.png" />
</Frame>

### Example

If you set:

- Whenever my balance falls below: \$25
- Bring my balance back to: \$50

When your balance of \$26 drops to \$21 after a \$5 charge, auto-pay will add \$29 to reach your \$50 target balance.

<Note>
When your balance hits \$0 without auto-pay, your API access is restricted
until you add funds.
</Note>

Enable auto-pay and maintain a healthy balance to ensure uninterrupted API access. Set your threshold based on your typical monthly usage to avoid frequent small charges.

You can also disable auto-pay at any time through your account settings.
30 changes: 30 additions & 0 deletions fern/pages/faq/accounts-billing-pricing/how-does-pricing-work.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: "How does pricing work?"
---

Our pricing is Pay-As-You-Go. For pre-recorded audio, pricing is based on the duration of the audio file submitted, the Speech Model selected, and the features used in the request. For streaming audio, pricing is based on the duration of the streaming session.

Current pricing for pre-recorded audio on the Universal tier is \$0.27 per hour, and the Nano tier is \$0.12 per hour. Streaming STT is \$0.15 per hour. Audio Intelligence pricing depends on the models being used. LeMUR pricing is based on input and output size.

You can find the breakdown of all our pricing information on our [Pricing page](https://www.assemblyai.com/pricing)!

## Pricing Structure (pre-recorded audio)

Check warning on line 11 in fern/pages/faq/accounts-billing-pricing/how-does-pricing-work.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Pricing Structure (pre-recorded audio)'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Pricing Structure (pre-recorded audio)'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-does-pricing-work.mdx", "range": {"start": {"line": 11, "column": 4}}}, "severity": "WARNING"}

- We charge based on the actual duration of your audio/video files in seconds
- Rates are listed per hour for simplicity (e.g., \$0.27/hour), but we pro-rate to the exact second
- Additional features (like Entity Detection) are also charged at their respective hourly rates

## Pricing Structure (streaming audio)

Check warning on line 17 in fern/pages/faq/accounts-billing-pricing/how-does-pricing-work.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Pricing Structure (streaming audio)'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Pricing Structure (streaming audio)'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-does-pricing-work.mdx", "range": {"start": {"line": 17, "column": 4}}}, "severity": "WARNING"}

- We charge based on the duration of the created session

## Credit System

Check warning on line 21 in fern/pages/faq/accounts-billing-pricing/how-does-pricing-work.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Credit System'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Credit System'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-does-pricing-work.mdx", "range": {"start": {"line": 21, "column": 4}}}, "severity": "WARNING"}

- Add credits to your account balance
- Credits are deducted only after successful transcription completion
- Failed transcripts are not charged
- We don't offer unlimited usage plans or monthly subscriptions - we only charge you for what you use.

## Example

A 30-minute file at \$0.12/hour would cost \$0.06 (30 minutes = 0.5 hours × \$0.12). If you add Entity Detection at \$0.08/hour, the total would be \$0.10 `(\$0.12 + \$0.08) × 0.5`.
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: "How does the concurrency limit work for transcription requests?"
---

AssemblyAI's transcription service for pre-recorded audio uses a concurrency limit to manage the number of simultaneous transcription jobs that can be processed for each account. This article explains how the concurrency limit works and what happens when you reach it.

## Understanding the Concurrency Limit

Check warning on line 7 in fern/pages/faq/accounts-billing-pricing/how-does-the-concurrency-limit-work-for-transcription-requests.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Understanding the Concurrency Limit'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Understanding the Concurrency Limit'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-does-the-concurrency-limit-work-for-transcription-requests.mdx", "range": {"start": {"line": 7, "column": 4}}}, "severity": "WARNING"}

The concurrency limit determines how many transcription jobs can be processed simultaneously for your account. When you submit transcription requests:

- If you're below the concurrency limit, your job starts processing immediately.
- If you've reached the limit, additional jobs are placed in a queue.

## Queue Processing

Check warning on line 14 in fern/pages/faq/accounts-billing-pricing/how-does-the-concurrency-limit-work-for-transcription-requests.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Queue Processing'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Queue Processing'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-does-the-concurrency-limit-work-for-transcription-requests.mdx", "range": {"start": {"line": 14, "column": 4}}}, "severity": "WARNING"}

When you've reached your concurrency limit:

1. New transcription requests are added to a queue.
2. As soon as a currently processing job finishes, the next job in the queue starts processing.
3. This continues until all queued jobs are processed.

The time it takes for queued jobs to start processing depends on the duration of the audio files currently being transcribed.

## Increasing Your Concurrency Limit

Check warning on line 24 in fern/pages/faq/accounts-billing-pricing/how-does-the-concurrency-limit-work-for-transcription-requests.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Increasing Your Concurrency Limit'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Increasing Your Concurrency Limit'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-does-the-concurrency-limit-work-for-transcription-requests.mdx", "range": {"start": {"line": 24, "column": 4}}}, "severity": "WARNING"}

If you find that the current concurrency limit is insufficient for your needs, you can increase it by upgrading your account. To do this:

1. Add a credit card to your account.
2. Choose a plan that offers a higher concurrency limit.

Upgrading your account not only increases your concurrency limit but may also provide additional features and benefits.

<Note title="Scale to support any workload">
We offer custom concurrency limits that scale to support any workload at no
additional cost. If you need a higher concurrency limit please either [contact
our Sales team](https://www.assemblyai.com/contact) or reach out to us at
[support@assemblyai.com](mailto:support@assemblyai.com).
</Note>

## Best Practices

Check warning on line 40 in fern/pages/faq/accounts-billing-pricing/how-does-the-concurrency-limit-work-for-transcription-requests.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Best Practices'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Best Practices'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-does-the-concurrency-limit-work-for-transcription-requests.mdx", "range": {"start": {"line": 40, "column": 4}}}, "severity": "WARNING"}

To optimize your use of the transcription service:

- Monitor your job queue to anticipate processing times.
- For time-sensitive transcriptions, consider upgrading your account if you frequently hit the concurrency limit.
- Batch your transcription requests efficiently to make the most of your current limit.

If you have any questions about your concurrency limit or need assistance with upgrading your account, please contact our support team.
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: "How often does the Usage and Spend Information in my Dashboard update?"
---

You can find your Usage and Spending information tracked [in your Dashboard](https://www.assemblyai.com/dashboard/cost) as you transcribe using the API.

Your current account balance can be found here here: [https://www.assemblyai.com/dashboard/account/billing](https://www.assemblyai.com/dashboard/account/billing)

Your transcription history can be found here: [https://www.assemblyai.com/dashboard/transcription-history](https://www.assemblyai.com/dashboard/transcription-history)

The usage and spending information in the Dashboard is updated every 2 minutes.

<Note>
Real-Time transcription sessions must be closed for the information to
populate.
</Note>
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
title: "How to Delete Your Account"
---

If you need to delete your account and all associated data, you can do so easily through your Dashboard. Follow these steps:

1. Log in to your account
2. Navigate to the [Account page](https://www.assemblyai.com/dashboard/account/personal) on your Dashboard
3. Look for the "Delete Account" button
4. Follow the prompts to complete the account deletion process

## Important notes

- Account deletion is permanent and cannot be undone
- All data associated with your account will be removed
- Make sure to back up any important information before proceeding with deletion

If you encounter any issues during the deletion process or have additional questions, please contact our support team for assistance.
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: "How to an get AssemblyAI API Key"
---

To obtain your API key for AssemblyAI, follow these simple steps:

1. Visit the [AssemblyAI login page](https://www.assemblyai.com/dashboard/login).

2. Log into your account. If you don't have an account yet, you'll need to sign up first.

3. Once logged in, navigate to your [API Keys page](https://www.assemblyai.com/dashboard/api-keys).

4. Your API key will be displayed here:

<Frame>
<img src="/assets/img/faq/api-key.png" />
</Frame>

## Notes

- Keep your API key secure and do not share it publicly.
- If you need to refresh your API key for any reason, you can do so from the same dashboard.
- Your API key is required to authenticate your requests when using the AssemblyAI API.
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
title: "How to Share Account Access with Team Members"
---

While our platform only allows a single email address and API key per account, there are ways to effectively share access with your team members. Here's how you can manage shared access:

## Creating a Shared Team Account

Check warning on line 7 in fern/pages/faq/accounts-billing-pricing/how-to-share-account-access-with-team-members.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Creating a Shared Team Account'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Creating a Shared Team Account'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-to-share-account-access-with-team-members.mdx", "range": {"start": {"line": 7, "column": 4}}}, "severity": "WARNING"}

The recommended approach for team access is to create a shared account:

1. Set up a new account using a shared email address (e.g., dev@yourcompany.com)
2. Securely share the account credentials with team members using a password manager

## Best Practices for Shared Accounts

Check warning on line 14 in fern/pages/faq/accounts-billing-pricing/how-to-share-account-access-with-team-members.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Best Practices for Shared Accounts'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Best Practices for Shared Accounts'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-to-share-account-access-with-team-members.mdx", "range": {"start": {"line": 14, "column": 4}}}, "severity": "WARNING"}

- Use a generic email address that isn't tied to a specific individual
- Implement strong password policies
- Regularly review and update access as team members join or leave

## Changing the Email Address on an Existing Account

Check warning on line 20 in fern/pages/faq/accounts-billing-pricing/how-to-share-account-access-with-team-members.mdx

View workflow job for this annotation

GitHub Actions / lint

[vale] reported by reviewdog 🐶 [AssemblyAI.Headings] Use sentence-style capitalization for 'Changing the Email Address on an Existing Account'. Raw Output: {"message": "[AssemblyAI.Headings] Use sentence-style capitalization for 'Changing the Email Address on an Existing Account'. ", "location": {"path": "fern/pages/faq/accounts-billing-pricing/how-to-share-account-access-with-team-members.mdx", "range": {"start": {"line": 20, "column": 4}}}, "severity": "WARNING"}

If you need to update the email address associated with your account to a shared email:

1. Contact our support team
2. Request an email address change for your account
3. Provide the new shared email address you'd like to use

<Note>
Remember: Each account can only have one email address and API key. Changing
the email will affect all access associated with the account.
</Note>

By following these guidelines, you can effectively manage shared access to your account while maintaining security and control over your team's usage of our platform.
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "Is AssemblyAI available on the AWS Marketplace?"
---

We are! We can be found on the Marketplace [here](https://aws.amazon.com/marketplace/pp/prodview-j45hta6jdej7c?sr=0-1&ref_=beagle&applicationId=AWSMPContessa). Please [connect with our Sales team](https://www.assemblyai.com/contact/sales) to learn more.
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: "What are my concurrency limits?"
---

A concurrency limit is the number of requests that can be processed for an account at any given time.

Each account has an assigned concurrency limit (also referred to as a throttle limit). For free accounts, the default is 5 for Asynchronous and Streaming transcriptions. For upgraded accounts, the default is 200 for Asynchronous transcriptions and 100 for Streaming transcriptions.

You can check your concurrency limits [on your dashboard](https://www.assemblyai.com/dashboard/rate-limits).

### Asynchronous speech-to-text limits

Below are the default limits for how many requests you can have processing in parallel when submitting jobs to our `/v2/transcript` endpoint.

| Account type | Concurrency limit |
| ------------ | ----------------- |
| Free | 5 |
| Pro | 200 |

### Streaming speech-to-text limits

Below are the default limits for how many Streaming sessions you can have open in parallel.

| Account type | Concurrency limit |
| ------------ | ----------------- |
| Free | 5 |
| Pro | 100 |

Note: Our Streaming STT feature includes automatically scaling concurrency. Anytime you are using 70% or more of your streaming concurrency, your concurrency limit will automatically increase by 10% every sixty seconds.

You can find more information on Concurrency Limits in our Documentation [here](https://www.assemblyai.com/docs/concepts/concurrency-limit)!

### Need a higher concurrency?

We offer custom concurrency limits that scale to support any workload at no additional cost. If you need a higher concurrency limit please either [contact our Sales team](https://www.assemblyai.com/contact) or reach out to us at [support@assemblyai.com](mailto:support@assemblyai.com).

### Rate Limits

In addition to the concurrency limit, there's a rate limit for the API, which restricts users to a maximum of 20,000 requests per five minutes.
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: "What happens if I reach my concurrency limit?"
---

### Async speech-to-text

When you reach your concurrency limit, new requests are automatically queued. As soon as a current transcription completes, the next job in the queue begins processing. All transcripts will be processed, though queued jobs may take longer than usual.

For example, if a user's concurrency limit is set to 200 and they submit 201 transcript requests, the user will receive a throttle alert email. The first 200 transcription requests will begin to process immediately. The 201st one will wait until one of the previous 200 requests has finished before processing.

### Streaming

When you reach your streaming concurrency limit, new requests will receive a `1008` error with the message "`Unauthorized connection: Too many concurrent sessions`".

Note: Our Streaming STT feature includes automatically scaling concurrency. Anytime you are using 70% or more of your streaming concurrency your concurrency limit will automatically increase by 10% every sixty seconds.

<Note title="Need a higher concurrency?">
We offer custom concurrency limits that scale to support any workload at no
additional cost. If you need a higher concurrency limit, please either
[contact our Sales team](https://www.assemblyai.com/contact/sales) or reach
out to us at [support@assemblyai.com](mailto:support@assemblyai.com).
</Note>
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: "What payment methods do you accept?"
---

We accept all major credit cards. ACH transfers are also available in some cases - please contact [support@assemblyai.com](mailto:support@assemblyai.com) to learn more about this option.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
title: "Am I charged for transcribing silent audio?"
---

Yes, our billing is based on audio duration, not the amount of speech content. However, you can use the `speech_threshold` parameter to avoid processing files with minimal speech content. This parameter lets you specify a minimum percentage of speech required for transcription.

[Learn more about speech threshold](/docs/speech-to-text/pre-recorded-audio/speech-threshold)
Loading
Loading