List transcripts

[Swimburger]

Please describe your feature request
Add ability to list all transcripts. This would make it easier to follow some guides where the transcript ID's are required, such as LeMUR related guides.

[Swimburger]

I am unable to retrieve a list or file ID for a transcript I created yesterday. I am using Powershell on Windows.

Unfortunately the CLI doesn't have a built-in way to list the transcripts, but please use this PowerShell script for your convenience:

$ApiKey = '<YOUR_ASSEMBLY_API_KEY>';
$BaseUrl = 'https://api.assemblyai.com';
$Params = '?limit=20&status=completed';

$ListUrl = "$BaseUrl/v2/transcript$Params";

while ($null -ne $ListUrl) {
  $ResponseBody = Invoke-WebRequest -Uri $ListUrl `
    -Method Get `
    -Headers @{ Authorization = $ApiKey } `
  | Select-Object -ExpandProperty Content
  | ConvertFrom-Json;
  $ResponseBody.transcripts | Format-List;

  $ListUrl = $ResponseBody.page_details.next_url;
}

[Laurette777]

Thank you so much. I was wondering if you could help me with one more thing. How can I get the transcript without the timestamps at the start of each sentence? I would prefer it to come just like it does on the playground, just with speakers identified and then the text? Sent with [Proton Mail](https://proton.me/) secure email.

…

------- Original Message -------

On Tuesday, August 22nd, 2023 at 10:34, Niels Swimberghe ***@***.***> wrote: > I am unable to retrieve a list or file ID for a transcript I created yesterday. I am using Powershell on Windows. Unfortunately the CLI doesn't have a built-in way to list the transcripts, but please use this PowerShell script for your convenience: $ApiKey = ' <YOUR_ASSEMBLY_API_KEY> ' ; $BaseUrl = ' https://api.assemblyai.com ' ; $Params = ' ?limit=20&status=completed ' ; $ListUrl = " $BaseUrl /v2/transcript $Params " ; while ( $null -ne $ListUrl ) { $ResponseBody = Invoke-WebRequest - Uri $ListUrl ` - Method Get ` - Headers @ { Authorization = $ApiKey } ` | Select-Object - ExpandProperty Content | ConvertFrom-Json ; $ResponseBody .transcripts | Format-List ; $ListUrl = $ResponseBody .page_details.next_url ; } — Reply to this email directly, [view it on GitHub](#103 (comment)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/BCB4ZRK52KCKNG5Y7GPF57LXWQLDHANCNFSM6AAAAAA2OPPWFY). You are receiving this because you commented.Message ID: ***@***.***>

[Swimburger]

Before running the script, did you replace <YOUR_ASSEMBLY_API_KEY> with your AssemblyAI API key?
I'm testing the script on macOS with PowerShell 7.3.6, but it should work with older versions of PowerShell.

The listing of transcripts will only give you some details about the transcript like below, but not the text or speaker labels.

id           : 68xxx
resource_url : https://api.assemblyai.com/v2/transcript/68xxx
status       : completed
created      : 8/22/2023 4:47:28 PM
completed    : 8/22/2023 4:47:43 PM
audio_url    : https://cdn.assemblyai.com/upload/44xxx

When you use the CLI, you can create a new transcript with speaker labels like this:

assemblyai transcribe <path_or_url_to_audio_file> --speaker_labels

And the output looks like this:

00:00	(Speaker A)	Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US.
     	           	Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air
     	           	quality warnings include the warning to stay inside. We wanted to better understand what's
     	           	happening here and why, so we called Peter DiCarlo, an associate professor in the Department of
     	           	Environmental Health and Engineering at Johns Hopkins University.
00:25	(Speaker A)	Good morning, professor.
00:27	(Speaker B)	Good morning.
00:29	(Speaker A)	So what is it about the conditions right now that have caused this round of wildfires to affect
     	           	so many people so far away?
00:39	(Speaker B)	Well, there's a couple of things. The season has been pretty dry already, and then the fact
     	           	that we're getting hit in the US. Is because there's a couple of weather systems that are
     	           	essentially channeling the smoke from those Canadian wildfires through Pennsylvania into the
     	           	Mid Atlantic and the Northeast and kind of just dropping the smoke there.

You can also get the JSON by adding the --json flag, and then you'll need to extract the speaker label data from the JSON.
The JSON structure for speaker labels is documented here.

You can also get the JSON for existing transcripts like this:

assemblyai get <transcript_id>

If you created the transcript with speaker_labels turned on, it'll be formatted like the previous output, if not it'll be formatted similarly but without the speaker labels.

You can also add the --json flag to get the complete JSON and extract the data as you wish yourself.

Or you can do everything via PowerShell by communicating with the AssemblyAI API using Invoke-WebRequest or Invoke-RestMethod.

[Laurette777]

Okay, it works on Powershell on my mac. Is there a code to delete a transcript through the CLI once I have the ID number? Thank-you. Sent with [Proton Mail](https://proton.me/) secure email.

…

------- Original Message -------

On Wednesday, August 23rd, 2023 at 01:01, Niels Swimberghe ***@***.***> wrote: Before running the script, did you replace <YOUR_ASSEMBLY_API_KEY> with your AssemblyAI API key? I'm testing the script on macOS with PowerShell 7.3.6, but it should work with older versions of PowerShell. The listing of transcripts will only give you some details about the transcript like below, but not the text or speaker labels. id : 68xxx resource_url : https://api.assemblyai.com/v2/transcript/68xxx status : completed created : 8/22/2023 4:47:28 PM completed : 8/22/2023 4:47:43 PM audio_url : https://cdn.assemblyai.com/upload/44xxx When you use the CLI, you can create a new transcript with speaker labels like this: assemblyai transcribe <path_or_url_to_audio_file> --speaker_labels And the output looks like this: 00:00 (Speaker A) Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter DiCarlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University. 00:25 (Speaker A) Good morning, professor. 00:27 (Speaker B) Good morning. 00:29 (Speaker A) So what is it about the conditions right now that have caused this round of wildfires to affect so many people so far away? 00:39 (Speaker B) Well, there's a couple of things. The season has been pretty dry already, and then the fact that we're getting hit in the US. Is because there's a couple of weather systems that are essentially channeling the smoke from those Canadian wildfires through Pennsylvania into the Mid Atlantic and the Northeast and kind of just dropping the smoke there. You can also get the JSON by adding the --json flag, and then you'll need to extract the speaker label data from the JSON. The [JSON structure for speaker labels is documented here](https://www.assemblyai.com/docs/Models/speaker_diarization#understanding-the-response). You can also get the JSON for existing transcripts like this: assemblyai get <transcript_id> If you created the transcript with speaker_labels turned on, it'll be formatted like the previous output, if not it'll be formatted similarly but without the speaker labels. You can also add the --json flag to get the complete JSON and extract the data as you wish yourself. Or you can do everything via PowerShell by communicating with the AssemblyAI API using Invoke-WebRequest or Invoke-RestMethod. — Reply to this email directly, [view it on GitHub](#103 (comment)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/BCB4ZRMF5B3CRTLD4QN3SFTXWTQWTANCNFSM6AAAAAA2OPPWFY). You are receiving this because you commented.Message ID: ***@***.***>

[Swimburger]

@Laurette777
5.1 is Windows PowerShell which is often missing features/behavior that the cross-platform PS Core has.
You'll have to modify the script to work on Windows PowerShell. Unfortunately I don't have a Windows machine at my disposal ATM.

There's no support for deletion either in the CLI. You can delete the transcript using the DELETE HTTP method as documented here.
Here's what a PowerShell script would look like to do this:

$ApiKey = '<YOUR_ASSEMBLY_API_KEY>';
$BaseUrl = 'https://api.assemblyai.com';
$TranscriptId = '68xxxx';

Invoke-WebRequest `
  -Uri "$BaseUrl/v2/transcript/$TranscriptId" `
  -Method Delete `
  -Headers @{ Authorization = $ApiKey };

[panckreous]

any thoughts on continuing to build this out? I'd love to be able to do everything I want with it. Listing existing transcripts, or even just the most recent x, would be helpful.