Перейти к содержимому

Учебник по Text to Speech API на Python (2026): краткое руководство по работе с Audexum

Audexum8 минBy Petar

Узнайте, как вызвать API преобразования текста в речь на Python с помощью библиотеки requests. Полные примеры кода для выбора голоса, сохранения в WAV, обработки ошибок и сравнения цен.

Интеграция синтеза речи в проект на Python занимает менее 20 строк кода. В этом руководстве рассматривается всё: аутентификация, выбор голоса, сохранение WAV-файла, обработка ошибок и выбор подходящего тарифа по объёму использования.

Все примеры используют Audexum TTS API, который поддерживает 43 голоса на 32 языках и предлагает бесплатный тариф без необходимости в банковской карте.

Предварительные требования

Вам понадобится только библиотека requests . Никаких SDK и фреймворков.

bash
pip install requests

Получите бесплатный API-ключ на audexum.com/signup. Ключи имеют формат sk_live_abc123xyz. Бесплатный тариф включает 2,000 бесплатных кредитов + 250 в день без необходимости в банковской карте.

Первый вызов API

Эндпоинт принимает JSON-тело с полем text, voice_idи при необходимости language. В ответ он возвращает необработанный аудиофайл WAV.

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

Запустите код, и вы получите output.wav в текущем каталоге. Это полностью рабочая реализация.

Выбор голоса

Audexum предлагает 43 голоса на американском английском, британском английском, испанском, французском, немецком, японском, корейском, арабском, хинди, болгарском, итальянском, португальском и других языках. Получите список доступных голосов с помощью GET-запроса:

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']}")

Пример результата:

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

Передайте строку voice_id непосредственно в запросе синтеза.

Сохранение WAV-файла

Тело ответа — это необработанный PCM WAV: base64 декодировать не нужно. Запишите его на диск стандартным файловым вводом-выводом:

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 вам нужен MP3, передайте "format": "mp3" в JSON-теле.

Обработка ошибок

Явно обрабатывайте ограничения частоты запросов, недопустимые голоса и ошибки аутентификации:

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

Справочник кодов состояния

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

Пакетная обработка

При пакетной обработке строк соблюдайте ограничение частоты запросов, добавляя небольшую задержку между запросами:

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

Сравнение тарифов

Прежде чем выбрать тариф, ознакомьтесь со сравнением основных TTS API по стоимости одного символа:

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 получают эффективные цены от €9.93/1M (Business) до €24.17/1M (Pro). Вариант PAYG по цене €28/1M кредитов подходит для проектов с непредсказуемым объёмом использования, а одноразовые пакеты кредитов никогда не сгорают.

Краткий обзор тарифов

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

Следующие шаги

Полная реализация на Python занимает менее 30 строк. Бесплатного тарифа достаточно, чтобы создать и протестировать полноценную интеграцию до того, как вы потратите деньги.

Получите свой API-ключ на audexum.com/signup и ознакомьтесь с Справочник API для полного списка параметров, включая настройки скорости, высоты тона и формата вывода.


Автор — Petar, основатель Audexum. Развивая TTS SaaS без внешних инвестиций, получаешь чёткие представления о проектировании API.

Got any questions left?

Поделиться отзывом

Была ли эта статья полезна?

Следующая статьяМногоязычный API для синтеза речи: 33 языка через один REST endpoint (2026)

Начните бесплатно. Без карты.

2,000 кредитов для начала, 250 в день.