BlooTube Voice Public API v1

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

Ключевые преимущества:

• Сверхдлинные тексты: до 600 000 символов (PRO) и до 1 200 000 символов (ULTRA) в одной задаче.
• BlooTube Voice Markup (Beta): встроенный XML-синтаксис для фрагментной динамики (скорость, громкость, эмоции, паузы, смех).
• Студийный звук: экспорт в стандартный MP3 44.1 кГц / 128 кбит/с с хранением 5 часов.
• Гарантия сохранности квоты: Повторные запросы, ошибки и отмены защищены от двойного списания символов.

2. Аутентификация и безопасность

Каждый запрос к API должен содержать секретный ключ разработчика в заголовке Authorization:

Authorization: Bearer btv_live_YOUR_SECRET_API_KEY

Храните ваши ключи только на сервере. В личном кабинете Mini App доступна генерация и мгновенный отзыв скомпрометированных токенов.

3. Возможности движка (GET /capabilities)

Возвращает актуальную спецификацию регуляторов речи и возможностей студии:

curl -X GET "https://api.apexcorelink.org/voice/api/v1/capabilities" \
  -H "Authorization: Bearer btv_live_YOUR_API_KEY"

4. Профиль и состояние квоты (GET /me и GET /usage)

Эндпоинт GET /me возвращает детальные данные лицензии, суточный остаток квоты и лимиты аккаунта:

curl -X GET "https://api.apexcorelink.org/voice/api/v1/me" \
  -H "Authorization: Bearer btv_live_YOUR_API_KEY"

Суточная квота обновляется автоматически каждый день в 00:00 UTC. Для быстрой проверки расхода используйте GET /usage.

5. Каталог дикторов (GET /voices и GET /voices/{voice_id})

Каталог включает студийные нейроголоса и все готовые публичные клоны:

curl -X GET "https://api.apexcorelink.org/voice/api/v1/voices?language=ru&gender=male" \
  -H "Authorization: Bearer btv_live_YOUR_API_KEY"

6. Создание задачи озвучки (POST /tasks)

Принимает текст для нейросинтеза речи. Поддерживает защиту от дублирующих списаний по Idempotency-Key:

curl -X POST "https://api.apexcorelink.org/voice/api/v1/tasks" \
  -H "Authorization: Bearer btv_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-run-001" \
  -d '{{
    "voice_id": "VOICE_ID_FROM_CATALOG",
    "text": "Здравствуйте! Это демонстрация профессиональной нейроозвучки BlooTube Voice.",
    "speed": 1.0,
    "volume": 1.0,
    "dsp_speed": 1.0,
    "emotion": null
  }}'

7. BlooTube Voice Markup (Beta)

Встроенный XML-синтаксис для фрагментной динамики:

Внимание! <speed val="1.1"><emotion val="excited">Отличные новости!</emotion></speed>
<break time="500ms"/>
Мы обновили возможности студии. <volume val="0.8">Звук звучит великолепно.</volume>

8. Жизненный цикл, прогресс и скачивание MP3

Опрос статуса выполнения задачи по GET /tasks/{task_id}:

curl -X GET "https://api.apexcorelink.org/voice/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer btv_live_YOUR_API_KEY"

Скачивание готового MP3 файла: GET /tasks/{task_id}/download. Срок хранения файла на сервере составляет 5 часов с момента завершения синтеза.

9. Список задач (GET /tasks)

Просмотр истории задач вашего аккаунта с пагинацией и фильтрами по статусу (queued, processing, completed, failed, cancelled):

curl -X GET "https://api.apexcorelink.org/voice/api/v1/tasks?status=completed&limit=20&offset=0" \
  -H "Authorization: Bearer btv_live_YOUR_API_KEY"

10. Клонирование голоса (POST /clones)

Создание персонального нейроклона по аудиозаписи голоса от 5 до 30 секунд:

curl -X POST "https://api.apexcorelink.org/voice/api/v1/clones" \
  -H "Authorization: Bearer btv_live_YOUR_API_KEY" \
  -F "sample_file=@voice_sample.wav" \
  -F "name=Студийный Голос Диктора" \
  -F "gender=male"

Публичный каталог: После успешного создания голос автоматически публикуется в общем каталоге BlooTube Voice и становится доступен другим пользователям сервиса для синтеза.

Лимиты слотов: тариф PRO STUDIO — 1 слот; тариф ULTRA VIP — 3 слота.

11. Словари произношения (/pronunciation-dictionaries)

Словари позволяют автоматически заменять сложные термины и аббревиатуры на фонетическую транскрипцию:

curl -X POST "https://api.apexcorelink.org/voice/api/v1/pronunciation-dictionaries" \
  -H "Authorization: Bearer btv_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{{
    "name": "IT Термины",
    "entries": [
      {{ "text": "PostgreSQL", "phonemes": "постгрэс кью эл", "case_sensitive": false, "alphabet": "sounds-like" }}
    ]
  }}'

12. Лимиты частоты запросов (Rate Limits)

13. Справочник ошибок и коды HTTP

14. Примеры интеграции (Workflows)

Скрипт на Python:

import time, requests

API_KEY = "btv_live_YOUR_API_KEY"
BASE = "https://api.apexcorelink.org/voice/api/v1"
HEADERS = {{"Authorization": f"Bearer {{API_KEY}}"}}

# 1. Отправка задачи
res = requests.post(f"{{BASE}}/tasks", headers=HEADERS, json={{
    "voice_id": "VOICE_ID_FROM_CATALOG",
    "text": "Привет! Это озвучка через официальный API BlooTube Voice."
}}).json()
task_id = res["task_id"]

# 2. Ожидание готовности
while True:
    st = requests.get(f"{{BASE}}/tasks/{{task_id}}", headers=HEADERS).json()
    if st["status"] == "completed":
        break
    time.sleep(1.5)

# 3. Скачивание аудио
audio = requests.get(f"{{BASE}}/tasks/{{task_id}}/download", headers=HEADERS)
with open("result.mp3", "wb") as f:
    f.write(audio.content)
print("MP3 успешно сохранён!")

15. Версионирование

v1.0.0 (2026-09-19): Стабильный релиз API v1. Канонические диапазоны: speed [0.6, 1.5], volume [0.5, 2.0], dsp_speed [1.0, 2.0]. 7 утверждённых эмоций. Markup Beta. Защита от повторных списаний. Срок хранения MP3: 5 часов.