Tahirin-kevitra

Fanamarinana

Ny fangatahana API rehetra dia mila fanamarinana amin'ny alalan'ny token Bearer ao amin'ny Authorization loham-pejy.

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

URL fototra

Mifandraika amin'ity URL fototra ity avokoa ny endpoint rehetra. Ohatra, ny endpoint TTS dia:

Fetra amin'ny tahan'ny

Miovaova arakaraka ny drafitra ny fetra amin'ny tahan'ny API:

Ao anatin'ny valintenin'ny tsirairay ny loham-pejy momba ny fetrany: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Fandoavana trosa

Soratra mankany amin'ny feo

Manova ny lahabolana ho feo. Mamaly ny raki-peo amin'ny lamina takiana.

Ny vatan'ilay fangatahana

Fanontaniana ohatra

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

Valiny

Returns the audio file as binary data with appropriate Content-Type header (audio/mpeg, audio/wav, etc.).

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

Hanova teny ho lahabolana

Manova feo ho lasa lahabolana. Mandray an-tànana ny teny 99 miaraka amin'ny famantarana hoazy.

Ny vatan'ilay fangatahana (multipart/form-data)

Valiny

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

Fandraisana an-tsoratra feo

Mamorona kabary amin'ny alalan'ny feo nalaina. Akaro ny feo sy ny lahabolana voalaza.

Ny vatan'ilay fangatahana (multipart/form-data)

Valiny

Mamerina ny rakitra audio amin'ny endrika data binary, mitovy amin'ny farany TTS.

Mpanova feo

Manova ny feo ho toy ny feo hafa. Akaro ny feo loharano ary safidio ny feon'ny tanjona.

Ny vatan'ilay fangatahana (multipart/form-data)

Fanontaniana ohatra

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

Valiny

Mamerina ny rakitra audio nanovaina ho data binary.

Fandikan-teny

Adikao amin'ny teny iray mankany amin'ny teny iray hafa ny feo voalaza. Mitambatra amin'ny antso tokana ny fanehoana ny feo amin'ny soratra, ny fandikan-teny, ary ny fanehoana ny soratra amin'ny feo.

Ny vatan'ilay fangatahana (multipart/form-data)

Valiny

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

Teny amin'ny Teny

Manova ny fomba fitenenana, ny fihetseham-po, na ny fanehoana raha toa ka tsy miova ny votoaty. Manampy amin'ny fanatsarana ny feo, ny hafainganam-pandeha, ary ny fanehoana.

Ny vatan'ilay fangatahana (multipart/form-data)

Valiny

Mamerina ny rakitra audio nanovaina ho data binary.

Fitaovana audio

Fiandohan'ny fikarakarana ny feo ho an'ny fanatsarana, fanafoanana ny feo, fizarazarana ny fototra, ary maro hafa.

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

Resadresaka an-peo

Mandefa feo na soratra ary mahazo valinteny avy amin'ny AI miaraka amin'ny fitenenana novokarina.

Ny vatan'ilay fangatahana (multipart/form-data na JSON)

Valiny

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

Lisitry ny modely

Manome lisitr'ireo modely misy rehetra miaraka amin'ny fahaizany.

Valiny

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

Lisitry ny feo

Manome lisitr'ireo feo misy rehetra, azo sivana araka ny modely na ny teny.

Famaritana ny fanontaniana

Valiny

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

Ohatran'ny soratra

• 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

Famaha tsy fetezana

Ny tsy fetezana rehetra dia mamoaka valinteny JSON misy error field.

{
  "error": {
    "code": "insufficient_credits",
    "message": "You do not have enough credits for this request.",
    "credits_required": 4,
    "credits_available": 2
  }
}

Webhooks

Ho an'ny asa maharitra (fizarazarana fototra, batch TTS), dia afaka manome tsindry webhook_url ianao. Rehefa vita ilay asa, dia handefa ny vokatra any amin'ny URL-nao izahay.

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