API দস্তাবেজ

প্ৰমাণীকৰণ

সকলো API অনুৰোধৰ বাবে এটা Bearer টোকেনৰ দ্বাৰা প্ৰমাণীকৰণৰ প্ৰয়োজন Authorization হেডাৰ.

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

ভিত্তি URL

সকলো অন্তবিন্দু এই ভিত্তি URL ৰ সাপেক্ষে। উদাহৰণস্বৰূপ, TTS অন্তবিন্দু হ'ল:

হাৰ সীমা

API ৰ হাৰ সীমা প্ল্যান অনুযায়ী সলনি হয়:

প্ৰতিটো প্ৰতিক্ৰিয়াত হাৰ সীমা হেডাৰ অন্তৰ্ভুক্ত কৰা হয়: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

ঋণ ব্যয়

টেক্সট-টু-স্পীচName

টেক্সটক কথোপকথনৰ অডিঅ'লৈ ৰূপান্তৰ কৰক । অনুৰোধ কৰা বিন্যাসত অডিঅ' ফাইল ঘুৰাই দিয়ে ।

অনুৰোধৰ মূল অংশ

উদাহৰণ অনুৰোধ

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

কথাৰ পৰা লিপিলৈName

অডিঅ'ক টেক্সটলৈ অনুবাদ কৰক। স্বয়ংক্ৰিয় অনুসন্ধানৰ সৈতে ৯৯টা ভাষা সমৰ্থন কৰে।

অনুৰোধৰ মূল অংশ (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
}

কথাৰ পৰা কথালৈName

বিষয়বস্তু সংৰক্ষণ কৰি কথাৰ শৈলী, অনুভূতি, অথবা উপস্থাপন পৰিবৰ্তন কৰক। টোন, পেচিং, আৰু অভিব্যক্তিৰ পৰিবৰ্তনৰ বাবে ব্যৱহাৰযোগ্য।

অনুৰোধৰ মূল অংশ (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
    }
  ]
}

শব্দ তালিকাভুক্ত কৰক

সকলো উপলব্ধ শব্দৰ তালিকা প্ৰদান কৰে, আৰ্হি অথবা ভাষা অনুযায়ী বৈকল্পিকভাৱে ফিল্টাৰ কৰা হয়।

প্ৰশ্ন প্ৰাচলসমূহ

প্ৰতিক্ৰিয়া

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

ৱেবহুকসমূহ

দীৰ্ঘমেয়াদী কাৰ্য্যসমূহৰ বাবে (stem splitting, batch TTS), আপুনি এটা webhook_url প্ৰাচল প্ৰদান কৰিব পাৰিব। কাৰ্য্য সম্পূৰ্ণ হ'লে, আমি আপোনাৰ URL লৈ ফলাফল POST কৰিম।

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