MMashaGPT API
MMashaGPT API
МоделиДокументацияТестированиеAPI-ключиПлатежи
МоделиДокументацияТестированиеAPI-ключиПлатежи
К обзору модели

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

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

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

Эндпоинт

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

Как прикрепить аудио

В запрос модели файл не отправляется напрямую. Сначала загрузите файл в MashaGPT storage, получите публичный URL и передайте его в параметр mediaUrl.

Не передавайте в JSON blob:, file://, data:, base64 или сырые байты. Storage принимает multipart/form-data с одним полем file. Подробный контракт: /v1/storage/upload.

1. Загрузить файл
curl -X POST "https://api.mashagpt.ru/v1/storage/upload" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@./reference.mp3"

Ответ вернет URL вида https://static.mashagpt.ru/...

2. Передать URL в модель
curl -X POST "https://api.mashagpt.ru/v1/tasks/elevenlabs-dubbing" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "mediaUrl": "https://static.mashagpt.ru/dl/mashagpt/reference.mp3"
}'

Если файл уже доступен по публичному URL, его можно передать сразу. Загрузка через MashaGPT storage надежнее для файлов с компьютера.

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

ПараметрТипОписание
mediaUrl*
stringDirect HTTPS audio/video file URL, at most 50 MiB and 60 seconds. Upload through storage first; web page URLs are not supported.
targetLanguage*
stringДопустимые значения: af, ak, sq, am, ar, ar-EG, hy, as, az, eu, be, bs, bg, my, yue, ca, ceb, zh, zh-TW, hr, cs, da, dgo, nl, en, en-AU, en-CA, en-GB, en-US, et, fil, fi, fr, fr-CA, fr-FR, gl, ka, de, el, gu, ha, he, hi, hu, is, id, it, ja, jv, kn, kk, ki, rw, rn, ko, ky, lv, lt, lg, mk, ms, ml, cmn, mr, mn, ne, no, fa, pl, pt, pt-BR, pt-PT, pa, ro, ru, nso, st, sd, sk, sl, es, es-AR, es-CL, es-ES, es-MX, su, sw, ss, sv, tg, ta, te, th, bo, ts, tn, tr, uk, ur, ug, uz, ve, vi, war, cy, wo, yo, zu. Пример — ru.
sourceLanguage
stringДопустимые значения: auto, af, ak, sq, am, ar, ar-EG, hy, as, az, eu, be, bs, bg, my, yue, ca, ceb, zh, zh-TW, hr, cs, da, dgo, nl, en, en-AU, en-CA, en-GB, en-US, et, fil, fi, fr, fr-CA, fr-FR, gl, ka, de, el, gu, ha, he, hi, hu, is, id, it, ja, jv, kn, kk, ki, rw, rn, ko, ky, lv, lt, lg, mk, ms, ml, cmn, mr, mn, ne, no, fa, pl, pt, pt-BR, pt-PT, pa, ro, ru, nso, st, sd, sk, sl, es, es-AR, es-CL, es-ES, es-MX, su, sw, ss, sv, tg, ta, te, th, bo, ts, tn, tr, uk, ur, ug, uz, ve, vi, war, cy, wo, yo, zu. По умолчанию — auto.
cloningStrength
integerДиапазон 0–10. По умолчанию — 7.

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

Запрос
curl -X POST https://api.mashagpt.ru/v1/tasks/elevenlabs-dubbing \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "mediaUrl": "https://example.com/image.jpg",
  "targetLanguage": "af",
  "sourceLanguage": "auto",
  "cloningStrength": 7
}'
Ответ
{
  "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

Сводка

Основные параметры Task API.

Модельelevenlabs-dubbing
Провайдер
ElevenLabs
Эндпоинт/v1/tasks/elevenlabs-dubbing
Тип ответа
аудио
Стоимость
от 18,34 ₽