İçeriğe geç

Python Metinden Sese API Eğitimi (2026): Audexum Hızlı Başlangıç Rehberi

Audexum8 dkBy Petar

requests kütüphanesini kullanarak Python’da bir metinden sese API’sini nasıl çağıracağını öğren. Ses seçimi, WAV çıktısı, hata yönetimi ve fiyat karşılaştırması için eksiksiz kod örnekleri.

Metinden sese özelliğini bir Python projesine entegre etmek 20 satırdan az kod gerektirir. Bu rehber her şeyi adım adım anlatıyor: kimlik doğrulama, ses seçme, WAV çıktısını kaydetme, hataları yönetme ve kullanımına uygun planı seçme.

Tüm örnekler Audexum TTS API’sininkullanır; bu model 32 dilde 43 ses sunar ve kredi kartı gerektirmeyen ücretsiz bir katmana sahiptir.

Ön koşullar

Yalnızca requests kitaplığına ihtiyacın var. SDK ya da framework gerekmez.

bash
pip install requests

Ücretsiz API anahtarını al: audexum.com/signup. Anahtarlar şu biçimi izler: sk_live_abc123xyz. Ücretsiz plan; kredi kartı gerektirmeden 2.000 ücretsiz kredi + günlük 250 kredi verir.

İlk API Çağrısı

Uç nokta, içinde text, voice_idbulunan ve isteğe bağlı olarak languagealanı içeren bir JSON gövdesi kabul eder. Ham WAV ses dosyası döndürür.

python
import requests

API_KEY = "sk_live_abc123xyz"
API_URL = "https://audexum.com/api/v1/tts"

response = requests.post(
    API_URL,
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "text": "Hello, this is a test of the Audexum text-to-speech API.",
        "voice_id": "en_us_female_01",
    },
)

if response.status_code == 200:
    with open("output.wav", "wb") as f:
        f.write(response.content)
    print("Saved output.wav")
else:
    print(f"Error {response.status_code}: {response.text}")

Çalıştırdığında output.wav dosyasını geçerli dizine alırsın. Çalışan uygulamanın tamamı budur.

Ses Seçme

Audexum; Amerikan İngilizcesi, Britanya İngilizcesi, İspanyolca, Fransızca, Almanca, Japonca, Korece, Arapça, Hintçe, Bulgarca, İtalyanca, Portekizce ve daha fazlasında 43 ses sunar. Kullanılabilir sesleri bir GET isteğiyle listele:

python
import requests

API_KEY = "sk_live_abc123xyz"

voices = requests.get(
    "https://audexum.com/api/v1/voices",
    headers={"Authorization": f"Bearer {API_KEY}"},
).json()

for voice in voices:
    print(f"{voice['voice_id']:30s} {voice['language']:10s} {voice['gender']}")

Örnek çıktı:

text
en_us_female_01                en-US      female
en_us_male_01                  en-US      male
en_gb_female_01                en-GB      female
de_female_01                   de         female
ja_female_01                   ja         female

Bu voice_id dizisini doğrudan sentez isteğinde kullanabilirsin.

WAV Dosyasını Kaydetme

Yanıt gövdesi ham PCM WAV'dir: base64 çözümlemeye gerek yoktur. Standart dosya G/Ç ile diske yazın:

python
import requests
from pathlib import Path

def synthesize(text: str, voice_id: str, output_path: str, api_key: str) -> Path:
    response = requests.post(
        "https://audexum.com/api/v1/tts",
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json",
        },
        json={"text": text, "voice_id": voice_id},
    )
    response.raise_for_status()
    path = Path(output_path)
    path.write_bytes(response.content)
    return path

# Usage
output = synthesize(
    text="Welcome to our application.",
    voice_id="en_us_female_01",
    output_path="welcome.wav",
    api_key="sk_live_abc123xyz",
)
print(f"Audio saved to {output} ({output.stat().st_size} bytes)")

WAV yerine MP3 gerekiyorsa JSON gövdesine "format": "mp3" değerini ekle.

Hata Yönetimi

Hız sınırlarını, geçersiz sesleri ve kimlik doğrulama hatalarını açıkça yönet:

python
import requests
from requests.exceptions import RequestException

