Account Management

On the AssemblyAI dashboard, you can manage your projects and API keys, and see a breakdown of your usage and spend.

Projects

Projects can be used to isolate data for different environments or applications, e.g., production, staging, or development. Each project has its own API keys, allowing for better organization and data access control.

Transcripts and other project-specific data is accessible only within the project they were created in — An API key from one project will not be able to access historical transcripts or data from another project. This separation maintains data security and prevents unintended cross-project access.

This project-level scoping also applies to files uploaded via the /upload endpoint. An API key can only transcribe files that were uploaded within the same project. If you need to transcribe the same file across multiple projects, you must upload it separately in each project.

You can create, rename, and delete projects based on your plan:

API Keys

API keys are unique credentials that authenticate requests to the API. Each API key is associated with a specific project, ensuring secure and controlled access.

You can create and delete API keys based on your plan:

Create a new API Key

1. Log in to your AssemblyAI Dashboard
2. Navigate to the “API Keys” section
3. Click the “Create New API Key” button
4. Enter a descriptive name for your API key (e.g., “Production API”, “Development API”)
5. Click “Create”

Delete an API Key

1. Log in to your AssemblyAI Dashboard
2. Navigate to the “API Keys” section
3. Locate the API key you want to delete
4. Click the “Delete” button next to the key
5. Confirm the deletion in the popup dialog

Reporting

Get insights into your usage and spend to track and manage costs effectively with the reporting tool in the AssemblyAI dashboard. You can analyze your usage and spend data at different levels of granularity:

• Account
• Product (e.g., Speech-to-text, Streaming, LLM Gateway)
• Models (e.g., Best, Claude 3.5 Sonnet, etc.)
• Project
• API key

Usage Limits

To ensure a smooth experience for all users, certain operations have per-account usage limits.

• Concurrency limits for asynchronous operations
• Rate limits for synchronous operations

In addition to concurrency limits, there is a rate limit for the API that restricts accounts to a maximum of 20,000 requests per five minutes.

Pre-recorded audio Speech-to-Text usage limits

AssemblyAI limits the number of transcriptions being processed at any given time.

For more details on queuing behavior, throttle notifications, and how to check your limit, see Pre-Recorded STT Concurrency.

Streaming Speech-to-Text usage limits

Usage limits for streaming speech-to-text are distinct from pre-recorded audio speech-to-text usage limits. Your streaming concurrency dictates the number of new streaming sessions that can be opened per minute.

For more details on auto-scaling, scale-down behavior, and session termination, see Streaming STT Concurrency.

LLM Gateway usage limits

Your LLM Gateway usage limit dictates the number of requests you can make within a 60-second time window. For more information, see Rate limits.

Each LLM Gateway model has its own separate rate limit. Requests to one model will not affect the number of requests per minute that you can make to another model.

Billing and customer usage tracking

The Reporting section in your dashboard provides a breakdown of usage and spend. If you need to track usage programmatically on a per-customer basis, you can use webhooks with custom query parameters for async transcription, or capture the session_duration_seconds from the WebSocket Termination event for streaming.

For async transcription, append a customer_id query parameter to your webhook URL when submitting a transcription:

https://your-domain.com/webhook?customer_id=customer_123

When the transcription completes, extract the customer_id from the webhook URL and retrieve the audio_duration from the transcript response to record usage.

For streaming transcription, manage customer IDs in your application state and capture the session_duration_seconds from the Termination event. AssemblyAI bills streaming based on session duration.

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.

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.

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.

How to delete your account

If you need to delete your account and all associated data, you can do so through your Dashboard:

1. Log in to your AssemblyAI Dashboard
2. Navigate to the Account page
3. Click the Delete Account button
4. Follow the prompts to complete the account deletion process

If you encounter any issues during the deletion process or have additional questions, please contact us at support@assemblyai.com for assistance.

Best Practices

• Use different API keys for development and production environments
• Monitor usage and spend patterns for each API key in your dashboard
• Keep your API keys secure and never expose them in client-side code
• Use meaningful names and tags to easily identify the purpose of each key
• Store API keys as environment variables in your application