# create transcription task
curl -H "Content-Type:application/octet-stream" --data-binary @/path/to/your/file.m4a "https://api.speechtext.ai/recognize?key=SECRET_KEY&language=en-US&punctuation=true&format=m4a"

# retrieve transcription results
curl -X GET "https://api.speechtext.ai/results?key=SECRET_KEY&task=TASK_ID&summary=true&summary_size=15&highlights=true&max_keywords=10"

# get captions
curl -X GET "https://api.speechtext.ai/results?key=SECRET_KEY&task=TASK_ID&output=srt&max_caption_words=10"

# process public URL
curl -X GET "https://api.speechtext.ai/recognize?key=SECRET_KEY&url=PUBLIC_URL&language=en-US&punctuation=true&format=mp3"
                        

<?php

$secret_key = "SECRET_KEY";

# loads the audio
$filesize = filesize('/path/to/your/file.m4a');
$fp = fopen('/path/to/your/file.m4a', 'rb');
// read the entire file into a binary string
$binary = fread($fp, $filesize);

# endpoint and options to start a transcription task
$endpoint = "https://api.speechtext.ai/recognize?key=".$secret_key."&language=en-US&punctuation=true&format=m4a";
$header = array('Content-type: application/octet-stream');

# curl connection initialization
$ch = curl_init();

# curl options
curl_setopt_array($ch, array(
    CURLOPT_URL => $endpoint,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HEADER => false,
    CURLOPT_HTTPHEADER => $header,
    CURLOPT_POSTFIELDS => $binary,
    CURLOPT_FOLLOWLOCATION => true
));

# send an audio transcription request
$body = curl_exec($ch);

if (curl_errno($ch))
{
    echo "CURL error: ".curl_error($ch);
}
else
{
    # parse JSON results
    $r = json_decode($body, true);
    # get the id of the speech recognition task
    $task = $r['id'];
    echo "Task ID: ".$task."\r\n";
    
    # endpoint to check status of the transcription task and retrieve results
    $endpoint = "https://api.speechtext.ai/results?key=".$secret_key."&task=".$task."&summary=true&summary_size=15&highlights=true&max_keywords=15";
    curl_setopt_array($ch, array(
        CURLOPT_URL => $endpoint,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => false,
        CURLOPT_HEADER => false,
        CURLOPT_FOLLOWLOCATION => true
    ));
    echo "Get transcription results, summary, and highlights\r\n";
    # use a loop to check if the task is finished
    while (true)
    {
        $body = curl_exec($ch);
        $results = json_decode($body, true);
        echo "Task status: ".$results['status']."\r\n";
        if (!array_key_exists('status', $results))
        {
            break;
        }
        if ($results['status'] == 'failed')
        {
            echo "The task is failed!\r\n";
        }
        if ($results['status'] == 'finished')
        {
            break;
        }
        # sleep for 15 seconds if the task has the status - 'processing'
        sleep(15);
    }
    print_r($results);
}

curl_close($ch);
                        

import java.net.*;
import java.io.*;
import java.util.concurrent.TimeUnit;
import org.json.*;


public class Transcriber {

    public static void main(String[] args) throws Exception {
        String secret_key = "SECRET_KEY";
        HttpURLConnection conn;
        
        // endpoint and options to start a transcription task
        URL endpoint = new URL("https://api.speechtext.ai/recognize?key=" + secret_key +"&language=en-US&punctuation=true&format=m4a");
        
        // loads the audio into memory
        File file = new File("/path/to/your/file.m4a");
        RandomAccessFile f = new RandomAccessFile(file, "r");
        long sz = f.length();
        byte[] post_body = new byte[(int) sz];
        f.readFully(post_body);
        f.close();
        
        // send an audio transcription request
        conn = (HttpURLConnection) endpoint.openConnection();
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "application/octet-stream");
        
        conn.setDoOutput(true);
        conn.connect();
        OutputStream os = conn.getOutputStream();
        os.write(post_body);
        os.flush();
        os.close();
        
        int responseCode = conn.getResponseCode();
        
        if (responseCode == 200) {
            
            BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String line;
            StringBuffer response = new StringBuffer();
            while ((line = in .readLine()) != null) {
                response.append(line);
            } in .close();
            String result = response.toString();
            JSONObject json = new JSONObject(result);
            // get the id of the speech recognition task
            String task = json.getString("id");
            System.out.println("Task ID: " + task);
            // endpoint to check status of the transcription task
            URL res_endpoint = new URL("https://api.speechtext.ai/results?key=" +secret_key + "&task=" + task + "&summary=true&summary_size=15&highlights=true&max_keywords=15");
            System.out.println("Get transcription results, summary, and highlights");
            // use a loop to check if the task is finished
            JSONObject results;
            while (true) {
                conn = (HttpURLConnection) res_endpoint.openConnection();
                conn.setRequestMethod("GET");
                in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
                response = new StringBuffer();
                String res;
                while ((res = in .readLine()) != null) {
                    response.append(res);
                } in .close();
                results = new JSONObject(response.toString());
                System.out.println("Task status: " + results.getString("status"));
                if (results.getString("status").equals("failed")) {
                    System.out.println("Failed to transcribe!");
                    break;
                }
                if (results.getString("status").equals("finished")) {
                    System.out.println(results);
                    break;
                }
                // sleep for 15 seconds if the task has the status - 'processing'
                TimeUnit.SECONDS.sleep(15);
            }
            
        } else {
            
            System.out.println("Failed to transcribe!");
        }
    }
}