API ஆவணமாக்கம்

உரையிலிருந்து பேசுName

ஒலியை உரைக்கு மாற்றவும். தானியங்கி கண்டுபிடிப்புடன் 99 மொழிகளுக்கு ஆதரவு.

கோரிக்கை உடல் (multipart/form-data)

பதில்

{
  "text": "Hello, this is a transcription test.",
  "language": "en",
  "duration": 3.5,
  "segments": [
    {
      "start": 0.0,
      "end": 1.8,
      "text": "Hello, this is",
      "speaker": "SPEAKER_00"
    },
    {
      "start": 1.8,
      "end": 3.5,
      "text": "a transcription test.",
      "speaker": "SPEAKER_00"
    }
  ]
}

குரல் படிமம்Name

உரையாடலை ஒரு மாதிரி குரலில் உருவாக்கவும். ஒரு குறிப்பு ஒலி மற்றும் உரை ஏற்றவும்.

கோரிக்கை உடல் (multipart/form-data)

பதில்

ஒலி கோப்பினை இரும தரவாக திருப்பித்தரும், TTS முடிவு புள்ளிக்கு சமமானது.

குரல் மாற்றிName

ஒலியை வேறு குரல் போல ஒலிக்க மாற்றவும். மூல ஒலியை ஏற்றவும் மற்றும் இலக்கு குரலை தேர்ந்தெடுக்கவும்.

கோரிக்கை உடல் (multipart/form-data)

உதாரண கோரிக்கை

curl -X POST https://api.tts.ai/v1/voice-convert/ \
  -H "Authorization: Bearer sk-tts-your-key" \
  -F "file=@source_audio.mp3" \
  -F "target_voice=af_bella" \
  -F "model=openvoice" \
  -o converted.wav

பதில்

மாற்றப்பட்ட ஒலி கோப்பினை இரும தரவாக திருப்பித் தரும்.

உரையாடல் மொழிபெயர்ப்பு

ஒரு மொழியிலிருந்து மற்றொரு மொழிக்கு பேசப்பட்ட ஒலியை மொழிபெயர்க்கவும். ஒரே அழைப்பில் உரைக்கு உரையாடல், மொழிபெயர்ப்பு மற்றும் உரைக்கு உரையாடல் ஆகியவற்றை இணைக்கிறது.

கோரிக்கை உடல் (multipart/form-data)

பதில்

{
  "original_text": "Hello, how are you?",
  "translated_text": "Hola, como estas?",
  "source_language": "en",
  "target_language": "es",
  "audio_url": "https://api.tts.ai/v1/results/translate_abc123.mp3",
  "credits_used": 5
}

உரையிலிருந்து உரைக்குName

உரையாடல் பாணியை மாற்று, உணர்வு, அல்லது உள்ளடக்கத்தை வைத்திருக்கும்போது வழங்குதல். குரல், வேகம் மற்றும் வெளிப்பாட்டை சரிசெய்ய பயன்படுகிறது.

கோரிக்கை உடல் (multipart/form-data)

பதில்

மாற்றப்பட்ட ஒலி கோப்பினை இரும தரவாக திருப்பித்தரும்.

ஒலி கருவிகள்Name

மேம்படுத்தல், குரல் நீக்குதல், ஸ்டெம் பிரித்தல் மற்றும் பலவற்றிற்கு ஒலி செயலாக்க முடிவு புள்ளிகள்.

