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

# AssemblyAI

> Submit audio URLs for transcription and retrieve transcripts via the AssemblyAI API

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key comes from `ASSEMBLYAI_API_KEY`.
* **Docs**: [https://www.assemblyai.com/docs/api-reference/overview](https://www.assemblyai.com/docs/api-reference/overview)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable             | Required | Description                                                                   |
| -------------------- | -------- | ----------------------------------------------------------------------------- |
| `ASSEMBLYAI_API_KEY` | Yes      | AssemblyAI API key from the dashboard [Docs](https://www.assemblyai.com/app). |

## Setup

1. **Create an AssemblyAI account**: Go to [https://www.assemblyai.com/app](https://www.assemblyai.com/app) and sign up. New accounts include free transcription credits for testing.
2. **Copy your API key**: Your API key is shown on the dashboard home page after signing in. You can rotate it from account settings if needed.
3. **Store the key**: Add the key to your .env file as ASSEMBLYAI\_API\_KEY=...
4. **Verify access**: Run the List Transcripts tool to confirm the key works, then submit a sample file such as [https://assembly.ai/wildfires.mp3](https://assembly.ai/wildfires.mp3)

* Authentication sends the raw API key in the Authorization header - no Bearer prefix
* Transcription is asynchronous: Submit Transcript returns an id with status 'queued'; poll Get Transcript until status is 'completed'
* Transcription is billed per hour of audio once free credits are exhausted; EU data residency uses api.eu.assemblyai.com instead

Provider API reference: [https://www.assemblyai.com/docs/api-reference/overview](https://www.assemblyai.com/docs/api-reference/overview)

## Tools

| Tool              | Access | Description                                                                 |
| ----------------- | ------ | --------------------------------------------------------------------------- |
| Submit Transcript | Write  | Submit an audio or video URL for transcription (processing is asynchronous) |
| Get Transcript    | Read   | Get the status and text of a transcript by ID                               |
| List Transcripts  | Read   | List transcripts created by the account                                     |
| Delete Transcript | Write  | Permanently delete a transcript and its data                                |

## Example prompts

* Submit this audio file to AssemblyAI, wait for it to finish, and give me the transcript: \<paste URL>
* List my recent AssemblyAI transcripts and summarize their statuses.