API דאָקומענטאַציע

טעקסט פֿאַרבtext-tool-action

איבערשרײַבן אַודיאָ צו טעקסט. שטיצט 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 סוף־פּונקט

שפּראַך־װײַזער

קלײַב אַלץ אױסselect-action

פֿראַגע־קאָפּ (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
}

שפּראַך צו שפּראַך

איבער־פֿאַרװאַנדלען די שפּראַך־סטיל, אױף־געפֿיל, אָדער איבערצײַגונג בשעת מען האַלט דעם אינהאַלט. נייטיק פֿאַר צופּאַסונג פֿון טון, צײַט און אויסדרוק

פֿראַגע־קאָפּ (multipart/form-data)

ענטפֿער

װײַז די טראַנספֿאָרמירטע אודיו־טעקע װי בײַנאַרישע דאַטן

אוודיאָ־אַרײַנשרײַב

אודיו־פּראָצעסירונג סוף־פּונקטן פֿאַר פֿאַרבעסערן, שפּראַך־אַרײַנשרײַבן, װײַסװײַז־אָפּטיילונג, און מער

{
  "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 שאַפֿן. אױב איר װילט, װעט מען אױסשלײדן אַ װײַב־האָק װען אַלע אַרבעטן זײַנען ענדיקט

פּאַראַמעטערס

ענטפֿער

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

װײַז פּראָגרעס מיט GET /v1/tts/batch/result/?batch_id=abc123

שפּראַך

Pre-compute a voice embedding from reference audio. Use the returned embed_id in subsequent voice cloning requests for near-instant generation.

פּאַראַמעטערס

ענטפֿער

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

קלײַב אַלץ אױסundo-type

װײַזט אַ רשימה פֿון אַלע בנימצאע שפּראַכן, אױסגעפילטערט לויט מאָדעל אָדער שפּראַך

פֿראַגע פּאַראַמעטערס

ענטפֿער

{
  "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) נייַעs-action

שאַפֿט סינכראָניזירטע אונטערשטעלעך פֿאַר װעלכע װידער TTS־באַהאַנדלונג אױף װאָסער װאָסער. װײַזט אַ פֿישפּער־אויספֿיר איבער דעם אודיו און װײַזט צוריק SRT אָדער WebVTT. דער רעזולטאט איז פֿאַרזיכערט אױף דער שטיק, אַזוי אַז אַ צווייטער װײַזונג פֿון דער זעלבער uuid איז אַ שטיק־לײען

פֿראַגע פּאַראַמעטערס

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

אויסלייג־װײַזער נייַעs-action

דערקלערן דעם 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/ װעגװײַז װי אַן אוביעקט אָדער אַ אַרײַנשרײַב (זען די TTS סוף־פּאַראַמעטערס)

אַרטיקל־פֿאָרש נייַעs-action

װײַז/היטן טעקסט־פֿאַרב

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

אָפּציעס

מקור אויף GitHub:

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

טעקסט פֿאַרבtext-tool-action

פֿאַר לאַנג־לײַטנדיקע אַרבעטן (סטאַם צעשײדונג, באַטש 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"
}