Генерация медиа

Асинхронная генерация медиа: изображения, видео, озвучка (TTS), расшифровка речи (STT), музыка и 3D. Создаёте задачу и опрашиваете результат. Полный список моделей — в каталоге медиа-моделей; webhook, ошибки и биллинг — в разделе webhook.

Создание возвращает 202 с { ok: true, jobId, status: "processing" }. Опрашивайте GET /api/media/jobs/{jobId} до status: "success", затем заберите resultUrls.

# 1. создать задачу генерации
curl https://plusvibeapi.ru/api/media/generate \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "кот на скейте, замедленная съёмка"
  }'
# → {"ok":true,"jobId":"...","status":"processing"}

Помимо model и prompt, в opts можно передать дополнительные параметры. Набор зависит от модели. Полный машиночитаемый контракт — через GET /api/model-capabilities (или GET /api/model-capabilities/{model} для конкретной модели).

Поля с URL (image_url, input_urls, mask_url и другие) — это ссылки, которые скачивает провайдер, поэтому в них принимаются только публичные https:// адреса. Инлайн-строка data:image/...;base64,… в таком поле отклоняется с 400.

Чтобы отправить свой файл, положите его в парное *_base64 поле: сервис сам сохранит байты, опубликует их и подставит ссылку провайдеру. Максимум 16 файлов в input_base64 за запрос.

Тот же эндпоинт, что и остальная генерация: в model — имя STT-модели, prompt оставьте пустой строкой, а ссылку на запись передайте в opts.audio_url. Готовый текст приходит в поле resultText ответа GET /api/media/jobs/{id}; resultUrls у расшифровки пустой — файла на выходе нет.

# расшифровка речи: создать задачу и дождаться текста
curl https://plusvibeapi.ru/api/media/generate \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "whisper-large-v3-turbo",
    "prompt": "",
    "opts": {
      "audio_url": "https://example.com/meeting.mp3",
      "language_code": "ru"
    }
  }'
# → {"ok":true,"jobId":"JOB_ID","status":"processing","priceRub":0.03}

curl https://plusvibeapi.ru/api/media/jobs/JOB_ID \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY"
# → {"status":"success","resultText":"расшифрованный текст…","resultUrls":[],"priceRub":0.03}

Модели

• whisper-large-v3-turbo — 0,03 ₽ за минуту записи. Самая дешёвая и самая быстрая, 99 языков.
• nemotron-asr-multilingual — 0,03 ₽ за минуту. Многоязычная модель NVIDIA, ставит пунктуацию сама.
• whisper-large-v3 — 0,06 ₽ за минуту. Полная версия Whisper: медленнее turbo, точнее на шумной записи.
• universal-2 — 0,36 ₽ за минуту (AssemblyAI).
• speech-to-text — 0,93 ₽ за минуту (ElevenLabs Scribe). Умеет разделение по говорящим и метки звуковых событий.

Параметры

Форматы и ограничения

Принимаются mp3, wav, m4a/mp4, flac, ogg/opus и webm. Размер файла — не более 25 МБ (это примерно 26 минут mp3 128 kbps или несколько часов речи в opus). Файл больше лимита отклоняется сразу, с явным сообщением, и не тарифицируется — режьте запись на части.

Чтобы не опрашивать задачу, зарегистрируйте в личном кабинете один адрес mediaWebhookUrl. Когда задача завершится (успехом или ошибкой), сервис выполнит до пяти попыток доставки POST с JSON-телом:

// POST на ваш mediaWebhookUrl при завершении задачи
{
  "jobId": "...",
  "status": "success",            // или "fail"
  "model": "veo-3.1",
  "kind": "video",                // image | video | audio | music | 3d
  "resultUrls": ["https://plusvibeapi.ru/api/media/file/..."],
  "failMsg": null,
  "createdAt": "2026-06-17T10:00:00.000Z"
}

URL результата генерации (изображение или видео) из resultUrls. Используйте его как возвращённый сервисом URL: он открывается без API-ключа и подходит для <img>, <video> или браузер. Провайдер скрыт: upstream-адрес резолвится на сервере, клиент его не видит.

# Подписанный URL возвращается в resultUrls ответа /api/media/jobs/{id}
# или в теле webhook. Открывается напрямую в браузере / <img> — без ключа.
https://plusvibeapi.ru/api/media/file/JOB_ID/0?sig=HMAC_SIGNATURE