At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key comes from
ASSEMBLYAI_API_KEY. - Docs: https://www.assemblyai.com/docs/api-reference/overview
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
ASSEMBLYAI_API_KEY | Yes | AssemblyAI API key from the dashboard Docs. |
Setup
- Create an AssemblyAI account: Go to https://www.assemblyai.com/app and sign up. New accounts include free transcription credits for testing.
- 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.
- Store the key: Add the key to your .env file as ASSEMBLYAI_API_KEY=…
- Verify access: Run the List Transcripts tool to confirm the key works, then submit a sample file such as 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
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.