@ action

QFileDialog

Duk tambayoyin API suna buƙatar tabbatarwa ta hanyar wata alama ta mai ɗauka a cikin Authorization header.

Authorization: Bearer sk-tts-your-api-key-here

KCharselect unicode block name

SDKs na ofishinari suna sauki don haɗa TTS.ai cikin aikace-aikacen ku. Dukkansu suna da ma'ana mai budewa kuma suna da samuwa a GitHub.

pip install ttsai

from tts_ai import TTSClient

client = TTSClient(api_key="sk-tts-...")
audio = client.generate(
    text="Hello world!",
    model="kokoro"
)
client.save(audio, "output.wav")

npm install @ttsainpm/ttsai

const { TTSClient } = require('@ttsainpm/ttsai');

const client = new TTSClient({
  apiKey: 'sk-tts-...'
});
const audio = await client.generate({
  input: 'Hello world!',
  model: 'kokoro'
});
await client.saveToFile(audio, 'output.wav');

URL na Tushe

Dukkan maɓallan ƙarshe suna dangantacce ga wannan URL na asali. Misali, maɓallin ƙarshe na TTS shine:

QDialogButtonBox

API rate limits vary by plan:

An haɗa ƙayyadaddun ƙayyadaddun ƙayyadaddun cikin kowane amsa: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

QFileDialog

@ action

@ action

QDialogButtonBox

QDialogButtonBox

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 from TTS.ai! This is a test.",
    "voice": "af_bella",
    "format": "mp3"
  }' \
  --output output.mp3

Mawallafi

Mai mayar da fayil ɗin sauti kamar bayanan binary tare da Content-Type mai dacewa (audio/mpeg, audio/wav, da dai sauransu).

Content-Type: audio/mpeg
Content-Length: 48256
X-Credits-Used: 2
X-Credits-Remaining: 498

QShortcut

Fassara sauti zuwa rubutu. Yana goyon bayan harsuna 99 tare da ganewa-da-kanka.

QDialogButtonBox (multipart/form-data)

Mawallafi

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

QShortcut

Create speech in a cloned voice. Upload a reference audio and text.

QDialogButtonBox (multipart/form-data)

Mawallafi

Mai mayar da fayil ɗin sauti kamar bayanan binary, kamar na ƙarshen TTS.

Mai Sauya Sauti

Canja sauti don ya yi kama da wani sauti daban. Karɓi sauti na asali kuma ka zaɓi sauti na manufa.

QDialogButtonBox (multipart/form-data)

QDialogButtonBox

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

Mawallafi

QFileDialog

QFontDatabase

Fassara sauti da aka faɗa daga harshe daya zuwa wani. Yana haɗa magana zuwa rubutu, fassara, da rubutu zuwa magana cikin kira ɗaya.

QDialogButtonBox (multipart/form-data)

Mawallafi

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

QShortcut

@ action

QDialogButtonBox (multipart/form-data)

Mawallafi

QFileDialog

@ item: inlistbox

Wuraren ƙarshe na sarrafa sauti don haɓakawa, cire sauti, raba ƙwaƙwalwa, da dai sauransu.

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

QDialogButtonBox

Aika sauti ko rubutu kuma ka karɓi amsa daga AI tare da maganar synthesized.

QDialogButtonBox (multipart/form-data ko JSON)

Mawallafi

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

QShortcut

QDialogButtonBox

Parameters

Mawallafi

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

Tallafin ci gaba da GET /v1/tts/batch/result/?batch_id=abc123

KCharselect unicode block name

Yi ƙididdiga na gaba na ƙona sauti daga maɓallin sauti. Yi amfani da embed_id da aka mayar a cikin tambayoyin ƙona sauti na gaba domin samar da sauti cikin lokaci.

Parameters

Mawallafi

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

QSoftKeyManager

Binciki halin mai masaukin GPU, nau'ikan da aka loda, da girman jerin gwano. Babu bukatar shaida. An adana a cikin ajiya na sakan 30.

Mawallafi

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

@ action

QDialogButtonBox

Mawallafi

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

QShortcut

@ action

@ action

Mawallafi

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

@ action

• 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

QDialogButtonBox

Duk kurakurai suna mayar da amsa JSON da error & Mawallafi

{
  "error": {
    "code": "insufficient_credits",
    "message": "You do not have enough characters for this request.",
    "characters_required": 4000,
    "characters_available": 2000
  }
}

Webhooks

Ga ayyuka masu tafiyar da lokaci mai tsawo (tsaye-tsaye na ƙuƙumi, TTS na bangare-bangare), zaka iya bayar da wani webhook_url paramita. Lokacin da aikin ya ƙare, za mu POST sakamakon zuwa URL ɗinka.

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