{
  "key": "C",
  "scale": "Major",
  "bpm": 120.0,
  "time_signature": "4/4",
  "camelot": "8B",
  "compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}

குரல் உரையாடல்Name

ஒலி அல்லது உரை அனுப்பவும் மற்றும் ஒரு AI பதிலை செயற்படுத்தப்பட்ட பேச்சுடன் பெறவும்.

கோரிக்கை உடல் (multipart/form-data அல்லது JSON)

பதில்

{
  "conversation_id": "conv_abc123",
  "user_text": "What is the capital of France?",
  "ai_text": "The capital of France is Paris.",
  "audio_url": "https://api.tts.ai/v1/audio/tmp/resp_xyz.mp3",
  "credits_used": 3
}

தொகுப்பு TTS

இணையான TTS உருவாக்கத்திற்காக பல உரைகளை சமர்பிக்கவும். அனைத்து பணிகளும் முடிந்த பிறகு வலைகூக்கு திரும்ப அழைப்பினை பெறவும்.

அளபுருக்கள்

பதில்

{
  "batch_id": "abc123",
  "total": 3,
  "completed": 0,
  "status": "processing"
}

GET /v1/tts/batch/result/?batch_id=abc123 உடன் வாக்களிப்பு முன்னேற்றம்

குரல் உட்பொதித்தல்

குறிப்பு ஒலியிலிருந்து ஒரு குரல் உட்பொதிவை முன் கணக்கிடவும். அடுத்த குரல் ஒத்தமைப்பு கோரிக்கைகளில் திரும்பிய உட்பொதிந்த அடையாளத்தை பயன்படுத்தவும்.

அளபுருக்கள்

பதில்

{
  "embed_id": "emb_abc123",
  "model": "chatterbox",
  "duration_ms": 450
}

உடல்நிலை சரிபார்ப்பு

GPU சேவையக நிலை, ஏற்றப்பட்ட மாதிரிகள், வரிசை அளவு ஆகியவற்றை சரிபார்க்கவும். உரிமம் தேவையில்லை. 30 நொடிகளுக்கு இடைமாற்றம் செய்யப்பட்டது.

பதில்

{
  "status": "online",
  "latency_ms": 45,
  "queue_size": 3,
  "models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}

பட்டியல் மாதிரிகள்

அனைத்து கிடைக்கக்கூடிய மாதிரிகளின் பட்டியலையும் அவற்றின் திறன்களையும் காட்டுகிறது.

பதில்

{
  "models": [
    {
      "id": "kokoro",
      "name": "Kokoro",
      "type": "tts",
      "tier": "standard",
      "languages": ["en", "ja", "ko", "zh", "fr"],
      "supports_cloning": false,
      "supports_streaming": true,
      "credits_per_1k_chars": 2
    },
    {
      "id": "chatterbox",
      "name": "Chatterbox",
      "type": "tts",
      "tier": "premium",
      "languages": ["en"],
      "supports_cloning": true,
      "supports_streaming": true,
      "credits_per_1k_chars": 4
    }
  ]
}

பட்டியல் குரல்கள்

கிடைக்கக்கூடிய அனைத்து குரல்களின் பட்டியலைத் தருகிறது, விருப்பப்படி மாதிரி அல்லது மொழியால் வடிகட்டப்பட்டது.

கேள்வி அளபுருக்கள்

பதில்

{
  "voices": [
    {
      "id": "af_bella",
      "name": "Bella",
      "model": "kokoro",
      "language": "en",
      "gender": "female",
      "preview_url": "https://api.tts.ai/v1/voices/preview/af_bella.mp3"
    }
  ],
  "total": 142
}

உரை புதிய

எந்த முடிந்த TTS பணிக்கும் ஒத்திசைவு செய்யப்பட்ட உரைநடைகளை உருவாக்குகிறது. ஒலிக்கு மேல் Whisper அடுக்கை இயக்குகிறது மற்றும் SRT அல்லது WebVTT ஐ திரும்பத் தரும். முடிவு வட்டில் தற்காலிகமாக சேமிக்கப்படுகிறது எனவே அதே uuid க்கு இரண்டாவது அழைப்பு ஒரு வட்டு படிப்பு.

கேள்வி அளபுருக்கள்

curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt

உச்சரிப்பு அகராதி புதிய

குறிப்பிட்ட வார்த்தைகளை எப்படி உச்சரிப்பது என்று TTS இயந்திரத்திற்கு கூறவும். சேமிக்கப்பட்ட உள்ளீடுகள் நீங்கள் செய்யும் ஒவ்வொரு TTS கோரிக்கைக்கும் தானாகவே பொருந்தும். கணக்கிற்கு 200 உள்ளீடுகள் வரையறை.

கோரிக்கை உடல் (POST)

# Save an entry
curl -X POST https://tts.ai/api/v1/pronunciations/ \
  -H "Authorization: Bearer sk-tts-..." \
  -H "Content-Type: application/json" \
  -d '{"word": "GIF", "replacement": "jiff"}'

# List your entries
curl https://tts.ai/api/v1/pronunciations/ -H "Authorization: Bearer sk-tts-..."

# Delete entry by id
curl -X DELETE "https://tts.ai/api/v1/pronunciations/?id=42" -H "Authorization: Bearer sk-tts-..."

நீங்கள் அவற்றை சேமிக்காமல் ஒவ்வொரு கோரிக்கைக்கும் மேல்நோக்கிச் செல்லலாம் - எந்த /v1/tts/ அழைப்புகளிலும் pronunciations ஐ ஒரு பொருளாகவோ அல்லது ஒரு அட்டவணையாகவோ சேர்க்கலாம் (TTS முடிவுப் புள்ளிப் பரிமாணங்களைப் பாருங்கள்).

கட்டுரை வாசகர் புதிய

எந்த கட்டுரை பக்கத்திலும் ஒரு < code>< script குறியை விட்டுவிட்டு, பார்வையாளர்கள் ஒரு நிலையான வாசிப்பவர் பட்டியைப் பெறுவர், அது க்ளிக் செய்தால் பக்கத்தை விளக்கும். கட்டுரை உடலை தானியங்கியாக கண்டறிகிறது, தனிப்பயன் குரல் / மாதிரி / இடம் / உச்சரிப்பு வண்ணத்தை ஆதரிக்கிறது.

<script src="https://tts.ai/narrator.js"
    data-pk="pk-tts-your-publishable-key"
    data-voice="af_bella"
    data-model="kokoro"
    data-extract="auto"
    data-position="bottom"
    data-color="#e60000"
    data-locale="en"></script>

விருப்பங்கள்

கெட்டோன்கள்:

கேட்க பட்டன் சாளர உரு

<script src="https://tts.ai/widget.js"
    data-voice="af_bella"
    data-model="kokoro"
    data-style="full"
    data-theme="light"></script>

• Python
• JavaScript
• cURL

import requests

API_KEY = "sk-tts-your-key"

# Text to Speech
response = requests.post(
    "https://api.tts.ai/v1/tts/",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "kokoro",
        "text": "Hello from TTS.ai!",
        "voice": "af_bella",
        "format": "mp3"
    }
)

with open("output.mp3", "wb") as f:
    f.write(response.content)

print(f"Credits used: {response.headers.get('X-Credits-Used')}")

# Speech to Text
with open("recording.mp3", "rb") as f:
    response = requests.post(
        "https://api.tts.ai/v1/stt/",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"file": f},
        data={"model": "faster-whisper", "timestamps": "true"}
    )

