← TAYAPROVOICES
TV CAPTURE

Developer API

Everything TayaproVoices does — speech, your clone portfolio, your music catalogue and your sales — is callable from any app, script or broadcast system with a single API key.

1. BASE URL

…

This page always shows the address of the site you are reading it on, so the examples below work as soon as they are pasted.

2. GET A KEY

Open your Workspace, scroll to DEVELOPER API KEYS and press CREATE KEY. The key is shown once — copy it straight away. Send it on every call as x-api-key: tv_live_… (a Bearer header works too). Revoke keys any time in the Workspace.

3. FIRST CALL

curl "$BASE/api/public/v1/usage" \
  -H "x-api-key: tv_live_YOUR_KEY"

If it answers with your usage summary, the key works.

ENDPOINTS

POST/api/public/v1/speech→ MP3 audio

Turn text into spoken audio in any of the studio voices.

curl -X POST "https://your-site/api/public/v1/speech" \
  -H "x-api-key: tv_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Good evening, welcome to the nine o'clock bulletin.","voice":"alloy","speed":1}' \
  --output speech.mp3
GET/api/public/v1/voices→ JSON list

List your clone portfolio voices with status and match score.

curl "https://your-site/api/public/v1/voices" \
  -H "x-api-key: tv_live_YOUR_KEY"
GET/api/public/v1/tracks→ JSON list

List your music tracks with mood, key, tempo and marketplace price.

curl "https://your-site/api/public/v1/tracks" \
  -H "x-api-key: tv_live_YOUR_KEY"
GET/api/public/v1/sales→ JSON list + totals

Every voice and track you have sold, with amounts, the platform fee and payout state. Buyer identities are masked.

curl "https://your-site/api/public/v1/sales" \
  -H "x-api-key: tv_live_YOUR_KEY"
GET/api/public/v1/usage→ JSON summary

Your character usage across the app and this API, broken down by feature.

curl "https://your-site/api/public/v1/usage" \
  -H "x-api-key: tv_live_YOUR_KEY"
GET/api/public/v1/music→ JSON list of styles and keys

Every music style you can compose in — pop, news beds and world music from flamenco to raga, gamelan and amapiano.

curl "https://your-site/api/public/v1/music" \
  -H "x-api-key: tv_live_YOUR_KEY"
POST/api/public/v1/music→ audio/wav

Compose an original track (up to 60 s). Same seed = same track. Fields: style, key, tempo, bars, intensity (0–1), seed.

curl -X POST "https://your-site/api/public/v1/music" \
  -H "x-api-key: tv_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"style":"flamenco","key":"E","bars":8,"intensity":0.7}' \
  --output track.wav

RULES