Краткое руководство по API TTS

Базовый URL и аутентификация

Начните с настройки клиента на указание нашего базового URL: https://api.ttsapihub.com/v1. Наш API полностью совместим с OpenAI, поэтому вы можете использовать стандартные SDK, просто обновив значение base_url и указав свой API-ключ. Аутентификация осуществляется через заголовок Authorization с токеном Bearer. Уникальный ключ вы генерируете при регистрации на странице получения API-ключа. На один аккаунт действует ограничение в один активный ключ, который вы можете перегенерировать в любое время. Ваши промпты не используются для обучения, а для начала работы с бесплатным пробным балансом не требуется ни номер телефона, ни кредитная карта.

Генерация текста через Chat Completions

Отправьте стандартный запрос POST /v1/chat/completions для генерации текста. Идентификатор модели для использования — uncensored. Эта модель — LLM с открытыми весами, настроенная на ответы без отказов по контенту для законного использования взрослыми, что делает её идеальной для творческих сценариев или диалогов, где корпоративные фильтры могут заблокировать ваш контент. Она не генерирует аудио, изображения или видео; она выводит чистый текст для обработки вашим конвейером TTS. Вы можете настроить параметры, такие как temperature и max_tokens, по мере необходимости. API поддерживает вызов функций для извлечения структурированных данных, позволяя форматировать ответы для вашего приложения.

Copycurl https://api.ttsapihub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Интеграция Python SDK

Для разработчиков на Python официальный SDK openai работает из коробки при минимальной настройке. Инициализируйте клиент, указав базовый URL и API-ключ, затем вызовите chat.completions.create(). Этот подход позволяет использовать существующие клиенты, совместимые с OpenAI, одновременно получая преимущества нашей модели без цензуры. В ответе содержится сгенерированный текст, который вы можете напрямую передать в движок синтеза речи. Помните, что это API только для текста, поэтому генерацию аудио вы обрабатываете отдельно в своем конвейере.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ttsapihub.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Интеграция Node SDK

Разработчики Node.js могут использовать пакет openai npm с той же конфигурацией, что и в Python. Установите значение baseURL на наш эндпоинт и укажите свой API-ключ. Вызовите эндпоинт завершений с идентификатором модели uncensored. Эта интеграция проста и позволяет напрямую подключить генерацию текста в ваши существующие TTS-сервисы на Node.js. API возвращает стандартный JSON, что упрощает его парсинг и обработку полученного текста для нужд вашего приложения.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ttsapihub.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потоковые ответы через SSE

Для снижения задержки включите потоковую передачу, установив stream: true в запросе. API возвращает события, отправляемые сервером (SSE), содержащие инкрементальные фрагменты текста. Это особенно полезно для генерации длинных текстов, так как пользователи видят текст в реальном времени. Потоковый ответ следует стандартному формату SSE OpenAI, поэтому вы можете использовать существующие парсеры потоков. Этот подход снижает воспринимаемое время ожидания и позволяет вашему приложению отображать текст по мере его генерации, улучшая пользовательский опыт для вашего конвейера TTS.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Лимиты, ошибки и контекстное окно

Ваш API-ключ ограничен 300 запросами в минуту и телом запроса размером 8 МБ. Модель поддерживает контекстное окно на 100 000 токенов, что позволяет работать с длинными сценариями или документами. Распространенные ошибки: 401 (неверный ключ), 402 (недостаточно средств) и 429 (превышен лимит запросов). Если вы достигли лимита, реализуйте экспоненциальное замедление. Цены прозрачны: $0,25 за 1 млн входных токенов и $1,00 за 1 млн выходных токенов. Баланс предоплаченный, не сгорает, пополнение начинается от $10. Новый аккаунт получает $0,50 пробного баланса, действительного в течение 7 дней, без необходимости привязки карты. Ограничения контента блокируют только сексуальный контент с участием несовершеннолетних; все остальные законные взрослые, вымышленные или спорные темы разрешены.