Ҳуҷҷатҳои API

Гузаштан ба матнComment

Гузаронидани аудио ба матн. 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"
    }
  ]
}

Тасвири овоз

Эҷоди сухан дар овози клонӣ. Боркунии аудиои истинод ва матн.

Дархости ҷисм (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

Ҷавоб

Файли аудиоии табдилёфтаро ҳамчун додаҳои дуӣ бар мегардонад.

Тарҷумаи гуфторName

Тарҷумаи садои гуфтугӯӣ аз як забон ба дигар. Дар як занг гуфтугӯ ба матн, тарҷума ва матн ба суханро якҷоя мекунад.

Дархости ҷисм (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
}

Забон ба Забон

Услуби суханронӣ, эҳсосот ё пешниҳодро бо нигоҳ доштани мундариҷа тағйир диҳед. Барои танзими садо, суръат ва ифоданокӣ фоиданок аст.

Дархости ҷисм (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"]
}

Чати овозӣ

Фиристодани аудио ё матн ва гирифтани ҷавоби 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 фиристед. Агар хоҳед, пас аз анҷоми ҳамаи корҳо бозхонди webhook- ро қабул кунед.

Параметрҳо

Ҷавоб

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

Ҳолати пурсиш бо GET /v1/tts/batch/result/?batch_id=abc123

Дарунсохти овоз

Пешакӣ ҳисоб кардани дарҷкунии овоз аз аудиои истинод. Истифодаи embed_id-и баргашта дар дархостҳои дубораи дубораи овоз барои эҷоди қариб фаврӣ.

Параметрҳо

Ҷавоб

{
  "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
}

Субтитрҳо (SRT / VTT) нав

Сохтани зернависи ҳамоҳангшуда барои ҳар як вазифаи 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-..."

Шумо инчунин метавонед дархостҳои дархостро бе захира кардан гузаронед — pronunciations-ро дар ҳар як зангзании /v1/tts/ ҳамчун объект ё маҷмӯа дохил кунед (ба параметрҳои нуқтаи охирини 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>

& Интихоботҳо

Шаблон:Шаҳристон Шаблон:Шаҳристон

Кнопкаи гӯш карданComment

Дар сатр даровардани услуби тугма. Дар паҳлӯи тегҳои < code>< script ва пахши тугмаҳои кӯтоҳ пахш мекунад. Шакли гуногун аз хонандаи мақолот дар боло (ки ба таври худкор панели саҳифаро дар бар мегирад ва тамоми мақолотро хонда мешавад).

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

Захираи овозҳо (Клонҳои доимӣ)

Боркунии аудиои истинод як маротиба, гирифтани voice_id-и доимӣ, сипас истинод ба ин id дар дархостҳои 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 истифода шаванд. Барои корбарони ниҳоии хобида фоиданок аст, то ки рӯйхати шумо тоза монад.

POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/archive/
POST https://tts.ai/api/v1/user-voices/uv_a1b2c3d4e5f6/reactivate/

Намунаҳои рамз

• 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
  }
}

WebhooksName

Барои вазифаҳои дарозмуддат (тақсимкунии реша, TTS-и гурӯҳӣ), шумо метавонед параметри webhook_url-ро пешниҳод кунед. Вақте ки вазифа ба итмом мерасад, мо натиҷаро ба URL-и шумо мефиристем.

{
  "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"
}