Voices

curl -G https://api.albastov.com/v1/media/voices \
  -H "Authorization: Bearer $ALBASTAR_API_KEY" \
  -d model=kokoro -d language=en-gb -d limit=5

import json
import os
import urllib.parse
import urllib.request

query = urllib.parse.urlencode(
    {"model": "kokoro", "language": "en-gb", "limit": 5}
)
req = urllib.request.Request(
    f"https://api.albastov.com/v1/media/voices?{query}",
    headers={
        "User-Agent": "my-app/1.0",
        "Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}",
    },
)
with urllib.request.urlopen(req, timeout=30) as res:
    for v in json.load(res)["data"]:
        print(v["id"], v["gender"])

const query = new URLSearchParams({
  model: "kokoro",
  language: "en-gb",
  limit: "5",
});
const res = await fetch(`https://api.albastov.com/v1/media/voices?${query}`, {
  headers: { Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
for (const v of (await res.json()).data) console.log(v.id, v.gender);

curl -o reference.mp3 \
  https://api.albastov.com/v1/media/samples/reference-848c3d555461736a.mp3

curl https://api.albastov.com/v1/media/voices \
  -H "Authorization: Bearer $ALBASTAR_API_KEY" \
  -F [email protected] \
  -F name="Narrator A" \
  -F language=en \
  -F 'labels={"use": "narration"}' \
  -F consent="Synthetic voice made with the Kokoro voice af_heart. No speaker."

import json
import os

import httpx

BASE = "https://api.albastov.com/v1"
AUTH = {"Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}"}

clip = httpx.get(f"{BASE}/media/samples/reference-848c3d555461736a.mp3")
clip.raise_for_status()
res = httpx.post(
    f"{BASE}/media/voices",
    headers=AUTH,
    files={"file": ("reference.mp3", clip.content, "audio/mpeg")},
    data={
        "name": "Narrator A",
        "language": "en",
        "labels": json.dumps({"use": "narration"}),
        "consent": "Synthetic voice made with the Kokoro voice af_heart. "
        "No speaker.",
    },
    timeout=60,
)
res.raise_for_status()
print(res.json()["id"])

const base = "https://api.albastov.com/v1";

const clip = await fetch(
  `${base}/media/samples/reference-848c3d555461736a.mp3`,
);
if (!clip.ok) throw new Error(`${clip.status} ${await clip.text()}`);

const form = new FormData();
form.append("file", await clip.blob(), "reference.mp3");
form.append("name", "Narrator A");
form.append("language", "en");
form.append("labels", JSON.stringify({ use: "narration" }));
form.append(
  "consent",
  "Synthetic voice made with the Kokoro voice af_heart. No speaker.",
);
const res = await fetch(`${base}/media/voices`, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}` },
  body: form,
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log((await res.json()).id);

curl https://api.albastov.com/v1/media/voices/design \
  -H "Authorization: Bearer $ALBASTAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Night radio",
       "description": "male, middle-aged, low pitch, slow and warm"}'

import json
import os
import urllib.request

body = {
    "name": "Night radio",
    "description": "male, middle-aged, low pitch, slow and warm",
}
req = urllib.request.Request(
    "https://api.albastov.com/v1/media/voices/design",
    data=json.dumps(body).encode(),
    headers={
        "User-Agent": "my-app/1.0",
        "Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}",
        "Content-Type": "application/json",
    },
)
with urllib.request.urlopen(req, timeout=60) as res:
    voice = json.load(res)
print(voice["id"], voice["status"])

const res = await fetch("https://api.albastov.com/v1/media/voices/design", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Night radio",
    description: "male, middle-aged, low pitch, slow and warm",
  }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const voice = await res.json();
console.log(voice.id, voice.status);

curl https://api.albastov.com/v1/media/voices/vo_tBeDCRb2byGFjB6HGyQq6a \
  -H "Authorization: Bearer $ALBASTAR_API_KEY"

import json
import os
import urllib.request

req = urllib.request.Request(
    "https://api.albastov.com/v1/media/voices/vo_tBeDCRb2byGFjB6HGyQq6a",
    headers={
        "User-Agent": "my-app/1.0",
        "Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}",
    },
)
with urllib.request.urlopen(req, timeout=30) as res:
    voice = json.load(res)
print(voice["name"], voice["status"], voice["default_model"])

const res = await fetch(
  "https://api.albastov.com/v1/media/voices/vo_tBeDCRb2byGFjB6HGyQq6a",
  { headers: { Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}` } },
);
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const voice = await res.json();
console.log(voice.name, voice.status, voice.default_model);

curl -X PATCH \
  https://api.albastov.com/v1/media/voices/vo_FLUWnoRjtFXyrBE8uWoTxL \
  -H "Authorization: Bearer $ALBASTAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "Calm narrator for chapter readings",
       "labels": {"book": "harbour"}}'

