TypeScript SDK

npm install @vovix/voixa

import { Voixa } from '@vovix/voixa'

const vx = new Voixa({
  apiKey: process.env.VOIXA_API_KEY!, // Studio → API keys
  // baseUrl: 'https://api.voixa.vovix.io/v1',  (default)
  // timeoutMs: 30_000,                         (per HTTP request)
})

// Built-in voices and your clones
const { voices } = await vx.voices({ language: 'vi' })

// Text → clip. say() waits until the audio is ready; speak() returns at once.
const clip = await vx.say({ voiceId: 'vi-truc-ly', text: 'Xin chào.', project: 'episode-12' })
clip.url   // signed WAV URL, valid for one hour

// Long text → one audio file
const episode = await vx.makePodcast({ voiceId: 'vi-truc-ly', title: 'Episode 12', text: script })

// Your library, grouped by project
const { items } = await vx.listClips({ project: 'episode-12', source: 'api' })
const { shareUrl } = await vx.shareClip(clip.clipId)

// Clone a voice from 3–10 s of clean speech
const me = await vx.createVoice({ name: 'Me', language: 'vi', audio: wavBytes })
await vx.say({ voiceId: me.voiceId, text: 'Giờ là giọng của tôi.' })

// Speech to text with timestamps
const t = await vx.transcribeFile({ audio: await fs.readFile('interview.mp3'), fileName: 'interview.mp3' })
t.text, t.segments, t.srtUrl

import { VoixaError } from '@vovix/voixa'

try {
  await vx.say({ voiceId: 'vi-truc-ly', text })
} catch (e) {
  if (e instanceof VoixaError && e.code === 'QUOTA') console.log('Allowance resets at', e.resetsAt)
  else throw e
}