def safe_synthesize(text: str, voice_id: str, api_key: str) -> bytes | None:
    try:
        response = requests.post(
            "https://audexum.com/api/v1/tts",
            headers={
                "Authorization": f"Bearer {api_key}",
                "Content-Type": "application/json",
            },
            json={"text": text, "voice_id": voice_id},
            timeout=30,
        )

        if response.status_code == 401:
            raise ValueError("Invalid API key. Check your sk_live_ token.")

        if response.status_code == 402:
            raise RuntimeError("Character quota exceeded. Upgrade your plan or wait for reset.")

        if response.status_code == 422:
            raise ValueError(f"Invalid request: {response.json().get('detail')}")

        response.raise_for_status()
        return response.content

    except RequestException as e:
        print(f"Network error: {e}")
        return None

Durum Kodları Başvurusu

CodeMeaningAction
200SuccessWrite response body to file
401Bad API keyCheck the Authorization header
402Quota exceededUpgrade plan or wait for monthly reset
422Bad request bodyCheck voice_id and text fields
429Rate limitedRetry with exponential backoff
500Server errorRetry once, then contact support

Toplu İşleme

Dizeleri toplu işlerken istekler arasına kısa bir gecikme bırakarak hız sınırının altında kal:

python
import time
import requests
from pathlib import Path

def batch_synthesize(items: list[dict], api_key: str, delay: float = 0.2):
    """
    items: [{"text": "...", "voice_id": "...", "output": "file.wav"}, ...]
    """
    results = []
    for item in items:
        response = requests.post(
            "https://audexum.com/api/v1/tts",
            headers={"Authorization": f"Bearer {api_key}"},
            json={"text": item["text"], "voice_id": item["voice_id"]},
        )
        if response.ok:
            Path(item["output"]).write_bytes(response.content)
            results.append({"file": item["output"], "status": "ok"})
        else:
            results.append({"file": item["output"], "status": response.status_code})
        time.sleep(delay)
    return results

Fiyatlandırma Karşılaştırması

Bir plana karar vermeden önce büyük TTS API'lerinin karakter başına fiyatlarının nasıl karşılaştırıldığını gör:

ProviderFree TierPaid EntryCost per 1M charsCard Required for Free
Audexum2K to start€29 / 1.2M~€28.00 (PAYG)No
ElevenLabs10K credits/mo$6 / 30K~$165–$200Yes (some plans)
OpenAI TTSNonePay-as-you-go~$15Yes
Google Cloud TTS4M standard + 1M WaveNet/moPay-as-you-go$4 standard / $16 WaveNetYes

Audexum plan aboneleri, Business için 1M/€9,93'ten Pro için 1M/€24,17'ye kadar avantajlı oranlar kullanır. 1M kredi için €28 olan kullandıkça öde seçeneği, hacmi öngörülemeyen projeler için kullanışlıdır ve tek seferlik kredi paketlerinin süresi hiç bitmez.

Plan Özeti

PlanCredits/moPriceBest For
Free2,000 + 250/day€0Prototypes, testing
Pro1,200,000€29Production apps
Scale4,000,000€49High-volume pipelines
Credit packs250,000 to 3,500,000, never expirefrom €7Bursty or unpredictable load

Sonraki Adımlar

Eksiksiz Python uygulaması 30 satırın altında sığar. Ücretsiz katman, herhangi bir ödeme yapmadan önce eksiksiz bir entegrasyonu geliştirmen ve test etmen için yeterlidir.

API anahtarını al: audexum.com/signup ve API referansı hız, perde ve çıktı biçimi denetimleri dâhil tüm parametrelerin tam listesi için dokümantasyonu incele.


Audexum'un kurucusu Petar tarafından. Kendi sermayesiyle ayakta duran bir TTS SaaS işletmek, API tasarımı hakkında güçlü fikirlere sahip olmanı sağlıyor.

Got any questions left?

Geri bildirim paylaş

Bu makale faydalı oldu mu?

Sonraki yazıÇok Dilli Metinden Sese API’si: Tek REST Uç Noktasıyla 33 Dil (2026)

Ücretsiz başlayın. Kart yok.

2,000 başlangıç kredisi, 250 her gün daha fazlası.