Τεκμηρίωση API

Ταυτοποίηση

Όλες οι αιτήσεις API απαιτούν εξακρίβωση ταυτότητας μέσω ενός σήματος Bearer στο Authorization κεφαλίδα.

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

URL βάσηςName

Όλα τα τελικά σημεία είναι σχετικά με αυτό το 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

Απάντηση

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

Ομιλία προς κείμενο

Υποστηρίζει 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
}

Μοντέλα λίστας

Επιστρέφει μια λίστα με όλα τα διαθέσιμα μοντέλα με τις δυνατότητές τους.

Απάντηση

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

Φωνές λίσταςName

Επιστρέφει μια λίστα με όλες τις διαθέσιμες φωνές, προαιρετικά φιλτραρισμένο από το μοντέλο ή τη γλώσσα.

Παράμετροι ερωτήσεων

Απάντηση

{
  "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 credits for this request.",
    "credits_required": 4,
    "credits_available": 2
  }
}

ΓουέμπγουκςCity name (optional, probably does not need a translation)

Για εργασίες μεγάλης διάρκειας (split stem, TTS παρτίδα), μπορείτε να παρέχετε μια παράμετρο webhook_url. Όταν ολοκληρωθεί η εργασία, θα μετακινήσουμε το αποτέλεσμα στο 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"
}