ឯកសារ API
បញ្ចូល TTS.ai ទៅក្នុងកម្មវិធីរបស់អ្នកជាមួយ REST API របស់យើង។ ទ្រង់ទ្រាយ OpenAI ឆបគ្នាសម្រាប់ការផ្លាស់ប្តូរងាយស្រួល។
សេចក្ដីសង្ខេប
TTS.ai API ផ្តល់នូវការចូលដំណើរការកម្មវិធីទៅនឹងលក្ខណៈពិសេសទាំងអស់នៃវេទិកា: អត្ថបទទៅជាសំឡេងសំយោគ, សំឡេងទៅជាអត្ថបទបកប្រែ, ក្លូនសំឡេង, ការពង្រឹងអូឌីយ៉ូនិងច្រើនទៀត។ API ប្រើសន្ធិសញ្ញាស្តង់ដារ REST ជាមួយសំណើ JSON / រាងកាយឆ្លើយតប។
កូនសោ API
យកសោ API របស់អ្នកពី ការកំណត់គណនី. មាននៅលើផែនការ Pro និង Enterprise ។
URL មូលដ្ឋាន
https://api.tts.ai/v1/
ការអនុញ្ញាត
និមិត្តសញ្ញារបស់អ្នកកាន់តាម Authorization បឋមកថា
ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ
/v1/tts/ ធ្វើការដោយគ្មានការអនុញ្ញាតណាមួយឡើយ, រហូតដល់ទៅ 5,000 តួអក្សរ / ថ្ងៃក្នុងមួយ IP, ដោយប្រើម៉ូដែលឥតគិតថ្លៃណាមួយរបស់យើង (piper, vits, melotts, kokoro). ចុះឈ្មោះសម្រាប់គណនីឥតគិតថ្លៃដើម្បីទទួលបាន 15,000 តួអក្សរប្រាក់រង្វាន់និងចូលដំណើរការទៅម៉ូដែលប្រាក់រង្វាន់.
សម្រាប់ម៉ូដែលប្រាក់រង្វាន់និងដែនកំណត់អត្រាខ្ពស់, ផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវជាមួយតួអក្សរ Bearer នៅក្នុង Authorization បឋមកថា.
Authorization: Bearer sk-tts-your-api-key-here
SDKs
SDK ផ្លូវការធ្វើឱ្យវាងាយស្រួលក្នុងការរួមបញ្ចូល TTS.ai ទៅក្នុងកម្មវិធីរបស់អ្នក។ ទាំងពីរគឺប្រភពបើកចំហនិងអាចរកបាននៅលើ GitHub ។
Python
pip install ttsai
from tts_ai import TTSClient
client = TTSClient(api_key="sk-tts-...")
audio = client.generate(
text="Hello world!",
model="kokoro"
)
client.save(audio, "output.wav")
JavaScript / Node.js
npm install @ttsainpm/ttsai
const { TTSClient } = require('@ttsainpm/ttsai');
const client = new TTSClient({
apiKey: 'sk-tts-...'
});
const audio = await client.generate({
input: 'Hello world!',
model: 'kokoro'
});
await client.saveToFile(audio, 'output.wav');
URL មូលដ្ឋាន
ចំណុចបញ្ចប់ទាំងអស់គឺទាក់ទងនឹង URL មូលដ្ឋាននេះ & # 160; ។ ឧទាហរណ៍ ចំណុចបញ្ចប់ TTS គឺ & # 160; ៖
អត្រាកំណត់
ដែនកំណត់អត្រា API ប្រែប្រួលដោយផែនការ ៖
| ផែនការ | សំណើ/ នាទី | កំពុងរត់ | ប្រវែងអត្ថបទអតិបរមា |
|---|---|---|---|
| ឥតគិតថ្លៃ | 10 | 2 | ៥០០ តួអក្សរ |
| កម្មវិធីចាប់ផ្ដើម | 30 | 3 | 1,000,000 តួអក្សរ |
| ជំនាញ | 60 | 5 | 1,000,000 តួអក្សរ |
| សហគ្រាស | 300 | 20 | ៥០, ០០០ តួអក្សរ |
បឋមកថាដែនកំណត់អត្រាត្រូវបានរួមបញ្ចូលក្នុងការឆ្លើយតបនីមួយៗ & # 160; ៖ X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
តម្លៃឥណទាន
| សេវា | តម្លៃ | ឯកតា |
|---|---|---|
| TTS (ម៉ូដែលឥតគិតថ្លៃ & # 160; ៖ Piper, VITS, MeloTTS) | ១, ០០០ តួអក្សរ | ក្នុងមួយ ១, ០០០ តួអក្សរ |
| TTS (គំរូស្តង់ដារ & # 160; ៖ Kokoro, CosyVoice2ល) | ២, ០០០ តួអក្សរ | ក្នុងមួយ ១, ០០០ តួអក្សរ |
| TTS (ម៉ូដែលពិសេស & # 160; ៖ Tortoise, Chatterbox, ល) | ៤, ០០០ តួអក្សរ | ក្នុងមួយ ១, ០០០ តួអក្សរ |
| ការនិយាយទៅអត្ថបទ | ២, ០០០ តួអក្សរ | ចំនួនអូឌីយ៉ូក្នុងមួយនាទី |
| ការក្លូនសំឡេង | ៤, ០០០ តួអក្សរ | ក្នុងមួយ ១, ០០០ តួអក្សរ |
| កម្មវិធីប្ដូរសំឡេង | ៣, ០០០ តួអក្សរ | ចំនួនអូឌីយ៉ូក្នុងមួយនាទី |
| ការពង្រឹងអូឌីយ៉ូ | ២, ០០០ តួអក្សរ | ចំនួនអូឌីយ៉ូក្នុងមួយនាទី |
| ការយកចេញសំឡេង / ការបំបែកសំឡេង | 3,000-4,000 តួអក្សរ | ចំនួនអូឌីយ៉ូក្នុងមួយនាទី |
| ការបកប្រែការនិយាយ | ៥, ០០០ តួអក្សរ | ចំនួនអូឌីយ៉ូក្នុងមួយនាទី |
| ជជែកកំសាន្តសំឡេងName | ៣, ០០០ តួអក្សរ | ក្នុងមួយវេន |
| កម្មវិធីរកគ្រាប់ចុច BPM | ឥតគិតថ្លៃ | -- |
| កម្មវិធីបម្លែងអូឌីយ៉ូ | ឥតគិតថ្លៃ | -- |
អត្ថបទទៅការនិយាយ
បម្លែងអត្ថបទទៅជាអូឌីយ៉ូនិយាយ & # 160; ។ ត្រឡប់ឯកសារអូឌីយ៉ូក្នុងទ្រង់ទ្រាយដែលបានស្នើ & # 160; ។
តួសំណើ
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
| model | string | គ្មាន | លេខសម្គាល់ម៉ូដែល (ឧទាហរណ៍ kokoro, chatterbox, piper) ។ បើមិនបានបញ្ចូល យើងជ្រើសម៉ូដែលដោយស្វ័យប្រវត្តិដែលគាំទ្រ language ដែលបានស្នើសុំ — kokoro សម្រាប់ en/ja/zh/ko/fr/de/it/pt/es/hi/ru, piper សម្រាប់ភាសាដែលបានគាំទ្រផ្សេងទៀត (ar/pl/nl/cs/da/fi/el/hu/tr/uk/vi/etc.) ។ |
| text | string | បាទ/ ចាស | អត្ថបទត្រូវបម្លែងទៅជាការនិយាយ & # 160; ។ កម្រិតសំណើក្នុងមួយសំណើ & # 160; ៖ ៥០០ តួអក្សរ (អនាមិក) ៥, ០០០ (គណនីឥតគិតថ្លៃ) ១, ០០០, ០០០ (ផែនការបង់ប្រាក់) & # 160; ។ ធាតុបញ្ចូលវែងត្រូវបានបែងចែកដោយស្វ័យប្រវត្តិនៅខាងម៉ាស៊ីនបម្រើ & # 160; ។ |
| voice | string | បាទ/ ចាស | លេខសម្គាល់សំឡេង (ប្រើ /v1/voices/ ដើម្បីរាយសំឡេងដែលមាន) |
| format | string | គ្មាន | ទ្រង់ទ្រាយលទ្ធផល & # 160; ៖ mp3 (លំនាំដើម), wav, flac, ogg |
| speed | float | គ្មាន | គុណប្រភាគល្បឿននិយាយ & # 160; ។ លំនាំដើម & # 160; ៖ < code> 1.0 code> & # 160; ។ ជួរ & # 160; ៖ < code> 0.5 code> ទៅ < code> 2.0 code> |
| language | string | គ្មាន | កូដភាសា (ឧទាហរណ៍ en, es) & # 160; ។ រកឃើញដោយស្វ័យប្រវត្តិ ប្រសិនបើបានរំលង & # 160; ។ |
| instructions | string | គ្មាន | ដើរតួជា / ការដឹកជញ្ជូន cues (≤500 តួអក្សរ) ។ ឧ. <កូដ>\ |
| pronunciations | object | array | គ្មាន | ការបដិសេធការបញ្ចេញសំឡេងតាមសំណើ & # 160; ។ ទាំង {\ |
| stream | boolean | គ្មាន | អនុញ្ញាតការឆ្លើយតបស្ទ្រីម & # 160; ។ លំនាំដើម & # 160; ៖ < code> false code > |
សំណើឧទាហរណ៍
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 from TTS.ai! This is a test.",
"voice": "af_bella",
"format": "mp3"
}' \
--output output.mp3
ស្លាក < say- as > SSML
លេខវេចខ្ចប់, កាលបរិច្ឆេទ, រូបិយប័ណ្ណ, លេខទូរស័ព្ទ, និង acronyms ក្នុង ទ្រង់ទ្រាយកាលបរិច្ឆេទលំនាំដើមទៅ The TTS endpoint queues your request and returns a JSON response with a job UUID. You then poll for the result. Poll this endpoint every 1-2 seconds until Fetch the Streaming alternative: For supported models (Kokoro, MeloTTS), use
បកប្រែជា បញ្ចូល បាននិយាយជា cardinal1234one thousand two hundred thirty-four ordinal21twenty-first date1999-12-31ខែ ធ្នូ បីរយមួយ, ដប់ប្រាំមួយ ដប់ប្រាំមួយ time14:30two thirty PM telephone+1-555-867-5309plus one five five five eight six seven… currency$1,234.56one thousand two hundred thirty-four dollars and fifty-six cents spell-outNASAN A S A mdy សម្រាប់ភាសាអង់គ្លេស និង dmy នៅកន្លែងផ្សេងទៀត បដិសេធជាមួយ format=\{
"model": "kokoro",
"voice": "af_bella",
"text": "Your appointment is on <say-as interpret-as=\"date\">2026-04-26</say-as> at <say-as interpret-as=\"time\">14:30</say-as>. Please call <say-as interpret-as=\"telephone\">+1-555-867-5309</say-as> if you need to reschedule."
}ការឆ្លើយតប
Step 1: Submit request
{
"uuid": "77b71db532874ce98e84a69a2d740d4c",
"job_id": "f21316bb-aefa-480d-8523-701d1e3184ce",
"status": "queued",
"credits_used": 11,
"credits_remaining": 15000
}Step 2: Poll for result
status is completed or failed.{
"status": "completed",
"result_url": "https://api.tts.ai/static/downloads/77b71db5.../output.mp3"
}{
"status": "processing"
}Step 3: Download audio
result_url from the completed response to download the audio file.ឧទាហរណ៍ពេញលេញ
import requests, time
API_KEY = "sk-tts-your-key"
BASE = "https://api.tts.ai"
# 1. Submit TTS request
resp = requests.post(f"{BASE}/v1/tts/", json={
"model": "kokoro",
"text": "Hello from TTS.ai!",
"voice": "af_bella"
}, headers={"Authorization": f"Bearer {API_KEY}"})
data = resp.json()
uuid = data["uuid"]
# 2. Poll for result
while True:
result = requests.get(f"{BASE}/v1/speech/results/",
params={"uuid": uuid}).json()
if result["status"] == "completed":
# 3. Download audio
audio = requests.get(result["result_url"])
with open("output.mp3", "wb") as f:
f.write(audio.content)
break
elif result["status"] == "failed":
raise Exception(result.get("error", "Generation failed"))
time.sleep(1.5)POST /v1/tts/stream/ for real-time Server-Sent Events (SSE) streaming — no polling needed.
ការនិយាយទៅអត្ថបទ
បម្លែងអូឌីយ៉ូទៅអត្ថបទ & # 160; ។ គាំទ្រភាសា ៩៩ ជាមួយការរកឃើញដោយស្វ័យប្រវត្តិ & # 160; ។
តួសំណើ (multipart/form-data)
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
| file | file | បាទ/ ចាស | ឯកសារអូឌីយ៉ូ (MP3, WAV, FLAC, OGG, M4A, MP4, WebM) ។ អតិបរមា 100MB ។ |
| model | string | គ្មាន | ម៉ូដែល STT & # 160; ៖ whisper (លំនាំដើម), faster-whisper, sensevoice |
| language | string | គ្មាន | កូដភាសា & # 160; ។ auto សម្រាប់ការរកឃើញដោយស្វ័យប្រវត្តិ (លំនាំដើម) & # 160; ។ |
| timestamps | boolean | គ្មាន | រួមបញ្ចូលត្រាពេលវេលាកម្រិតពាក្យ & # 160; ។ លំនាំដើម & # 160; ៖ false |
| diarize | boolean | គ្មាន | អនុញ្ញាតការកំណត់ទិនានុប្បវត្តិអ្នកនិយាយ & # 160; ។ លំនាំដើម & # 160; ៖ < code> false code > |
ការឆ្លើយតប
{
"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"
}
]
}
ការក្លូនសំឡេង
បង្កើតការនិយាយក្នុងសំឡេងក្លូន & # 160; ។ ផ្ទុកអូឌីយ៉ូ និងអត្ថបទយោងឡើង & # 160; ។
តួសំណើ (multipart/form-data)
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
| reference_audio | file | បាទ/ ចាស | សំឡេងអូឌីយ៉ូយោង (10-30 វិនាទីដែលបានផ្ដល់អនុសាសន៍) ។ 20MB អតិបរមា ។ |
| text | string | បាទ/ ចាស | អត្ថបទដែលត្រូវនិយាយក្នុងសំឡេងក្លូន & # 160; ។ |
| model | string | គ្មាន | ម៉ូដែលក្លូន & # 160; ៖ chatterbox (លំនាំដើម), cosyvoice2, gpt-sovits |
| format | string | គ្មាន | ទ្រង់ទ្រាយលទ្ធផល & # 160; ៖ mp3 (លំនាំដើម), wav, flac |
| language | string | គ្មាន | កូដភាសាគោលដៅ & # 160; ។ ត្រូវតែគាំទ្រដោយម៉ូដែលដែលបានជ្រើស & # 160; ។ |
ការឆ្លើយតប
ត្រឡប់ឯកសារអូឌីយ៉ូជាទិន្នន័យគោលពីរដូចជាចំណុចបញ្ចប់ TTS & # 160; ។
កម្មវិធីប្ដូរសំឡេង
បម្លែងអូឌីយ៉ូទៅជាសំឡេងផ្សេងទៀត & # 160; ។ ផ្ទុកអូឌីយ៉ូប្រភពឡើង និងជ្រើសសំឡេងគោលដៅ & # 160; ។
តួសំណើ (multipart/form-data)
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
| file | file | បាទ/ ចាស | ឯកសារអូឌីយ៉ូប្រភព (MP3, WAV, FLAC) & # 160; ។ អតិបរមា 50MB & # 160; ។ |
| target_voice | string | បាទ/ ចាស | លេខសម្គាល់សំឡេងគោលដៅត្រូវបម្លែងទៅ (ប្រើ /v1/voices/ ដើម្បីរាយសំឡេងដែលមាន) |
| model | string | គ្មាន | ម៉ូដែលបម្លែងសំឡេង & # 160; ៖ openvoice (លំនាំដើម), knn-vc |
| format | string | គ្មាន | ទ្រង់ទ្រាយលទ្ធផល & # 160; ៖ wav (លំនាំដើម), mp3, flac |
សំណើឧទាហរណ៍
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
ការឆ្លើយតប
ត្រឡប់ឯកសារអូឌីយ៉ូដែលបានបម្លែងជាទិន្នន័យគោលពីរ & # 160; ។
ការបកប្រែការនិយាយ
បកប្រែអូឌីយ៉ូដែលបាននិយាយពីភាសាមួយទៅភាសាមួយទៀត ។ រួមបញ្ចូលការនិយាយទៅអត្ថបទ ការបកប្រែ និងអត្ថបទទៅការនិយាយក្នុងការហៅតែមួយ ។
តួសំណើ (multipart/form-data)
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
| file | file | បាទ/ ចាស | ឯកសារអូឌីយ៉ូប្រភពក្នុងភាសាដើម & # 160; ។ អតិបរមា ១០០ មេកាបៃ & # 160; ។ |
| target_language | string | បាទ/ ចាស | កូដភាសាគោលដៅ (ឧ. es, fr, de, ja) |
| voice | string | គ្មាន | សំឡេងសម្រាប់លទ្ធផលបកប្រែ & # 160; ។ ត្រូវបានជ្រើសដោយស្វ័យប្រវត្តិ ប្រសិនបើបានរំលង & # 160; ។ |
| preserve_voice | boolean | គ្មាន | ព្យាយាមរក្សាលក្ខណៈពិសេសសំឡេងរបស់អ្នកនិយាយដើម & # 160; ។ លំនាំដើម & # 160; ៖ < code> false code > |
ការឆ្លើយតប
{
"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
}
និយាយទៅនិយាយ
បម្លែងរចនាប័ទ្មនិយាយ អារម្មណ៍ ឬការផ្ដល់ខណៈពេលរក្សាមាតិកា & # 160; ។ មានប្រយោជន៍សម្រាប់លៃតម្រូវសំឡេង ល្បឿន និងភាពបង្ហាញ & # 160; ។
តួសំណើ (multipart/form-data)
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
| file | file | បាទ/ ចាស | ឯកសារអូឌីយ៉ូនិយាយប្រភព & # 160; ។ អតិបរមា ៥០ មេកាបៃ & # 160; ។ |
| voice | string | បាទ/ ចាស | លេខសម្គាល់សំឡេងគោលដៅសម្រាប់ការនិយាយលទ្ធផល |
| model | string | គ្មាន | ម៉ូដែល & # 160; ៖ openvoice (លំនាំដើម), chatterbox |
| emotion | string | គ្មាន | អារម្មណ៍គោលដៅ & # 160; ៖ អព្យាក្រឹត, សប្បាយ, សោក, ខឹង, រំភើប |
| speed | float | គ្មាន | ការលៃតម្រូវល្បឿន & # 160; ។ លំនាំដើម & # 160; ៖ < code> 1.0 code> & # 160; ។ ជួរ & # 160; ៖ < code> 0.5 code> ទៅ < code> 2.0 code> |
ការឆ្លើយតប
ត្រឡប់ឯកសារអូឌីយ៉ូដែលបានបម្លែងជាទិន្នន័យគោលពីរ & # 160; ។
ឧបករណ៍អូឌីយ៉ូ
ចំណុចបញ្ចប់ដំណើរការអូឌីយ៉ូសម្រាប់ការពង្រីក ការយកសំឡេងចេញ ការបំបែកដើម និងច្រើនទៀត ។
បង្កើនគុណភាពអូឌីយ៉ូ & # 160; ៖ denoise បង្កើនភាពច្បាស់ គុណភាពបង្ហាញខ្ពស់ & # 160; ។
| file file | ឯកសារអូឌីយ៉ូត្រូវពង្រីក |
| denoise boolean | អនុញ្ញាតការបំបាត់សំឡេងរំខាន (លំនាំដើម & # 160; ៖ ពិត) |
| enhance_clarity boolean | បង្កើនភាពច្បាស់នៃការនិយាយ (លំនាំដើម & # 160; ៖ ពិត) |
| super_resolution boolean | ធ្វើមាត្រដ្ឋានគុណភាពអូឌីយ៉ូឡើងវិញ (លំនាំដើម & # 160; ៖ មិនពិត) |
| strength integer | ១- ៣ (ស្រាល មធ្យម ខ្លាំង) & # 160; ។ លំនាំដើម & # 160; ៖ ២ |
បំបែកសំឡេងពីឧបករណ៍ភ្លេង (យកសំឡេងចេញ) ឬបំបែកទៅជាដើម & # 160; ។
| file file | ឯកសារអូឌីយ៉ូដែលត្រូវបំបែក |
| model string | demucs (លំនាំដើម) ឬ spleeter |
| stems integer | ចំនួនដើម & # 160; ៖ ២, ៤, ៥ ឬ ៦ (លំនាំដើម & # 160; ៖ ២) |
| format string | ទ្រង់ទ្រាយលទ្ធផល & # 160; ៖ wav, mp3, flac |
យកសំឡេងរំខាន និងសំឡេងរំខានចេញពីការថតអូឌីយ៉ូ & # 160; ។
| file file | ឯកសារអូឌីយ៉ូដែលត្រូវដំណើរការ |
| type string | echo or reverb (default: both) |
| intensity integer | 1-5 (default: 3) |
វិភាគអូឌីយ៉ូដើម្បីរកឃើញគ្រាប់ចុច BPM និងហត្ថលេខាពេលវេលា ។
| file file | ឯកសារអូឌីយ៉ូដែលត្រូវវិភាគ |
{
"key": "C",
"scale": "Major",
"bpm": 120.0,
"time_signature": "4/4",
"camelot": "8B",
"compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}
បម្លែងអូឌីយ៉ូរវាងទ្រង់ទ្រាយ & # 160; ។
| file file | ឯកសារអូឌីយ៉ូដែលត្រូវបម្លែង |
| format string | ទ្រង់ទ្រាយគោលដៅ & # 160; ៖ mp3, wav, flac, ogg, m4a, aac |
| bitrate integer | អត្រាប៊ីតលទ្ធផលគិតជាគីឡូបៃ & # 160; ៖ ៦៤, ១២៨, ១៩២, ២៥៦, ៣២០ |
| sample_rate integer | អត្រាគំរូ: 22050, 44100, 48000 |
| channels string | mono ឬ stereo |
ជជែកកំសាន្តសំឡេងName
ផ្ញើអូឌីយ៉ូ ឬអត្ថបទ និងទទួលការឆ្លើយតប AI ជាមួយនឹងការនិយាយដែលបានសំយោគ ។
តួសំណើ (multipart/form-data ឬ JSON)
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|---|
| audio | file | គ្មាន* | ការបញ្ចូលអូឌីយ៉ូ (ត្រូវការ audio ឬ text) |
| text | string | គ្មាន* | ការបញ្ចូលអត្ថបទ (ត្រូវការ audio ឬ text) |
| voice | string | គ្មាន | សំឡេងសម្រាប់ការឆ្លើយតប AI & # 160; ។ លំនាំដើម & # 160; ៖ af_bella |
| tts_model | string | គ្មាន | ម៉ូដែល TTS សម្រាប់ការឆ្លើយតប & # 160; ។ លំនាំដើម & # 160; ៖ kokoro |
| system_prompt | string | គ្មាន | សំណួរប្រព័ន្ធផ្ទាល់ខ្លួនសម្រាប់ AI |
| conversation_id | string | គ្មាន | បន្តការសន្ទនាដែលមានស្រាប់ |
ការឆ្លើយតប
{
"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 ប៉ារ៉ាឡែល & # 160; ។ ទទួលការហៅត្រឡប់ webhook នៅពេលការងារទាំងអស់បានបញ្ចប់ & # 160; ។
ប៉ារ៉ាម៉ែត្រ
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | សេចក្ដីពិពណ៌នា |
|---|---|---|
| texts | array | Array of objects: {text, model, voice}. Max 50 items. |
| webhook_url | string | URL ជម្រើសដើម្បីបង្ហាញលទ្ធផល POST ពេលបាច់បញ្ចប់ & # 160; ។ |
ការឆ្លើយតប
{
"batch_id": "abc123",
"total": 3,
"completed": 0,
"status": "processing"
}
វឌ្ឍនភាពនៃការស្ទង់មតិជាមួយ GET /v1/tts/batch/result/?batch_id=abc123
ការបង្កប់សំឡេង
គណនាជាមុនការបង្កប់សំឡេងពីអូឌីយ៉ូយោង & # 160; ។ ប្រើ embed_ id ដែលបានត្រឡប់ក្នុងសំណើក្លូនសំឡេងបន្ទាប់សម្រាប់ការបង្កើតឆាប់ៗ & # 160; ។
ប៉ារ៉ាម៉ែត្រ
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | សេចក្ដីពិពណ៌នា |
|---|---|---|
| file | file | Reference audio file (WAV, MP3, FLAC). |
| model | string | Cloning model (default: chatterbox). Supported: chatterbox, cosyvoice2, openvoice, gpt-sovits, spark, indextts2, qwen3-tts. |
ការឆ្លើយតប
{
"embed_id": "emb_abc123",
"model": "chatterbox",
"duration_ms": 450
}
ពិនិត្យមើលសុខភាព
ពិនិត្យមើលស្ថានភាពម៉ាស៊ីនបម្រើ GPU ម៉ូដែលដែលបានផ្ទុក និងទំហំជួរ & # 160; ។ មិនចាំបាច់ផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវទេ & # 160; ។ បានដាក់ឃ្លាំងសម្ងាត់សម្រាប់ ៣០ វិនាទី & # 160; ។
ការឆ្លើយតប
{
"status": "online",
"latency_ms": 45,
"queue_size": 3,
"models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}
បញ្ជីម៉ូដែល
ត្រឡប់បញ្ជីនៃម៉ូដែលដែលមានទាំងអស់ជាមួយនឹងសមត្ថភាពរបស់ពួកវា & # 160; ។
ការឆ្លើយតប
{
"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
}
]
}
បញ្ជីសំឡេង
ត្រឡប់បញ្ជីនៃសំឡេងដែលមានទាំងអស់ ដែលបានត្រងតាមម៉ូដែល ឬភាសា & # 160; ។
ប៉ារ៉ាម៉ែត្រសំណួរ
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ការពិពណ៌នា |
|---|---|---|
| model | string | តម្រងតាមលេខសម្គាល់ម៉ូដែល (ឧ. kokoro) |
| language | string | តម្រងតាមកូដភាសា (ឧ. en) |
| gender | string | តម្រងតាមភេទ ៖ ប្រុស, ស្រី, អព្យាក្រឹត |
ការឆ្លើយតប
{
"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
}
ចំណងជើងរង (SRT / VTT) ថ្មី
បង្កើតចំណងជើងរងដែលបានធ្វើសមកាលកម្មសម្រាប់ការងារ TTS ដែលបានបញ្ចប់ណាមួយ & # 160; ។ រត់ការតម្រឹម Whisper លើអូឌីយ៉ូ និងត្រឡប់ SRT ឬ WebVTT & # 160; ។ លទ្ធផលត្រូវបានឃ្លាំងសម្ងាត់លើថាស ដូច្នេះការហៅលើកទីពីរសម្រាប់ uuid ដូចគ្នាគឺជាការអានថាស & # 160; ។
ប៉ារ៉ាម៉ែត្រសំណួរ
| ប៉ារ៉ាម៉ែត្រ | ត្រូវការ | ការពិពណ៌នា |
|---|---|---|
| uuid | បាទ/ ចាស | UUID ការងារត្រឡប់ដោយ / v1/ tts / ឬ / v1/ voice- clone / & # 160; ។ |
| format | គ្មាន | srt (លំនាំដើម) ឬ vtt & # 160; ។ |
| download | គ្មាន | 1 ដើម្បីផ្ញើ Content- Disposition: attachment ដូច្នេះកម្មវិធីរុករករក្សាទុកជំនួសឲ្យបង្ហាញ & # 160; ។ |
| language | គ្មាន | ព័ត៌មានជំនួយសម្រាប់ម៉ូដែលតម្រឹម (រកឃើញដោយស្វ័យប្រវត្តិបើបានរំលង) & # 160; ។ |
curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt
វចនានុក្រមការបញ្ចេញសំឡេង ថ្មី
ប្រាប់ម៉ាស៊ីន TTS អំពីរបៀបបញ្ចេញសំឡេងពាក្យជាក់លាក់ & # 160; ។ ធាតុដែលបានរក្សាទុកអនុវត្តដោយស្វ័យប្រវត្តិទៅសំណើ TTS ទាំងអស់ដែលអ្នកធ្វើ & # 160; ។ កំណត់ចំនួនធាតុក្នុងមួយគណនីចំនួន 200 & # 160; ។
តួសំណើ (POST)
| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ការពិពណ៌នា |
|---|---|---|
| word | string | ពាក្យដែលត្រូវបដិសេធ (ឧ. GIF, Anthropic) & # 160; ។ ព្រំដែនពាក្យផ្គូផ្គង & # 160; ។ |
| replacement | string | របៀប spell វាសម្រាប់ម៉ូដែល (ឧទាហរណ៍ jiff, ann THROP ick) ។ |
| language | string | កូដ ISO ជម្រើស & # 160; ។ ទទេ = អនុវត្តទៅភាសាទាំងអស់ & # 160; ។ |
| case_sensitive | boolean | លំនាំដើម false ។ ផ្គូផ្គងតួអក្សរតូចធំនៅពេលដែល true ។ |
# 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-..."
អ្នកក៏អាចផ្ញើការបដិសេធសំណើដោយមិនរក្សាទុកពួកគេដែរ — រួមបញ្ចូល pronunciations លើការហៅ /v1/tts/ ណាមួយជាវត្ថុ ឬជាអារេ (មើលប៉ារ៉ាម៉ែត្រចំណុចបញ្ចប់ TTS) ។
កម្មវិធីនិយាយអត្ថបទ ថ្មី
ទម្លាក់តែមួយ ស្លាកនៅលើទំព័រអត្ថបទណាមួយនិងភ្ញៀវទេសចរទទួលបានរបារអ្នកអានថេរដែល narrates ទំព័រនៅលើចុច. រកឃើញដោយស្វ័យប្រវត្តិរាងកាយអត្ថបទ, គាំទ្រសំឡេងផ្ទាល់ខ្លួន / ម៉ូដែល / ទីតាំង / ពណ៌ accent.
<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>
ជម្រើស
| ប៉ារ៉ាម៉ែត្រ | ការពិពណ៌នា |
|---|---|
data-pk | កូនសោដែលអាចបោះពុម្ពផ្សាយ (pk- tts-... ) ។ ដែនដែលបានដាក់កម្រិតត្រូវបានអនុវត្តតាមរយៈវាល allowed_ domains របស់កូនសោ ។ |
data-voice | លេខសម្គាល់សំឡេង & # 160; ។ លំនាំដើម af_bella & # 160; ។ |
data-model | លេខសម្គាល់ម៉ូដែល TTS & # 160; ។ លំនាំដើម kokoro & # 160; ។ |
data-extract | auto (លំនាំដើម) — ព្យាយាមអត្ថបទ / មេ /.post-content /.entry-content ជ្រើស, ធ្លាក់ត្រឡប់ទៅគូទខ័ណ្ឌដិតបំផុត. ឬឆ្លងកាត់អ្នកជ្រើស CSS ណាមួយដើម្បីផ្តោតលើធាតុជាក់លាក់មួយ. |
data-position | bottom (លំនាំដើម) ឬ top & # 160; ។ |
data-color | ពណ៌បន្លិច (ពណ៌ CSS ណាមួយ) & # 160; ។ លំនាំដើម # e60000 & # 160; ។ |
data-min-chars / data-max-chars | រំលងរបារប្រសិនបើអត្ថបទខ្លីជាងតួអក្សរអប្បបរមា (លំនាំដើម ២០០) & # 160; ។ បញ្ចូលកាបនៅតួអក្សរអតិបរមា (លំនាំដើម ៥០, ០០០) & # 160; ។ |
ធាតុក្រាហ្វិកប៊ូតុងស្តាប់
បញ្ចូលរចនាប័ទ្មប៊ូតុងក្នុងបន្ទាត់ & # 160; ។ បង្ហាញនៅខាងមុខស្លាក < code>< script code> របស់វា និងចាក់ប៊ូតុងដែលបានកេះខ្លី & # 160; ។ រាងខុសគ្នាពីកម្មវិធីនិយាយអត្ថបទខាងលើ (ដែលបញ្ចូលរបារទំព័រដោយស្វ័យប្រវត្តិ និងនិយាយអត្ថបទទាំងមូល) & # 160; ។
<script src="https://tts.ai/widget.js"
data-voice="af_bella"
data-model="kokoro"
data-style="full"
data-theme="light"></script>
សំឡេងដែលបានរក្សាទុក (ក្លូនដែលមានស្ថេរភាព)
ផ្ទុកអូឌីយ៉ូយោងឡើងម្តងទៀត យកលេខសម្គាល់សំឡេងដែលមានស្ថេរភាពមកវិញ បន្ទាប់មកយោងលេខសម្គាល់នោះក្នុងសំណើ TTS ជំនួសឲ្យផ្ទុកអូឌីយ៉ូឡើងវិញរាល់ការហៅទាំងអស់ ។ ល្អសម្រាប់ការរួមបញ្ចូលកម្រិតសំឡេងខ្ពស់ ។
ផ្ទុកសំឡេងឡើង
POST
https://tts.ai/api/v1/user-voices/
ត្រូវការការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ
សំណុំបែបបទច្រើនផ្នែក។ វាល៖ ឯកសារ (ចាំបាច់, 5-30s អូឌីយ៉ូ), ឈ្មោះ (ចាំបាច់), ភាសា (ជាជម្រើស, លំនាំដើម en), ម៉ូដែល (ជាជម្រើស — ជ្រើសដោយស្វ័យប្រវត្តិ cosyvoice2 សម្រាប់ zh / ja / ko ផ្សេងទៀត openvoice), consent_confirmed (ចាំបាច់, តម្លៃពិតណាមួយ) ។
curl -X POST https://tts.ai/api/v1/user-voices/ \
-H "Authorization: Bearer sk-tts-your-key" \
-F "file=@reference.wav" \
-F "name=My Narrator" \
-F "language=en" \
-F "consent_confirmed=true"
# Response:
{
"public_id": "uv_a1b2c3d4e5f6",
"id": 42,
"name": "My Narrator",
"model_name": "openvoice",
"language": "en",
"reference_audio_url": "https://tts.ai/media/user-voices/....wav",
"storage_status": "active",
"created_at": "2026-04-17T03:45:00+00:00"
}
ប្រើសំឡេងដែលបានរក្សាទុកក្នុង TTS
POST ទៅ /api/v1/tts/ (ចំណាំ: ម៉ាស៊ីន VPS បណ្ដាញ, មិន api.tts.ai) ជាមួយ user_voice_id. យើងផ្ទុកអូឌីយ៉ូដែលបានរក្សាទុករបស់អ្នកនិងផ្លូវទៅបំពង់កឡូយ។
curl -X POST https://tts.ai/api/v1/tts/ \
-H "Authorization: Bearer sk-tts-your-key" \
-H "Content-Type: application/json" \
-d '{"text":"Hello from my saved voice","user_voice_id":"uv_a1b2c3d4e5f6"}'
# Returns a queued job — poll /v1/speech/results/?uuid=... for the audio URL.
បញ្ជី / លុប
GET https://tts.ai/api/v1/user-voices/ # list your saved voices + quota info
DELETE https://tts.ai/api/v1/user-voices/?public_id=uv_a1b2c3d4e5f6
ប័ណ្ណសារ / ធ្វើឲ្យសកម្មឡើងវិញ (ឥតគិតថ្លៃ)
សំឡេងដែលបានដាក់ក្នុងប័ណ្ណសារនៅក្នុងគណនីរបស់អ្នក ប៉ុន្តែមិនអាចប្រើក្នុង TTS បានឡើយ & # 160; ។ មានប្រយោជន៍សម្រាប់អ្នកប្រើចុងក្រោយដែលដេក ដូច្នេះបញ្ជីរបស់អ្នកនៅតែស្អាត & # 160; ។
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/archive/
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/reactivate/
ឧទាហរណ៍កូដ
អត្ថបទទៅការនិយាយ
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 វាល & # 160; ។
{
"error": {
"code": "insufficient_credits",
"message": "You do not have enough characters for this request.",
"characters_required": 4000,
"characters_available": 2000
}
}
| ស្ថានភាព HTTP | កូដកំហុស | ការពិពណ៌នា |
|---|---|---|
| 400 | bad_request |
ប៉ារ៉ាម៉ែត្រសំណើមិនត្រឹមត្រូវ & # 160; ។ ពិនិត្យមើលសារកំហុសសម្រាប់សេចក្ដីលម្អិត & # 160; ។ |
| 401 | unauthorized |
បាត់ ឬសោ API មិនត្រឹមត្រូវ & # 160; ។ |
| 402 | insufficient_credits |
គ្មានតួអក្សរគ្រប់គ្រាន់. ទិញបន្ថែមទៀតនៅ / pricing /. |
| 403 | forbidden |
អ្នកមិនមានសិទ្ធិចូលដំណើរការធនធាននេះទេ (ឧទាហរណ៍ ធ្វើការសួរអ្នកប្រើផ្សេង) & # 160; ។ ការចូលដំណើរការ API ផ្ទាល់ខ្លួនត្រូវបានរួមបញ្ចូលក្នុងផែនការទាំងអស់ & # 160; ។ |
| 404 | not_found |
រកមិនឃើញម៉ូដែល ឬសំឡេង & # 160; ។ |
| 413 | file_too_large |
ឯកសារដែលបានផ្ទុកឡើងលើសពីដែនកំណត់ទំហំ & # 160; ។ |
| 429 | rate_limited |
សំណើច្រើនពេក & # 160; ។ ពិនិត្យមើលបឋមកថាដែនកំណត់អត្រា & # 160; ។ |
| 500 | internal_error |
កំហុសម៉ាស៊ីនបម្រើ & # 160; ។ ព្យាយាមម្ដងទៀតពេលក្រោយ & # 160; ។ |
| 503 | model_loading |
កំពុងផ្ទុកម៉ូដែល & # 160; ។ ព្យាយាមម្ដងទៀតក្នុងរយៈពេលពីរបីវិនាទី & # 160; ។ |
Webhooks
សម្រាប់ភារកិច្ចដែលរត់យូរ (ការបំបែកដើម, TTS batch) អ្នកអាចផ្ដល់ប៉ារ៉ាម៉ែត្រ < code> webhook_ url code> & # 160; ។ ពេលភារកិច្ចបញ្ចប់ យើងនឹង POST លទ្ធផលទៅ URL របស់អ្នក & # 160; ។
{
"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"
}
រួចរាល់ហើយឬ?
ទទួលបានសោ API របស់អ្នកហើយចាប់ផ្តើមរួមបញ្ចូល TTS.ai ទៅក្នុងកម្មវិធីរបស់អ្នក.