MEDIA
Transcribe Audio or Video API
Transcribe speech from an audio or video URL, with time-coded segments and automatic language detection. Short clips come back in the same call; longer ones return a jobId to poll with audio-transcribe-result. GPU Whisper, up to two hours per file.
How to call it
Send one POST to api.upapi.io/audio-transcribe.post with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 10 weighted units of your monthly quota. The operation times out after 25 seconds. Identical requests are served from cache for 43200 seconds, unbilled.
POST https://api.upapi.io/audio-transcribe.post
Transcribe Audio or Video API reference
Request parameters
- url
- stringrequired — Public URL of the audio or video to transcribe (e.g. https://example.com/interview.mp3). Up to 2 hours long.
- language
- string — Spoken-language hint as an ISO code (e.g. en). Omit to auto-detect.
Response fields
- text
- string — Full transcript; null until completed
- jobId
- stringrequired — Pass this to audio-transcribe-result.get to poll
- status
- stringrequired — completed once the transcript is ready; processing while it is still running
- language
- string — Detected (or forced) language code; null until completed
- progress
- integer — Progress percentage, 0-100
- segments
- array — Time-coded segments; null until completed
- durationSec
- number — Audio duration in seconds; null until completed
- pollAfterSec
- integer — Seconds to wait before polling again; null once completed
Example request and response
The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.
{
"url": "https://example.com/interview.mp3"
}{
"text": "Hello, world",
"jobId": "example",
"status": "example",
"language": "en",
"progress": 0,
"segments": [
{
"end": 1,
"text": "Hello, world",
"start": 1
}
],
"durationSec": 1,
"pollAfterSec": 1
}Code snippets
cURL
curl -X POST https://api.upapi.io/audio-transcribe.post \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{ "url": "https://example.com/interview.mp3" }'JavaScript
const response = await fetch('https://api.upapi.io/audio-transcribe.post', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY',
},
body: JSON.stringify({
"url": "https://example.com/interview.mp3"
}),
});
const data = await response.json();
console.log(data);Python
import requests
response = requests.post(
'https://api.upapi.io/audio-transcribe.post',
headers={
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY',
},
json={
"url": "https://example.com/interview.mp3"
},
)
print(response.json())Go
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{ "url": "https://example.com/interview.mp3" }`)
req, _ := http.NewRequest("POST", "https://api.upapi.io/audio-transcribe.post", bytes.NewBuffer(payload))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
var result map[string]any
json.Unmarshal(body, &result)
fmt.Println(result)
}PHP
<?php
$payload = json_encode([
'url' => 'https://example.com/interview.mp3',
]);
$ch = curl_init('https://api.upapi.io/audio-transcribe.post');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'x-api-key: YOUR_API_KEY',
],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
var_dump($data);Ruby
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.upapi.io/audio-transcribe.post')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "url": "https://example.com/interview.mp3" }.to_json
response = http.request(request)
puts JSON.parse(response.body)Java
import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;
OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();
String json = "{ \"url\": \"https://example.com/interview.mp3\" }";
RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
.url("https://api.upapi.io/audio-transcribe.post")
.post(body)
.addHeader("Content-Type", "application/json")
.addHeader("x-api-key", "YOUR_API_KEY")
.build();
try (Response response = client.newCall(request).execute()) {
Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
System.out.println(result);
}C#
using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var payload = JsonSerializer.Deserialize<object>("{ \"url\": \"https://example.com/interview.mp3\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/audio-transcribe.post", payload);
var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);Frequently asked questions
How much does the Transcribe Audio or Video API cost per call?
Each call spends 10 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.
How do I authenticate to the Transcribe Audio or Video API?
Send your key in the X-Api-Key header. A free guest key is available without creating an account.
Are Transcribe Audio or Video API responses cached?
Yes — identical requests are served from cache for 43200 seconds, and a cache hit is not billed.