დოკუმენტაცია

საუბარი ტექსტადName

აუდიოს ტექსტად გადაწერა. მხარს უჭერს 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"
    }
  ]
}

ხმის კლონირებაName

საუბრის გენერირება კლონირებულ ხმაში. რეფერენტული აუდიო და ტექსტის ჩატვირთვა.

მოთხოვნის სხეული (multipart/form-data)

პასუხი

აუდიო ფაილის დაბრუნება როგორც ბინა მონაცემი, იგივე, რაც TTS- ის დასასრული.

ხმის შეცვლაName

აუდიოს კონვერტაცია სხვა ხმის მსგავსად. ატვირთეთ წყაროს აუდიო და აირჩიეთ მიზნობრივი ხმა.

მოთხოვნის სხეული (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

პასუხი

აუდიო ფაილის გადამუშავება ბინარული მონაცემებად.

საუბრის თარგმნაName

საუბრის აუდიოს თარგმნა ერთი ენიდან მეორეზე. ერთ ზარში ურთიერთქმედებს საუბარი-ტექსტი, თარგმნა და საუბარი-ტექსტი. Name

მოთხოვნის სხეული (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
}

საუბარიდან საუბარშიName

საუბრის სტილის, ემოციის ან წარმოთქმის შეცვლა, შინაარსის შენარჩუნების პირობებში. სასარგებლოა ტონის, ტემპის და გამოხატვის პარამეტრების შესაცვლელად.

მოთხოვნის სხეული (multipart/form-data)

პასუხი

აუდიო ფაილის გადამუშავება ბინარული მონაცემებად.

აუდიო ხელსაწყოებიName

Audio processing endpoints for enhancement, vocal removal, stem splitting და სხვა.

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

ხმაურიანი ჩატიName

აუდიო ან ტექსტის გაგზავნა და 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- ის პარალელური გენერირებისთვის. შესაძლებელია webhook- ის უკან დაკავშირების მიღება, როდესაც ყველა დავალება დასრულდება.

პარამეტრები

პასუხი

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

GET /v1/tts/batch/result/?batch_id=abc123-ის გამოყენებით კითხვის მიმდინარეობა

ხმოვანი ჩაშენებაName

წინასწარ გამოთვალეთ ხმოვანი ჩაბმა რეფერენციული აუდიოსგან. გამოიყენეთ დაბრუნებული embed_id ხმოვანი კლონების მომდევნო მოთხოვნებში, თითქმის მყისიერი გენერაციისთვის.

პარამეტრები

პასუხი

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

შენახული ხმები

ანგარიშზე შენახული კლონირებული ხმის ჩამონათვალი, მათ შორის public_id, რომელიც შემდეგი თაობის ხმის სახით გადაეცემა, და დაცული რეფერენციული აუდიოს URL. ასევე მიიღებს POST (multipart) - ს ხმის შესაქმნელად და DELETE? public_id=uv_xxx - ს ხმის წასასვლელად.

პასუხი

{
  "voices": [
    {
      "public_id": "uv_30d109336d05",
      "name": "My Voice",
      "model_name": "chatterbox",
      "voice_id": "",
      "preview_url": "https://tts.ai/media/user-voices/....wav",
      "reference_audio_url": "https://tts.ai/media/user-voices/....wav",
      "storage_status": "active"
    }
  ],
  "quota": { "setup_chars": 500, "per_use_chars": 50 }
}

2001 წელს გამოვიდა მისი პირველი ალბომი, სახელწოდებით „The Voice“, რომელიც შეიცავს სიმღერებს „The Voice of the U.S.A.“ და „The Voice of the U.S.A.“.

ჯანმრთელობის შემოწმება

GPU სერვერის სტატუსის, ჩატვირთული მოდელის და რიგის ზომის შემოწმება. ავთენტიფიკაცია არ არის საჭირო. 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
    }
  ]
}

ხმების სია

ყველა ხელმისაწვდომი ხმების სია, მოდელის ან ენის მიხედვით ფილტრით. 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
}

სუბტიტრები (SRT / VTT) ახალი

ნებისმიერი დასრულებული TTS დავალების სინქრონული სუბტიტრების შექმნა. Whisper- ის აუდიოს გასწორების დასრულება და SRT ან WebVTT- ს დაბრუნება. შედეგი დაცულია დისკზე, ასე რომ იგივე uuid- ის მეორე გამოძახება იქნება დისკზე წაკითხვა.

პარამეტრები

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

გამოთქმის ლექსიკონიName ახალი

TTS- ს ინდიკატორი, თუ როგორ უნდა გამოთქმულ იქნას სპეციფიკური სიტყვები. შენახული ჩანაწერები ავტომატურად იმოქმედებს ყველა TTS მოთხოვნაზე, რომელსაც თქვენ გააკეთებთ. 200 ჩანაწერის ლიმიტი ანგარიშზე.

მოთხოვნის სხეული (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-..."

1999 წელს გამოვიდა მისი პირველი ალბომი, სახელწოდებით „The Way You Make Me Feel“ (რომელიც შეიცავს სიმღერებს „I'm a Slave 2 U“ და „I'm a Slave 2 U“).

სტატიის მკითხველიComment ახალი

ნებისმიერი სტატიის გვერდზე ერთი < code>< script> ჭდეების დაყენებისას, ვიზიტორებს ფიქსირებული მკითხველის პანელი ექნებათ, რომელიც გვერდის დაჭერით საუბრობს. სტატიის შიგთავსის ავტომატური აღმოჩენა, მხარს უჭერს ინდივიდუალურ ხმას / მოდელს / პოზიციას / აქცენტის ფერს.

<script src="https://tts.ai/narrator.js"
    data-pk="pk-tts-your-publishable-key"
    data-voice="af_bella"
    data-model="kokoro"
    data-extract="auto"
    data-position="bottom"
    data-color="#e60000"
    data-locale="en"></script>

პარამეტრები

GitHub-ზე:

• 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/voice-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/voice-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 field.

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

ვებსაიტები

გრძელვადიანი დავალებებისთვის (root-ის გაყოფა, batch 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"
}