Dokumentacija API

Govor na besedilo

Transcribe audio na besedilo. Podpira 99 jezikov z avto-detekcijo.

Telo zahtevka (multipart/form-data)

Odziv

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

Kloniranje glasu

Ustvari govor v kloniranem glasu. Naloži referenčni zvok in besedilo.

Telo zahtevka (multipart/form-data)

Odziv

Vrne zvočno datoteko kot binarne podatke, enako kot dogodek TTS.

Spreminjevalec glasu

Pretvori zvok v zvok kot drugačen glas. Pošlji zvok vira in izberi tarčo glasu.

Telo zahtevka (multipart/form-data)

Zahtevek za primer

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

Odziv

Vrne konvertirano zvočno datoteko kot binarne podatke.

Prevod govora

Prevaja govorjen zvok iz enega jezika v drugega. Združuje govor-to-tekst, prevod, in besedilo-to-speech v enem klicu.

Telo zahtevka (multipart/form-data)

Odziv

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

Govor govoru

Preoblikovanje govora, čustva, ali dostava ob ohranjanju vsebine. Koristno za prilagoditev tona, hodljenje in izrazitost.

Telo zahtevka (multipart/form-data)

Odziv

Vrne spremenjeno zvočno datoteko kot binarne podatke.

Zvočna orodja

Končni dogodki za obdelavo zvoka za izboljšanje, odstranjevanje glasu, ločevanje stebel in več.

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

Glasovni pogovor

Pošljite zvok ali besedilo in prejmite odgovor AI z sintetiziranim govorom.

Telo zahtevka (multipart/form-data ali JSON)

Odziv

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

Serija TTS

Predložite več besedil za vzporedno TTS generacijo. Izbirno prejmete povratni klic na spletni strani, ko so vsa delovna mesta končana.

Parametri

Odziv

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

Raziskava napredka z GET /v1/tts/batch/rezult/?batch_id=abc123

Glasovno vgrajevanje

Predračunajte glasovno vgradnjo iz referenčnega zvoka. Uporabite vrnjeno embed_id v poznejših glasovnih zahtevah za kloniranje za skoraj instant generacijo.

Parametri

Odziv

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

Preverjanje zdravstvenega stanja

Preverite status strežnika GPU, naložene modele in velikost vrstice. Overitev ni potrebna. Odstranjen je 30 sekund.

Odziv

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

Seznam modelov

Vrne seznam vseh razpoložljivih modelov z njihovimi zmožnostmi.

Odziv

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

Seznam glasov

Vrne seznam vseh razpoložljivih glasov, neobvezno filtriranih po modelu ali jeziku.

Parametri poizvedbe

Odziv

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

Podnaslovi (SRT / VTT) novo

Ustvarjanje sinhroniziranih podnaslovov za vsako opravljeno nalogo TTS. Pogoni Whisper poravnavo preko zvoka in vrne SRT ali WebVTT. Rezultat je shranjevanje na disku, tako da je drugi klic za isti uuid je branje na disku.

Parametri poizvedbe

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

Izgovorni slovar novo

Povejte motorju TTS, kako izgovoriti specifične besede. Shranjeni vnosi samodejno uporabite na vsak zahtevek TTS, ki ga naredite. 200-vhodna meja na račun.

Telo zahtevka (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-..."

Prav tako lahko prenesete premostitve na zahtevo, ne da bi jih shranili – vključujejo odpovedi na vsakem /v1/tts/ klic kot objekt ali niz (glej parametre opazovanega dogodka TTS).