Учебник по Text to Speech API на Python (2026): краткое руководство по работе с Audexum
Узнайте, как вызвать API преобразования текста в речь на Python с помощью библиотеки requests. Полные примеры кода для выбора голоса, сохранения в WAV, обработки ошибок и сравнения цен.
Интеграция синтеза речи в проект на Python занимает менее 20 строк кода. В этом руководстве рассматривается всё: аутентификация, выбор голоса, сохранение WAV-файла, обработка ошибок и выбор подходящего тарифа по объёму использования.
Все примеры используют Audexum TTS API, который поддерживает 43 голоса на 32 языках и предлагает бесплатный тариф без необходимости в банковской карте.
Предварительные требования
Вам понадобится только библиотека requests . Никаких SDK и фреймворков.
pip install requestsПолучите бесплатный API-ключ на audexum.com/signup. Ключи имеют формат sk_live_abc123xyz. Бесплатный тариф включает 2,000 бесплатных кредитов + 250 в день без необходимости в банковской карте.
Первый вызов API
Эндпоинт принимает JSON-тело с полем text, voice_idи при необходимости language. В ответ он возвращает необработанный аудиофайл WAV.
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}")Запустите код, и вы получите output.wav в текущем каталоге. Это полностью рабочая реализация.
Выбор голоса
Audexum предлагает 43 голоса на американском английском, британском английском, испанском, французском, немецком, японском, корейском, арабском, хинди, болгарском, итальянском, португальском и других языках. Получите список доступных голосов с помощью GET-запроса:
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']}")Пример результата:
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Передайте строку voice_id непосредственно в запросе синтеза.
Сохранение WAV-файла
Тело ответа — это необработанный PCM WAV: base64 декодировать не нужно. Запишите его на диск стандартным файловым вводом-выводом:
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 вам нужен MP3, передайте "format": "mp3" в JSON-теле.
Обработка ошибок
Явно обрабатывайте ограничения частоты запросов, недопустимые голоса и ошибки аутентификации:
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Справочник кодов состояния
Пакетная обработка
При пакетной обработке строк соблюдайте ограничение частоты запросов, добавляя небольшую задержку между запросами:
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Сравнение тарифов
Прежде чем выбрать тариф, ознакомьтесь со сравнением основных TTS API по стоимости одного символа:
Подписчики тарифов Audexum получают эффективные цены от €9.93/1M (Business) до €24.17/1M (Pro). Вариант PAYG по цене €28/1M кредитов подходит для проектов с непредсказуемым объёмом использования, а одноразовые пакеты кредитов никогда не сгорают.
Краткий обзор тарифов
Следующие шаги
Полная реализация на Python занимает менее 30 строк. Бесплатного тарифа достаточно, чтобы создать и протестировать полноценную интеграцию до того, как вы потратите деньги.
Получите свой API-ключ на audexum.com/signup и ознакомьтесь с Справочник API для полного списка параметров, включая настройки скорости, высоты тона и формата вывода.
- Связанное: Самый дешёвый API синтеза речи в 2026
- Связанное: Альтернатива ElevenLabs с бесплатным тарифом
- Связанное: API синтеза речи для Discord-ботов
Автор — Petar, основатель Audexum. Развивая TTS SaaS без внешних инвестиций, получаешь чёткие представления о проектировании API.
Got any questions left?
Поделиться отзывом
Была ли эта статья полезна?