API sənədləşməsi

Söhbətdən Mətnə

Audionu mətnə çevir. Avtomatik aşkarlama ilə 99 dili dəstəkləyir.

İstiqamət (multipart/form-data)

Cavab

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

Səs Klonlama

Klon səslə danışıq yaradaraq. Referans səs və mətn yüklə.

İstiqamət (multipart/form-data)

Cavab

Audio faylı TTS son nöqtəsi ilə eyni olan ikilik məlumat olaraq geri qaytarır.

Səs dəyişdiricisi

Səsini fərqli səsə çevir. Mənbə səsini yüklə və hədəf səsi seçin.

İstiqamət (multipart/form-data)

Məsələn İstifadəsi

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

Cavab

Dəyişdirilmiş audio faylı ikilik məlumat olaraq geri qaytarır.

Tərcümə

Söhbət səsini bir dildən digərinə tərcümə et. Tək bir zəngdə söz-mətn, tərcümə və mətn-söhbəti birləşdirir.

İstiqamət (multipart/form-data)

Cavab

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

Speech-to-Speech

Müddəti saxlayaraq danışıq üslubunu, emosionallığı və ya təqdimatı dəyişdir. Ton, ritm və ifadəliliyi düzəltmək üçün faydalıdır.

İstiqamət (multipart/form-data)

Cavab

Dəyişdirilmiş səs faylı ikilik məlumat olaraq geri qaytar.

Audio Vasitələri

Audio işləmə son nöqtələri artırma, vokal çıxarma, stem bölmə və daha çoxu üçün.

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

Səsli söhbət

Audio və ya mətn göndərin və sintez edilmiş səslə AI cavabı alın.

İstiqamət (multipart/form-data ya da JSON)

Cavab

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

Batch TTS

TTS yaradılması üçün paralel olaraq bir çox mətn göndər. Bütün iş bitdikdə seçimli olaraq webhook geri çağırma al.

Parametrlər

Cavab

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

/v1/tts/batch/result/?batch_id=abc123 ilə sorğu irəliləməsi GET

Səs Əqrəbi

Referans səsdən səs daxiletməni əvvəlcədən hesabla. Sonrakı səs klonlama istəklərində anında yaradılması üçün geri qaytarılan embed_id-ni istifadə et.

Parametrlər

Cavab

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

Sağlamlıq Yoxlaması

GPU vericisinin vəziyyətini, yüklənmiş modelləri və növbə böyüklüyünü yoxla. Tanıtma tələb edilmir. 30 saniyəlik ön yaddaş.

Cavab

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

Modelləri siyahıya al

Bütün mövcud modellərin və onların imkanlarının siyahısını geri qaytarır.

Cavab

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

Səslər siyahısı

Bütün mövcud səslərin siyahısını, model və ya dil üzrə filtrlənmiş olaraq geri qaytarır.

Sorğu Parametrləri

Cavab

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

Subtitles (SRT / VTT) yeni

Bütün tamamlanmış TTS işlərinə sinxronlaşdırılmış subtitrlər yaradır. Audio üzərində Whisper düzəlişləməsini yerinə yetirir və SRT ya da WebVTT geri qaytarır. Nəticələr diskdə ön yaddaşda saxlanılır, buna görə də eyni uuid üçün ikinci çağırış disk oxuması olacaq.

Sorğu Parametrləri

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

Tərcümə lüğəti yeni

TTS motoruna müəyyən sözlərin necə səslənəcəyini bildirin. Qeyd edilmiş daxilolmalar hər bir TTS istəyinizə avtomatik olaraq tətbiq olunur. Hər hesab üçün 200 daxilolma həddi.

İstiqamət (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-..."

Siz həmçinin onları saxlamadan per-istək üstələmələrini də verə bilərsiniz - hər hansı bir /v1/tts/ çağırışında pronunciations-ı ya bir obyekt, ya da bir sıra kimi daxil edə bilərsiniz (TTS son nöqtəsi parametrlərini baxın).

Məqalələr yeni

Hər hansı bir məqalə səhifəsində tək