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

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

Подробное подключение Task API для ElevenLabs Sound Effect V2

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

Эндпоинт

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

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

ПараметрТипОписание
text*
stringText describing the sound effect to generate (max 5000 characters). Пример — A thunderstorm with heavy rain and wind.
loop
booleanWhether to create a looping sound effect. По умолчанию — false.
durationSeconds
numberAudio length in seconds (0.5-22); if omitted, optimal duration determined automatically. Диапазон 0.5–22.
promptInfluence
numberHow closely to follow the prompt (0-1). Диапазон 0–1. По умолчанию — 0.3.
outputFormat
stringДопустимые значения: mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192. Audio output format. По умолчанию — mp3_44100_128.

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

Запрос
curl -X POST https://api.mashagpt.ru/v1/tasks/elevenlabs-sound-effect-v2 \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "text": "A thunderstorm with heavy rain and wind",
  "loop": false,
  "promptInfluence": 0.3,
  "outputFormat": "mp3_44100_128"
}'
Ответ
{
  "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