Python Metinden Sese API Eğitimi (2026): Audexum Hızlı Başlangıç Rehberi
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.
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.
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:
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ı:
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 femaleBu 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:
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:
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 NoneDurum Kodları Başvurusu
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:
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 resultsFiyatlandı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:
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
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.
- İlgili içerikler: 2026'da en ucuz metinden sese API
- İlgili içerikler: Ücretsiz katmanı olan ElevenLabs alternatifi
- İlgili içerikler: Discord botları için TTS API
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?