import json
import os
import urllib.request

body = {
    "description": "Calm narrator for chapter readings",
    "labels": {"book": "harbour"},
}
req = urllib.request.Request(
    "https://api.albastov.com/v1/media/voices/vo_FLUWnoRjtFXyrBE8uWoTxL",
    method="PATCH",
    data=json.dumps(body).encode(),
    headers={
        "User-Agent": "my-app/1.0",
        "Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}",
        "Content-Type": "application/json",
    },
)
with urllib.request.urlopen(req, timeout=30) as res:
    print(json.load(res)["labels"])

const res = await fetch(
  "https://api.albastov.com/v1/media/voices/vo_FLUWnoRjtFXyrBE8uWoTxL",
  {
    method: "PATCH",
    headers: {
      Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      description: "Calm narrator for chapter readings",
      labels: { book: "harbour" },
    }),
  },
);
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log((await res.json()).labels);

curl -X DELETE \
  https://api.albastov.com/v1/media/voices/vo_FLUWnoRjtFXyrBE8uWoTxL \
  -H "Authorization: Bearer $ALBASTAR_API_KEY"

import os
import urllib.request

req = urllib.request.Request(
    "https://api.albastov.com/v1/media/voices/vo_FLUWnoRjtFXyrBE8uWoTxL",
    method="DELETE",
    headers={
        "User-Agent": "my-app/1.0",
        "Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}",
    },
)
with urllib.request.urlopen(req, timeout=30) as res:
    print(res.status)

const res = await fetch(
  "https://api.albastov.com/v1/media/voices/vo_FLUWnoRjtFXyrBE8uWoTxL",
  {
    method: "DELETE",
    headers: { Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}` },
  },
);
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log(res.status);

curl \
  https://api.albastov.com/v1/media/voices/vo_tBeDCRb2byGFjB6HGyQq6a/audio \
  -H "Authorization: Bearer $ALBASTAR_API_KEY" \
  --output voice.mp3

import os
import urllib.request

req = urllib.request.Request(
    "https://api.albastov.com/v1/media/voices/"
    "vo_tBeDCRb2byGFjB6HGyQq6a/audio",
    headers={
        "User-Agent": "my-app/1.0",
        "Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}",
    },
)
with urllib.request.urlopen(req, timeout=30) as res:
    with open("voice.mp3", "wb") as f:
        f.write(res.read())

import { writeFile } from "node:fs/promises";

const res = await fetch(
  "https://api.albastov.com/v1/media/voices/vo_tBeDCRb2byGFjB6HGyQq6a/audio",
  { headers: { Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}` } },
);
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
await writeFile("voice.mp3", Buffer.from(await res.arrayBuffer()));

curl \
  https://api.albastov.com/v1/media/voices/vo_tBeDCRb2byGFjB6HGyQq6a/preview \
  -H "Authorization: Bearer $ALBASTAR_API_KEY" \
  --output preview.mp3

import os
import urllib.request

req = urllib.request.Request(
    "https://api.albastov.com/v1/media/voices/"
    "vo_tBeDCRb2byGFjB6HGyQq6a/preview",
    headers={
        "User-Agent": "my-app/1.0",
        "Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}",
    },
)
with urllib.request.urlopen(req, timeout=30) as res:
    with open("preview.mp3", "wb") as f:
        f.write(res.read())

import { writeFile } from "node:fs/promises";

const base = "https://api.albastov.com/v1/media/voices";
const res = await fetch(`${base}/vo_tBeDCRb2byGFjB6HGyQq6a/preview`, {
  headers: { Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
await writeFile("preview.mp3", Buffer.from(await res.arrayBuffer()));

curl -X POST \
  https://api.albastov.com/v1/media/voices/vo_tBeDCRb2byGFjB6HGyQq6a/copy \
  -H "Authorization: Bearer $ALBASTAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My narrator"}'

import json
import os
import urllib.request

req = urllib.request.Request(
    "https://api.albastov.com/v1/media/voices/"
    "vo_tBeDCRb2byGFjB6HGyQq6a/copy",
    data=json.dumps({"name": "My narrator"}).encode(),
    headers={
        "User-Agent": "my-app/1.0",
        "Authorization": f"Bearer {os.environ['ALBASTAR_API_KEY']}",
        "Content-Type": "application/json",
    },
)
with urllib.request.urlopen(req, timeout=30) as res:
    print(json.load(res)["id"])

const base = "https://api.albastov.com/v1/media/voices";
const res = await fetch(`${base}/vo_tBeDCRb2byGFjB6HGyQq6a/copy`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ALBASTAR_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "My narrator" }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log((await res.json()).id);