Quick Start

Get up and running with the Mediatranscribe API

The MediaTranscribe API offers a seamless platform for developers to integrate advanced transcription and text generation capabilities into their applications. With the API, you can tap into an intelligence layer to transcribe audio and video content accurately while leveraging advanced models for tasks like summarization and subtitle generation to elevate the communication capabilities in your applications.

Account Setup

First, create a Mediatranscribe account or sign in. Next, navigate to the Dashboard and "Create new secret key", optionally naming the key. Make sure to save this somewhere safe and do not share it with anyone.

Get your API Keys

Your API requests are authenticated using API secret keys. Any request that doesn't include an API secret key will return an error.

You can generate an API key from your Dashboard at any time.

https://www.mediatranscribe.com/dashboard/settings?tab=api-keys

Make Your First Request

This is where your journey with MediaTranscribe begins. In this section, we'll guide you through making your first request using our platform. Whether you want to transcribe an audio file, generate subtitles for a video, or dive into any of our other transformative services, you're just a few clicks away from experiencing the power of MediaTranscribe. Let's get started with our tags endpoint.

Base API URL

http://api.mediatranscribe.com/api/v1

QuickStart Language Selection

Checkout how to use the various languages when starting out with Mediatranscribe.

Set up your preferred Language

To use the mediatranscribe API you need to install a supported programming language. Programming languages currently supported are Curl, Python, Javascript and Java. Some computers come pre-installed with some of the programming languages. You can open your Command Line or Terminal to check whether a specific language is installed. If not visit their homepages to get a step by step guide on the installation process. Click on the links to be redirected.

Curl

Curl is a popular command line tool used by developers to send HTTP requests to API's. It requires minimal set up time but is less capable than a fully featured programming language like Python or JavaScript.

Make an API Request

curl --location --request POST '/transcribes/media/' --header 'Authorization: Bearer <YOUR_API_KEY>' --header 'Content-Type: application/json' --data-raw '{"services":'transcription',"language":"en","media_url":"https://example.com/audio.mp3"}'

Python

Python is a popular programming language that is commonly used for data applications, web development, and many other programming tasks due to its ease of use.

Make an API request

import requests

url = '/transcribes/media/'
headers = {
  'Authorization': 'Bearer <YOUR_API_KEY>',
  'Content-Type': 'application/json'
}
payload = {
  'services': 'transcription',
  'language': 'en',
  'media_url': 'https://example.com/audio.mp3'
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Java

Java is a widely-used programming language known for its versatility and robustness. Java's strength lies in its platform independence, allowing developers to write code once and run it anywhere

Make an API request

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
  public static void main(String[] args) throws Exception {
    String body = "{\"services\":\"transcription\",\"language\":\"en\",\"media_url\":\"https://example.com/audio.mp3\"}";
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("/transcribes/media/"))
      .header("Authorization", "Bearer <YOUR_API_KEY>")
      .header("Content-Type", "application/json")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

Javascript

JavaScript, is a versatile programming language primarily used for building interactive websites and web applications.

Make an API request

const res = await fetch('/transcribes/media/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <YOUR_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    services: 'transcription',
    language: 'en',
    media_url: 'https://example.com/audio.mp3'
  })
});

const data = await res.json();
console.log(data);

Axios

Axios is a popular JavaScript library used for making HTTP requests from web browsers and Node.js environments. It provides a simple and intuitive API for performing asynchronous operations, such as fetching data from a server or submitting form data.

Make an API request

const axios = require('axios');

const url = '/transcribes/media/';
const headers = {
  'Authorization': 'Bearer <YOUR_API_KEY>',
  'Content-Type': 'application/json'
};
const data = {
  title: 'Kubernetes the Best Way',
};

axios.post(url, data, { headers })
  .then(response => {
    // Handle the response here
    console.log(response.data);
  })
  .catch(error => {
    // Handle any errors here
    console.error(error);
  });

---

Next Steps

After making the first request with MediaTranscribe, here are a few other things to explore

• Review the initial response for accuracy and completeness.

• Explore additional endpoints for different conversion tasks like summarization and subtitle generation.

• Experiment with different parameters and options to customize the output according to your needs.

• Integrate error handling to gracefully manage any unexpected issues.

• Scale up your usage by optimizing API requests for efficiency and performance.