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" \
  --no-buffer \
  -d '{
    "model": "nada-1.0-pro",
    "text": "Hello, world! This is my first Revolab TTS call.",
    "voice_id": "<your-voice-id>",
    "language": "en",
    "stream": true,
    "output_format": "mp3"
  }' \
  -o speech.mp3

import os
import requests
 
api_key = os.environ["REVOLAB_API_KEY"]
 
with requests.post(
    "https://api.revolab.ai/v1/tts",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "nada-1.0-pro",
        "text": "Hello, world! This is my first Revolab TTS call.",
        "voice_id": "<your-voice-id>",
        "language": "en",
        "stream": True,
        "output_format": "mp3",
    },
    stream=True,
) as response:
    response.raise_for_status()
    with open("speech.mp3", "wb") as f:
        for chunk in response.iter_content(chunk_size=4096):
            # Hand this straight to a player instead of a file and playback
            # starts here, before synthesis has finished.
            f.write(chunk)

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-pro",
    text: "Hello, world! This is my first Revolab TTS call.",
    voice_id: "<your-voice-id>",
    language: "en",
    stream: true,
    output_format: "mp3",
  }),
});
 
if (!response.ok) {
  const err = await response.json();
  throw new Error(err.error.message);
}
 
// Consume the stream. Pipe it to a player instead of a file and playback
// starts on the first chunk, before synthesis has finished.
const out = require("fs").createWriteStream("speech.mp3");
for await (const chunk of response.body) {
  out.write(chunk);
}
out.end();

# 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-pro" \
  -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-pro", "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-pro");
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");