Dokimantasyon API

Konvèti pale an tèksName

Transkri audio pou tèks. Soti nan 99 lang ak deteksyon otomatik.

Kò demann lan (multipart/form-data)

Reponn

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

Klonaj Vokal

Kreye pale nan yon vwa klone. Upload yon referans son ak tèks.

Kò demann lan (multipart/form-data)

Reponn

Retounen dosye son an kòm done binè, menm jan ak pwent bout TTS la.

Chanjman Voy

Convert audio to sound like a different voice. Upload source audio and choose a target voice.

Kò demann lan (multipart/form-data)

Ekzanp demann

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

Reponn

Retounen nan dosye son ki te transfòme a kòm done binè.

Tradiksyon

Tradwi odyo pale soti nan yon lang nan yon lòt. Konbine pale-a-tèks, tradiksyon, ak tèks-a-vokal nan yon sèl apèl.

Kò demann lan (multipart/form-data)

Reponn

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

Pale pou paleComment

Travèse style pale, emosyon, oswa livrezon pandan y ap kenbe kontni an. Itil pou ajiste ton, pacing, ak ekspresyon.

Kò demann lan (multipart/form-data)

Reponn

Retounen nan fichye son transfòme a kòm done binè.

OdinatèName

Endpoints Audio pwosesis pou amelyore, retire vokal, stem divizyon, ak plis ankò.

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

Konvèsasyon Vokal

Envoye odyo oswa tèks ak resevwa yon repons AI ak pale synthesized.

Kò demann lan (multipart/form-data or JSON)

Reponn

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

Submit multiple texts for parallel TTS generation. Optionally receive a webhook callback when all jobs complete.

Paramèt

Reponn

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

Poll progress with GET /v1/tts/batch/result/?batch_id=abc123

Enkòporasyon Vokal

Pre-kalkile yon enkòporasyon vwa soti nan son referans. Itilize embed_id ki retounen nan demann klonaj vwa ki vini apre pou yon jenerasyon prèske imedyat.

Paramèt

Reponn

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

Verifikasyon sante

Tcheke estati sèvè GPU, modèl chaje, ak gwosè file. Pa gen autentifikasyon mande. Mete nan memwa pou 30 segonn.

Reponn

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

List Models

Retounen yon lis tout modèl ki disponib ak kapasite yo.

Reponn

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

Liy vwa

Retounen yon lis tout vwa ki disponib, ki ka filtre pa modèl oswa lang.

Paramèt kesyon

Reponn

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

Sous-titres (SRT / VTT) nouvo

Pwodui sous-titres sinkronize pou nenpòt travay TTS ki te fini. Egzekite alignman Whisper sou son an epi retounen SRT oswa WebVTT. Rezulte a se nan cache sou disk pou yon dezyèm apèl pou menm uuid la se yon lekti diskèt.

Paramèt kesyon

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

Diksyonè Pronunciation nouvo

Di motè TTS kijan pou li pwonunsye mo espesifik. Enfòmasyon ki te sove yo ap aplike otomatikman pou chak demann TTS ou fè. Limit 200 enstriksyon pou chak kont.

Kò demann lan (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-..."

Ou ka tou pase overrides pa demann san yo pa sove yo — enkli pronunciations sou nenpòt apèl /v1/tts/ kòm yon objè oswa yon array (gade paramèt pwen bout TTS).

Narrateur nouvo

Drop yon sèl