MMashaGPT API
К обзору модели

API-документация

Подробное подключение Task API для ElevenLabs TTS V3

API-документация

Эндпоинт

Базовый URLhttps://api.mashagpt.ru/v1
Эндпоинт
POST
/v1/tasks/elevenlabs-tts-v3
Авторизация
x-api-key: YOUR_API_KEY
илиAuthorization: Bearer YOUR_API_KEY

Параметры запроса

ПараметрТипОписание
text*
stringText to convert to speech (max 5000 characters). Пример — Hello, this is a text to speech demo..
voice
stringДопустимые значения: Rachel, Drew, Clyde, Paul, Aria, Domi, Dave, Roger, Fin, Sarah, James, Jane, Juniper, Arabella, Hope, Bradford, Reginald, Gaming, Austin, Kuon, Blondie, Priyanka, Alexandra, Monika, Mark, Grimblewood. Voice preset to use. По умолчанию — Rachel.
stability
numberVoice stability (0-1). Диапазон 0–1. По умолчанию — 0.5.
similarityBoost
numberSimilarity boost (0-1). Диапазон 0–1. По умолчанию — 0.75.
style
numberStyle exaggeration (0-1). Диапазон 0–1. По умолчанию — 0.
speed
numberPlayback speed (0.7-1.2). Диапазон 0.7–1.2. По умолчанию — 1.
previousText
stringPrevious text for continuity (max 5000 characters).
nextText
stringNext text for anticipatory context (max 5000 characters).
languageCode
stringLanguage code (e.g. 'en', 'es', 'fr'). Пример — en.

Пример запроса и ответа

Запрос
curl -X POST https://api.mashagpt.ru/v1/tasks/elevenlabs-tts-v3 \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "text": "Hello, this is a text to speech demo.",
  "voice": "Rachel",
  "stability": 0.5,
  "similarityBoost": 0.75,
  "style": 0,
  "speed": 1
}'
Ответ
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "550e8400-e29b-41d4-a716-446655440000",
    "state": "queued"
  }
}

Асинхронная обработка

Модель работает асинхронно. После запроса вы получите taskId задачи для отслеживания статуса.

GET
/v1/tasks/{id}статус задачи
Проверка статуса задачи:
curl -X GET "https://api.mashagpt.ru/v1/tasks/{task_id}" \
  -H "x-api-key: YOUR_API_KEY"

Жизненный цикл задачи:

queued→processing→completed|failed