var Component=(()=>{var g=Object.create;var o=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var w=Object.getPrototypeOf,T=Object.prototype.hasOwnProperty;var y=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),$=(e,t)=>{for(var r in t)o(e,r,{get:t[r],enumerable:!0})},c=(e,t,r,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of m(t))!T.call(e,s)&&s!==r&&o(e,s,{get:()=>t[s],enumerable:!(a=f(t,s))||a.enumerable});return e};var x=(e,t,r)=>(r=e!=null?g(w(e)):{},c(t||!e||!e.__esModule?o(r,"default",{value:e,enumerable:!0}):r,e)),R=e=>c(o({},"__esModule",{value:!0}),e);var u=y((E,d)=>{d.exports=_jsx_runtime});var P={};$(P,{default:()=>_,frontmatter:()=>C,toc:()=>b});var n=x(u());var{useMDXComponents:l}=MdxJsReact;var b=[{simpleString:"API Reference",anchorString:"api-reference",children:[],featureFlags:void 0}];var C={title:"Word-level timestamps"};function h(e){let t={h2:"h2",p:"p",...l(),...e.components},{CodeBlock:r,CodeGroup:a,ErrorBoundary:s,Json:p}=t;return r||i("CodeBlock",!0),a||i("CodeGroup",!0),s||i("ErrorBoundary",!0),p||i("Json",!0),(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(t.p,{children:"The response also includes an array with information about each word:"}),` `,(0,n.jsx)(s,{children:(0,n.jsxs)(a,{children:[(0,n.jsx)(s,{children:(0,n.jsx)(r,{code:`import assemblyai as aai aai.settings.api_key = "" # audio_file = "./local_file.mp3" audio_file = "https://assembly.ai/wildfires.mp3" config = aai.TranscriptionConfig() transcript = aai.Transcriber().transcribe(audio_file, config) for word in transcript.words: print(f"Word: {word.text}, Start: {word.start}, End: {word.end}, Confidence: {word.confidence}") `,className:"language-python",language:"python",title:"Python SDK",highlight:13,maxLines:15})}),(0,n.jsx)(s,{children:(0,n.jsx)(r,{code:`import requests import time base_url = "https://api.assemblyai.com" headers = { "authorization": "" } with open("./my-audio.mp3", "rb") as f: response = requests.post(base_url + "/v2/upload", headers=headers, data=f) upload_url = response.json()["upload_url"] data = { "audio_url": upload_url # You can also use a URL to an audio or video file on the web } url = base_url + "/v2/transcript" response = requests.post(url, json=data, headers=headers) transcript_id = response.json()['id'] polling_endpoint = base_url + "/v2/transcript/" + transcript_id while True: transcription_result = requests.get(polling_endpoint, headers=headers).json() if transcription_result['status'] == 'completed': for word in transcription_result['words']: print(f"Word: {word['word']}, Start: {word['start']}, End: {word['end']}, Confidence: {word['confidence']}") break elif transcription_result['status'] == 'error': raise RuntimeError(f"Transcription failed: {transcription_result['error']}") else: time.sleep(3) `,className:"language-python",language:"python",title:"Python",highlight:33,maxLines:15})}),(0,n.jsx)(s,{children:(0,n.jsx)(r,{code:`import { AssemblyAI } from 'assemblyai' const client = new AssemblyAI({ apiKey: '' }) // const audioFile = './local_file.mp3' const audioFile = 'https://assembly.ai/wildfires.mp3' const params = { audio: audioFile } const run = async () => { const transcript = await client.transcripts.transcribe(params) console.log(transcript.text) // Print word-level details for (const word of transcript.words) { console.log(\`Word: \${word.text}, Start: \${word.start}, End: \${word.end}, Confidence: \${word.confidence}\`) } } run() `,className:"language-ts",language:"ts",title:"TypeScript SDK",highlight:22,maxLines:15})}),(0,n.jsx)(s,{children:(0,n.jsx)(r,{code:`import axios from 'axios' import fs from 'fs-extra' const baseUrl = 'https://api.assemblyai.com' const headers = { authorization: '' } const path = './my-audio.mp3' const audioData = await fs.readFile(path) const uploadResponse = await axios.post(\`\${baseUrl}/v2/upload\`, audioData, { headers }) const uploadUrl = uploadResponse.data.upload_url const data = { audio_url: uploadUrl // You can also use a URL to an audio or video file on the web } const url = \`\${baseUrl}/v2/transcript\` const response = await axios.post(url, data, { headers: headers }) const transcriptId = response.data.id const pollingEndpoint = \`\${baseUrl}/v2/transcript/\${transcriptId}\` while (true) { const pollingResponse = await axios.get(pollingEndpoint, { headers: headers }) const transcriptionResult = pollingResponse.data if (transcriptionResult.status === 'completed') { console.log(transcriptionResult.text) // Print word-level details for (const word of transcriptionResult.words) { console.log(\`Word: \${word.text}, Start: \${word.start}, End: \${word.end}, Confidence: \${word.confidence}\`) } break } else if (transcriptionResult.status === 'error') { throw new Error(\`Transcription failed: \${transcriptionResult.error}\`) } else { await new Promise((resolve) => setTimeout(resolve, 3000)) } } `,className:"language-ts",language:"ts",title:"TypeScript",highlight:37,maxLines:15})}),(0,n.jsx)(s,{children:(0,n.jsx)(r,{code:`using System; using System.IO; using System.Net.Http; using System.Net.Http.Headers; using System.Net.Http.Json; using System.Text; using System.Text.Json; using System.Threading.Tasks; using (var httpClient = new HttpClient()) { httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(""); } private static async Task UploadFileAsync(string filePath, HttpClient httpClient) { using (var fileStream = File.OpenRead(filePath)) using (var fileContent = new StreamContent(fileStream)) { fileContent.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream"); using (var response = await httpClient.PostAsync("https://api.assemblyai.com/v2/upload", fileContent)) { response.EnsureSuccessStatusCode(); var jsonDoc = await response.Content.ReadFromJsonAsync(); return jsonDoc.RootElement.GetProperty("upload_url").GetString(); } } } private static async Task CreateTranscriptAsync(string audioUrl, HttpClient httpClient) { var data = new { audio_url = audioUrl}; var content = new StringContent(JsonSerializer.Serialize(data), Encoding.UTF8, "application/json"); using (var response = await httpClient.PostAsync("https://api.assemblyai.com/v2/transcript", content)) { response.EnsureSuccessStatusCode(); return await response.Content.ReadFromJsonAsync(); } } public class Transcript { public string Id { get; set; } public string Status { get; set; } public string Text { get; set; } public Word[] Words { get; set; } [JsonPropertyName("language_code")] public string LanguageCode { get; set; } public string Error { get; set; } } public class Word { public string Text { get; set; } public int Start { get; set; } public int End { get; set; } public float Confidence { get; set; } } private static async Task WaitForTranscriptToProcess(Transcript transcript, HttpClient httpClient) { var pollingEndpoint = $"https://api.assemblyai.com/v2/transcript/{transcript.Id}"; while (true) { var pollingResponse = await httpClient.GetAsync(pollingEndpoint); transcript = await pollingResponse.Content.ReadFromJsonAsync(); switch (transcript.Status) { case "processing": case "queued": await Task.Delay(TimeSpan.FromSeconds(3)); break; case "completed": return transcript; case "error": throw new Exception($"Transcription failed: {transcript.Error}"); default: throw new Exception("This code shouldn't be reachable."); } } } using (var httpClient = new HttpClient()) { httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(""); var uploadUrl = await UploadFileAsync("/my_audio.mp3", httpClient); var transcript = await CreateTranscriptAsync(uploadUrl, httpClient); transcript = await WaitForTranscriptToProcess(transcript, httpClient); Console.WriteLine(transcript.Text); // Print word-level details foreach (var word in transcript.Words) { Console.WriteLine($"Word: {word.Text}, Start: {word.Start}, End: {word.End}, Confidence: {word.Confidence}"); } } `,className:"language-csharp",language:"csharp",title:"C#",highlight:103,maxLines:15})}),(0,n.jsx)(s,{children:(0,n.jsx)(r,{code:`require 'net/http' require 'json' base_url = 'https://api.assemblyai.com' headers = { 'authorization' => '', 'content-type' => 'application/json' } path = "./my-audio.mp3" uri = URI("#{base_url}/v2/upload") request = Net::HTTP::Post.new(uri, headers) request.body = File.read(path) http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = true upload_response = http.request(request) upload_url = JSON.parse(upload_response.body)["upload_url"] data = { "audio_url" => upload_url # You can also use a URL to an audio or video file on the web } uri = URI.parse("#{base_url}/v2/transcript") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = true request = Net::HTTP::Post.new(uri.request_uri, headers) request.body = data.to_json response = http.request(request) response_body = JSON.parse(response.body) unless response.is_a?(Net::HTTPSuccess) raise "API request failed with status #{response.code}: #{response.body}" end transcript_id = response_body['id'] puts "Transcript ID: #{transcript_id}" polling_endpoint = URI.parse("#{base_url}/v2/transcript/#{transcript_id}") while true polling_http = Net::HTTP.new(polling_endpoint.host, polling_endpoint.port) polling_http.use_ssl = true polling_request = Net::HTTP::Get.new(polling_endpoint.request_uri, headers) polling_response = polling_http.request(polling_request) transcription_result = JSON.parse(polling_response.body) if transcription_result['status'] == 'completed' puts "Transcription text: #{transcription_result['text']}" # Print word-level details transcription_result['words'].each do |word| puts "Word: #{word['text']}, Start: #{word['start']}, End: #{word['end']}, Confidence: #{word['confidence']}" end break elsif transcription_result['status'] == 'error' raise "Transcription failed: #{transcription_result['error']}" else puts 'Waiting for transcription to complete...' sleep(3) end end `,className:"language-ruby",language:"ruby",title:"Ruby",highlight:[55,56],maxLines:15})}),(0,n.jsx)(s,{children:(0,n.jsx)(r,{code:`", "content-type: application/json" ); $path = "./my-audio.mp3"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $base_url . "/v2/upload"); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, file_get_contents($path)); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $response = curl_exec($ch); $response_data = json_decode($response, true); $upload_url = $response_data["upload_url"]; curl_close($ch); $data = array( "audio_url" => $upload_url // You can also use a URL to an audio or video file on the web ); $url = $base_url . "/v2/transcript"; $curl = curl_init($url); curl_setopt($curl, CURLOPT_POST, true); curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($data)); curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($curl); $response = json_decode($response, true); curl_close($curl); $transcript_id = $response['id']; echo "Transcript ID: $transcript_id\\n"; $polling_endpoint = $base_url . "/v2/transcript/" . $transcript_id; while (true) { $polling_response = curl_init($polling_endpoint); curl_setopt($polling_response, CURLOPT_HTTPHEADER, $headers); curl_setopt($polling_response, CURLOPT_RETURNTRANSFER, true); $transcription_result = json_decode(curl_exec($polling_response), true); if ($transcription_result['status'] === "completed") { echo $transcription_result['text']; // Print word-level details foreach ($transcription_result['words'] as $word) { echo sprintf("Word: %s, Start: %d, End: %d, Confidence: %f\\n", $word['text'], $word['start'], $word['end'], $word['confidence']); } break; } else if ($transcription_result['status'] === "error") { throw new Exception("Transcription failed: " . $transcription_result['error']); } else { sleep(3); } } `,className:"language-php",language:"php",title:"PHP",highlight:[62,63,64,65],maxLines:15})})]})}),` `,(0,n.jsx)(t.h2,{id:"api-reference",children:"API Reference"}),` `,(0,n.jsx)(s,{children:(0,n.jsx)(p,{json:{words:[{text:"Smoke",start:240,end:640,confidence:.70473,speaker:null},{text:"from",start:680,end:968,confidence:.99967,speaker:null},{text:"hundreds",start:1024,end:1416,confidence:.99795,speaker:null},{text:"of",start:1448,end:1592,confidence:.99926,speaker:null},{text:"wildfires",start:1616,end:2248,confidence:.99838,speaker:null},{text:"in",start:2264,end:2440,confidence:.99782,speaker:null},{text:"Canada",start:2480,end:2968,confidence:.99977,speaker:null},{text:"is",start:3104,end:3400,confidence:.99652,speaker:null},{text:"triggering",start:3440,end:3864,confidence:.99949,speaker:null},{text:"air",start:3912,end:4120,confidence:.99988,speaker:null},{text:"quality",start:4160,end:4584,confidence:.56204,speaker:null},{text:"alerts",start:4632,end:5064,confidence:.70445,speaker:null},{text:"throughout",start:5112,end:5416,confidence:.99892,speaker:null},{text:"the",start:5448,end:5640,confidence:.99965,speaker:null},{text:"US",start:5680,end:6264,confidence:.97691,speaker:null},{text:"Skylines",start:6432,end:7208,confidence:.99802,speaker:null},{text:"from",start:7224,end:7400,confidence:.99862,speaker:null},{text:"Maine",start:7440,end:7928,confidence:.70316,speaker:null},{text:"to",start:8024,end:8232,confidence:.99752,speaker:null},{text:"Maryland",start:8256,end:8632,confidence:.99361,speaker:null},{text:"to",start:8696,end:8872,confidence:.99604,speaker:null},{text:"Minnesota",start:8896,end:9592,confidence:.99908,speaker:null},{text:"are",start:9656,end:9880,confidence:.99898,speaker:null},{text:"gray",start:9920,end:10136,confidence:.50474,speaker:null},{text:"and",start:10168,end:10360,confidence:.99928,speaker:null},{text:"smoggy.",start:10400,end:11e3,confidence:.99366,speaker:null}]}})})]})}function _(e={}){let{wrapper:t}={...l(),...e.components};return t?(0,n.jsx)(t,{...e,children:(0,n.jsx)(h,{...e})}):h(e)}function i(e,t){throw new Error("Expected "+(t?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}return R(P);})(); ;return Component;