result = response.json()
print(result["text"])

# Voice Cloning
with open("reference.wav", "rb") as ref:
    response = requests.post(
        "https://api.tts.ai/v1/tts/clone/",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"reference_audio": ref},
        data={
            "text": "This speech uses a cloned voice.",
            "model": "chatterbox"
        }
    )

with open("cloned_output.mp3", "wb") as f:
    f.write(response.content)

const API_KEY = 'sk-tts-your-key';

// Text to Speech
const response = await fetch('https://api.tts.ai/v1/tts/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'kokoro',
    text: 'Hello from TTS.ai!',
    voice: 'af_bella',
    format: 'mp3'
  })
});

const audioBlob = await response.blob();
const audioUrl = URL.createObjectURL(audioBlob);
const audio = new Audio(audioUrl);
audio.play();

// Speech to Text
const formData = new FormData();
formData.append('file', audioFile);
formData.append('model', 'faster-whisper');

const response = await fetch('https://api.tts.ai/v1/stt/', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${API_KEY}` },
  body: formData
});

const result = await response.json();
console.log(result.text);

# Text to Speech
curl -X POST https://api.tts.ai/v1/tts/ \
  -H "Authorization: Bearer sk-tts-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"kokoro","text":"Hello!","voice":"af_bella","format":"mp3"}' \
  -o output.mp3

# Speech to Text
curl -X POST https://api.tts.ai/v1/stt/ \
  -H "Authorization: Bearer sk-tts-your-key" \
  -F "file=@recording.mp3" \
  -F "model=faster-whisper" \
  -F "timestamps=true"

# Voice Cloning
curl -X POST https://api.tts.ai/v1/tts/clone/ \
  -H "Authorization: Bearer sk-tts-your-key" \
  -F "reference_audio=@reference.wav" \
  -F "text=This uses a cloned voice." \
  -F "model=chatterbox" \
  -o cloned.mp3

# Audio Enhancement
curl -X POST https://api.tts.ai/v1/audio/enhance/ \
  -H "Authorization: Bearer sk-tts-your-key" \
  -F "file=@noisy_audio.mp3" \
  -F "denoise=true" \
  -F "enhance_clarity=true" \
  -o enhanced.mp3

பிழை குறியீடுகள்

அனைத்து பிழைகளும் ஒரு JSON பதிலை ஒரு error புலங்கள்

{
  "error": {
    "code": "insufficient_credits",
    "message": "You do not have enough characters for this request.",
    "characters_required": 4000,
    "characters_available": 2000
  }
}

வெப்ஹூக்குகள்

நீண்ட காலம் நடக்கும் பணிகளுக்காக (stem splitting, batch TTS), நீங்கள் ஒரு webhook_url அளவுருவை வழங்கலாம். பணி முடிந்ததும், நாங்கள் உங்கள் URL க்கு முடிவுகளை POST செய்வோம்.

{
  "event": "task.completed",
  "task_id": "task_abc123",
  "status": "success",
  "result_url": "https://api.tts.ai/v1/results/task_abc123",
  "credits_used": 12,
  "created_at": "2025-01-15T10:30:00Z",
  "completed_at": "2025-01-15T10:30:45Z"
}