Documentation

Transcription API

Transcribe audio from media files into text with timestamps.

Endpoint

POST /v1/transcribe

Authentication

API Key (Bearer token)

Request Body

ParameterTypeRequiredDescription
mediaUrlstringYesURL of the media file to transcribe. Supports HTTP/HTTPS URLs (max 3500 MB) or URLs from upload mechanism. See Media URLs for details.
sourceLanguagestringYesSource language code. See Supported Languages for available options.

Response

json
{
  "jobId": "job_abc123",
  "status": "pending",
  "message": "Transcription job started successfully"
}

Code Examples

cURL

bash
curl -X POST https://api.rednerapp.com/v1/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mediaUrl": "https://example.com/video.mp4",
    "sourceLanguage": "en-US"
  }'

Python

python
import requests

url = "https://api.rednerapp.com/v1/transcribe"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "mediaUrl": "https://example.com/video.mp4",
    "sourceLanguage": "en-US"    
}

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

JavaScript

javascript
const response = await fetch('https://api.rednerapp.com/v1/transcribe', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    mediaUrl: 'https://example.com/video.mp4',
    sourceLanguage: 'en-US'    
  })
});

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

Java

java
HttpClient client = HttpClient.newHttpClient();

String json = "{\"mediaUrl\":\"https://example.com/video.mp4\"," +
              "\"sourceLanguage\":\"en\"}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rednerapp.com/v1/transcribe"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();

HttpResponse<String> response = client.send(
    request,
    HttpResponse.BodyHandlers.ofString()
);

System.out.println(response.body());

Pricing

$0.009 per minute of audio