Dokumentasi API

Tutur ke Teks

Transkrip audio ke teks. Menyokong 99 bahasa dengan pengesanan automatik.

Tubuh Permintaan (multipart/form-data)

Balasan

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

Klon Suara

Janakan percakapan dalam suara klon. Muat naik audio rujukan dan teks.

Tubuh Permintaan (multipart/form-data)

Balasan

Kembalikan fail audio sebagai data binari, sama seperti titik akhir TTS.

Pengubah SuaraName

Tukar audio untuk berbunyi seperti suara lain. Muat naik audio sumber dan pilih suara sasaran.

Tubuh Permintaan (multipart/form-data)

Permintaan Contoh

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

Balasan

Kembalikan fail audio yang ditukar sebagai data binari.

Penterjemah Perkataan

Terjemahkan audio yang diucapkan dari satu bahasa ke bahasa lain. Menggabungkan percakapan-ke-teks, terjemahan, dan teks-ke-percakapan dalam satu panggilan.

Tubuh Permintaan (multipart/form-data)

Balasan

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

Tutur ke Tutur

Tukar gaya ucapan, emosi, atau penghantaran sambil menyimpan kandungan. Berguna untuk menyelaraskan nada, irama, dan ekspresi.

Tubuh Permintaan (multipart/form-data)

Balasan

Kembalikan fail audio yang diubah sebagai data binari.

Alat Audio

Titik akhir pemprosesan audio untuk penambahbaikan, penghapusan vokal, pemisahan stem, dan lain-lain.

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

Sembang Suara

Hantar audio atau teks dan terima respon AI dengan ucapan disintesis.

Tubuh Permintaan (multipart/form-data atau JSON)

Balasan

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

Hantarkan teks berbilang untuk penjanaan TTS selari. Secara opsyenal terima panggilan balik webhook apabila semua kerja selesai.

Parameter

Balasan

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

Progres poll dengan GET /v1/tts/batch/result/?batch_id=abc123

Pembentangan

Pra-hitung pembesaran suara dari audio rujukan. Guna embed_id dikembalikan dalam permintaan klon suara seterusnya untuk penjanaan hampir-segera.

Parameter

Balasan

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

Periksa Kesihatan

Semak status pelayan GPU, model dimuatkan, dan saiz baris gilir. Tiada pengesahan diperlukan. Dicache untuk 30 saat.

Balasan

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

Senarai Model

Kembalikan senarai semua model yang ada dengan keupayaan mereka.

Balasan

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

Senarai Bunyi

Kembalikan senarai semua suara yang ada, secara opsyen ditapis mengikut model atau bahasa.

Parameter Pertanyaan

Balasan

{
  "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) baru

Janakan subtajuk disegerakkan untuk sebarang kerja TTS yang selesai. Jalankan penyelarasan Whisper ke atas audio dan kembalikan SRT atau WebVTT. Hasilnya disimpan cache pada cakera supaya panggilan kedua untuk uuid yang sama adalah bacaan cakera.

Parameter Pertanyaan

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

Kamus Huruf baru

Beritahu enjin TTS bagaimana untuk mengucapkan perkataan tertentu. Entri yang disimpan akan dilaksanakan secara automatik pada setiap permintaan TTS yang anda buat. Had masukan 200 per akaun.

Tubuh Permintaan (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-..."

Anda juga boleh hantar gantian per-permintaan tanpa menyimpannya — termasuk pronunciations pada sebarang panggilan /v1/tts/ sama ada sebagai objek atau aras (lihat parameter titik akhir TTS).

Penutur Artikel baru

Letakkan tag