Quickstart

export REVOLAB_API_KEY="rvl_live_..."

# Set in your shell before running your script:
# export REVOLAB_API_KEY="rvl_live_..."
 
import os
api_key = os.environ["REVOLAB_API_KEY"]

// Set in your shell or .env file:
// REVOLAB_API_KEY=rvl_live_...
 
const apiKey = process.env.REVOLAB_API_KEY;

curl -X POST https://api.revolab.ai/v1/tts \
  -H "Authorization: Bearer $REVOLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nada-1.0-flash",
    "text": "Hello, world! This is my first Revolab TTS call.",
    "voice_id": "<your-voice-id>",
    "language": "en"
  }' \
  -o speech.wav

import os
import requests
 
api_key = os.environ["REVOLAB_API_KEY"]
 
response = requests.post(
    "https://api.revolab.ai/v1/tts",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "nada-1.0-flash",
        "text": "Hello, world! This is my first Revolab TTS call.",
        "voice_id": "<your-voice-id>",
        "language": "en",
    },
)
response.raise_for_status()
 
with open("speech.wav", "wb") as f:
    f.write(response.content)
print("Duration:", response.headers["x-duration-s"], "s")
print("Latency:", response.headers["x-latency-ms"], "ms")

const apiKey = process.env.REVOLAB_API_KEY;
 
const response = await fetch("https://api.revolab.ai/v1/tts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "nada-1.0-flash",
    text: "Hello, world! This is my first Revolab TTS call.",
    voice_id: "<your-voice-id>",
    language: "en",
  }),
});
 
if (!response.ok) {
  const err = await response.json();
  throw new Error(err.error.message);
}
 
require("fs").writeFileSync("speech.wav", Buffer.from(await response.arrayBuffer()));
console.log("Duration:", response.headers.get("x-duration-s"), "s");
console.log("Latency:", response.headers.get("x-latency-ms"), "ms");

# Transcribe a local audio file
curl -X POST https://api.revolab.ai/v1/stt \
  -H "Authorization: Bearer $REVOLAB_API_KEY" \
  -F "file=@/path/to/audio.wav" \
  -F "model=aisyah-1.0-flash" \
  -F "language=en" | python3 -c "
import sys, json
data = json.load(sys.stdin)
print('Transcript:', data['text'])
print('Language:', data['language'])
print('Duration:', data['duration_s'], 's')
"

import os
import requests
 
api_key = os.environ["REVOLAB_API_KEY"]
 
with open("/path/to/audio.wav", "rb") as f:
    response = requests.post(
        "https://api.revolab.ai/v1/stt",
        headers={"Authorization": f"Bearer {api_key}"},
        files={"file": ("audio.wav", f, "audio/wav")},
        data={"model": "aisyah-1.0-flash", "language": "en"},
    )
 
response.raise_for_status()
data = response.json()
 
print("Transcript:", data["text"])
print("Language:", data["language"])
print("Duration:", data["duration_s"], "s")

import { readFileSync } from "fs";
 
const apiKey = process.env.REVOLAB_API_KEY;
const audioBuffer = readFileSync("/path/to/audio.wav");
 
const form = new FormData();
form.append("file", new Blob([audioBuffer], { type: "audio/wav" }), "audio.wav");
form.append("model", "aisyah-1.0-flash");
form.append("language", "en");
 
const response = await fetch("https://api.revolab.ai/v1/stt", {
  method: "POST",
  headers: { Authorization: `Bearer ${apiKey}` },
  body: form,
});
 
if (!response.ok) {
  const err = await response.json();
  throw new Error(err.error.message);
}
 
const data = await response.json();
console.log("Transcript:", data.text);
console.log("Language:", data.language);
console.log("Duration:", data.duration_s, "s");