ሰነዶች

ማረጋገጫ

ሁሉንም API ጥያቄዎች በመጠባበቂያ ቶኬን በኩል ማረጋገጫን ይጠይቃሉ Authorization የገጽ አናት.

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

ሴኮንዶች

የመንግስት SDKs TTS.ai ወደ ፕሮግራምዎ ለማካተት ቀላል ያደርጋል. ሁለቱም የክፍል ምንጭ ናቸው እና 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

ሁሉም መጨረሻዎች ወደዚህ መሠረታዊ URL ጋር የተያያዙ ናቸው። ለምሳሌ፣ የ TTS መጨረሻው :

የፍጥነት ገደቦች

API የፍጥነት ገደቦች በፕላን ይለያያሉ:

የፍጥነት ገደብ ርዕሶች በእያንዳንዱ መልስ ውስጥ ይገኙበታል: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

የክሬዲት ዋጋ

ጽሑፉን ወደ ንግግር ለውጥ

ጽሑፉን ወደ ንግግር ድምፅ ይለውጡ. የድምፅ ፋይሉን በተጠየቀው ቅርጸት ይመልሳል

የጠየቀው አካል

ምሳሌ

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

መልስ

የድምፅ ፋይሉን በሁለት-አቅጣጫዊ መረጃ ከሚስማማ Content-Type አናት (audio/mpeg, audio/wav, ወዘተ.) ጋር ይመልሳል

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

ንግግር ወደ ጽሑፍ

ድምፅን ወደ ጽሑፍ ይለውጡ. 99 ቋንቋዎችን በራስ-ሰር ለይቶ ማወቅን ይደግፋል።

የጠየቀው አካል (multipart/form-data)

መልስ

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

የድምፅ ክሎኒንግ

ንግግርን በክሎነድ ድምፅ ውስጥ ይፈጥሩ. የመዝገብ ቤት ድምፅ እና ጽሑፍን ይጫኑ

የጠየቀው አካል (multipart/form-data)

መልስ

የድምፅ ፋይሉን እንደ ቢያንስ መረጃ ይመለሳል፣ እንደ TTS መጨረሻ ነጥብ ተመሳሳይ ነው።

የድምፅ መለወጫ

ድምጹን እንደ ሌላ ድምፅ እንዲሰማ ይለውጡ። የድምፅ ምንጭን ጫን እና የመጨረሻ ድምፅን ይምረጡ።

የጠየቀው አካል (multipart/form-data)

ምሳሌ

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

መልስ

የድምፅ ፋይሉን እንደገና ያስተካክላል

የንግግር ትርጉም

የተናገረውን ድምፅ ከአንድ ቋንቋ ወደ ሌላ ይተረጉሙ። ንግግር-ወደ-ጽሑፍ፣ ትርጉም፣ እና ጽሑፍ-ወደ-ንግግርን በአንድ ጥሪ ውስጥ ያቀላቅላል

የጠየቀው አካል (multipart/form-data)

መልስ

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

ንግግር ወደ ንግግር

የንግግር ዘይቤን፣ ስሜትን ወይም ይዘትን በማስቀመጥ ላይ ማስተካከል። ለድምፅ፣ ለፍጥነት እና ለግልጽነት ማስተካከል ጠቃሚ ነው።

የጠየቀው አካል (multipart/form-data)

መልስ

የድምፅ ፋይሉን እንደገና ያስተካክላል

የድምፅ መሣሪያዎች

የድምፅ ማቀነባበሪያ መጨረሻ ነጥቦችን ለማሻሻል, የድምፅ ማስወገድ, ቅርንጫፍ መክፈል, እና ሌሎችም.

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

የድምፅ ውይይት

የድምፅ ወይም የጽሑፍ መልዕክት መላክ እና የተቀናጀ ንግግር ጋር AI መልስ ማግኘት.

የጠየቀው አካል (multipart/form-data ወይም JSON)

መልስ

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

ቡት TTS

ለተቃራኒ TTS ማምረት ብዙ ጽሑፎችን ያቅርቡ. ሁሉም ስራዎች ከተፈጸሙ በኋላ የዌብሆክ ጥሪን ተቀበሉ

መለኪያዎች

መልስ

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

የምርጫው ሂደት /v1/tts/batch/result/?batch_id=abc123 ጋር GET

የድምፅ መተካት

ከመዝገብ ቤት ውስጥ የድምፅ መተካት ይጫኑ

መለኪያዎች

መልስ

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

የጤና ምርመራ

የጂፒዩ ሰርቨር ሁኔታን፣ የተጫኑ ሞዴሎችን፣ የፍተሻ መጠንን ይመልከቱ። ምንም ማረጋገጫ አይጠበቅም። ለ30 ሰከንዶች ተደብቋል

መልስ

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

ሞዴሎችን ዝርዝር

ሁሉንም የተገኙ ሞዴሎችን በችሎቶቻቸው ዝርዝር ይመልሳል

መልስ

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

የድምፅ ዝርዝር

ሁሉንም የተገኙ ድምጾች ዝርዝር ይመለሳል፣ በሞዴል ወይም በቋንቋ ሊመረመር ይችላል።

የጥያቄው መለኪያዎች

መልስ

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

ምሳሌዎች

• 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

ስህተት ኮዶች

ሁሉንም ስህተቶች በ JSON መልስ ጋር ይመልሳል error ፋይል

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

ዌብሆክስ

ለረጅም ጊዜ የሚሠሩ ስራዎች (የስቴም ክፍፍል፣ የባች ቲቲኤስ) webhook_url ፓራሜትር መስጠት ይችላሉ። ስራው ከተጠናቀቀ በኋላ ውጤቱን ወደ ዩ.አር.ኤል.ዎ እናስገባለን።

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