Free API Documentation

🎤 Finding Voice IDs

We provide two public JSON datasets, generated during our build process and updated regularly:

Characters Dataset Structure

// dataset_search.json - Characters
[
  {
    "id": 234322812,
    "name": "Jungkook",
    "username": "jungkook",
    "image_url": "https://static.cvoice.ai/profiles/jungkook.jpg",
    "avatar": true,
    "occupations": ["Pop Singer"],
    "country": "South Korea",
    "birth_year": 1997,
    "voice_count": 89,
    "fame_score": 5
  }
  // ... +20,000 more characters
]

Voices Dataset Structure

// dataset_voices.json - Voice IDs by character
{
  "jungkook": [
    {
      "voice_id": "00a77add-48d0-4088-b16b-695e5bd0fb73",
      "name": "Jungkook Official",
      "curated": true,
      "preview_url": "https://static.cvoice.ai/voices/00a77add.mp3"
    },
    {
      "voice_id": "uuid-456",
      "name": "Jungkook Voice 2",
      "curated": false,
      "preview_url": "https://static.cvoice.ai/voices/uuid-456.mp3"
    }
    // ... 87 more voices
  ],
  "barack-obama": [
    {
      "voice_id": "uuid-789",
      "name": "Obama Official",
      "curated": true,
      "preview_url": "https://static.cvoice.ai/voices/uuid-789.mp3"
    }
  ]
  // ... 20,000+ more characters
}

Example: Finding and Using Voices

// Step 1: Find a character
const characters = await fetch('https://cvoice.ai/dataset_search.json')
  .then(r => r.json());

const obama = characters.find(c =>
  c.name.toLowerCase().includes('obama')
);

console.log('Character:', obama.name);
console.log('Username:', obama.username); // "barack-obama"
console.log('Available voices:', obama.voice_count);

// Step 2: Get voices for this character
const voicesMap = await fetch('https://cvoice.ai/dataset_voices.json')
  .then(r => r.json());

const voices = voicesMap[obama.username];
console.log('First voice ID:', voices[0].voice_id);
console.log('Is curated:', voices[0].curated);

// Step 3: Generate audio with the voice
const ttsResponse = await fetch('https://cvoice.ai/api/tts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'cvai_your_api_key_here'
  },
  body: JSON.stringify({
    voice_id: voices[0].voice_id,
    text: 'Yes we can! This is a test of AI voice generation.'
  })
});

const { url } = await ttsResponse.json();
console.log('Audio URL:', url);

🔐 Authentication

Include your API key in the request header:

X-API-Key: cvai_your_api_key_here

🎯 Text-to-Speech Endpoint

Request Body

Response

{
  "url": "https://static.cvoice.ai/tts/voice_id/hash.mp3"
}

📝 Code Examples

curl -X POST https://cvoice.ai/api/tts \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cvai_your_api_key_here" \
  -d '{
    "voice_id": "00a77add-48d0-4088-b16b-695e5bd0fb73",
    "text": "Hello! This is a sample text for AI voice generation using cvoice.ai API."
  }'

const response = await fetch('https://cvoice.ai/api/tts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'cvai_your_api_key_here'
  },
  body: JSON.stringify({
    voice_id: '00a77add-48d0-4088-b16b-695e5bd0fb73',
    text: 'Hello! This is a sample text for AI voice generation.'
  })
});

const data = await response.json();
console.log('Audio URL:', data.url);

import requests

response = requests.post(
    'https://cvoice.ai/api/tts',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'cvai_your_api_key_here'
    },
    json={
        'voice_id': '00a77add-48d0-4088-b16b-695e5bd0fb73',
        'text': 'Hello! This is a sample text for AI voice generation.'
    }
)

data = response.json()
print('Audio URL:', data['url'])

<?php
$ch = curl_init('https://cvoice.ai/api/tts');

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-API-Key: cvai_your_api_key_here'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'voice_id' => '00a77add-48d0-4088-b16b-695e5bd0fb73',
    'text' => 'Hello! This is a sample text for AI voice generation.'
]));

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo 'Audio URL: ' . $data['url'];

⚡ Rate Limits

Need higher limits? Contact us — we're happy to help, still free of charge.

⚠️ Error Codes

✨ Best Practices