Quickstart

import WebSocket from "ws";
const ws = new WebSocket(
  "wss://api.pyai.com/v1/omni?format=pcm16&rate=24000",
  [`pyai-key.${process.env.PYAI_API_KEY}`],
);
ws.on("open", () => {
  ws.send(JSON.stringify({
    type: "configure",
    voice_id: "stock_dorit_en_us",          // or your cloned / designed voice
    persona: "You are a friendly receptionist.",
    kb_endpoint: "https://your-app.example.com/kb", // grounding (optional)
    tools: [                                // function calling (optional)
      { name: "book_appointment", description: "Book a slot",
        parameters: { type: "object", properties: { time: { type: "string" } } } },
    ],
  }));
});
ws.on("message", (d) => console.log(d.toString())); // hello + session_started

import os, json, asyncio, websockets

async def main():
    url = "wss://api.pyai.com/v1/omni?format=pcm16&rate=24000"
    sub = f"pyai-key.{os.environ['PYAI_API_KEY']}"
    async with websockets.connect(url, subprotocols=[sub]) as ws:
        await ws.send(json.dumps({
            "type": "configure",
            "voice_id": "stock_dorit_en_us",
            "persona": "You are a friendly receptionist.",
        }))
        async for frame in ws:
            print(frame)

asyncio.run(main())

curl https://api.pyai.com/v1/audio/speech \
  -H "Authorization: Bearer $PYAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"pyai-voice","input":"Hello from PyAI.","voice":"stock_dorit_en_us"}' \
  --output hello.wav

import os
from pyai import PyAI  # pip install pyai-sdk

pyai = PyAI(api_key=os.environ["PYAI_API_KEY"])
audio = pyai.audio.speech(input="Hello from PyAI.", voice="stock_dorit_en_us")
open("hello.wav", "wb").write(audio)

import PyAI from "@pyai/sdk"; // npm install @pyai/sdk

const pyai = new PyAI({ apiKey: process.env.PYAI_API_KEY! });
const audio = await pyai.audio.speech({ input: "Hello from PyAI.", voice: "stock_dorit_en_us" });
// write `audio` (ArrayBuffer) to hello.wav