Smart Reels API

Smart Reels API для вашей фабрики клипов

Подключите внешний Smart Reels API к своему продукту: создавайте задачи нарезки, отслеживайте статус и забирайте готовые вертикальные видео по HTTPS.

Обзор

Smart Reels API — это внешний HTTP‑сервис, который принимает URL исходного видео, ставит задачу в очередь и возвращает ссылки на готовые клипы и финальный файл.

Вы работаете только с REST‑эндпоинтами на api.mnogo-reels.ru, а вся тяжёлая работа по анализу, нарезке и хранению видео происходит на стороне MnogoReels.

Типичный цикл

< 3 мин

От запроса до первых клипов

Формат

Reels / Shorts / TikTok

Оптимальные вертикальные форматы

Поддержка

YouTube / Rutube / URL

Работа с публичными видео по ссылке

Quickstart

Один POST-запрос — и Smart Reels берёт видео в работу.

POST https://api.mnogo-reels.ru/videos
Content-Type: application/json

{
  "url": "https://example.com/video.mp4",
  "clip_duration": 45,
  "max_clips": 10,
  "watermark": true,
  "start_sec": 0,
  "end_sec": 0,
  "video_mode": "general",
  "caption_style": "karaoke",
  "clip_analyzer": "gemini",
  "add_music": false,
  "gemini_emojis": false
}

Смотрите актуальные требования к авторизации и пример кода в swagger по адресу https://api.mnogo-reels.ru/openapi.json.

Основные эндпоинты

Ниже базовые ручки внешнего Smart Reels API, которых достаточно, чтобы создать задачу нарезки, следить за её статусом и скачать готовый файл.

Базовый URL внешнего APIhttps://api.mnogo-reels.ru

POST /videos

Создание задачи нарезки

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

Body запроса

{
  "url": "https://example.com/video.mp4",
  "clip_duration": 45,
  "max_clips": 10,
  "watermark": true,
  "start_sec": 0,
  "end_sec": 0,
  "video_mode": "general",
  "caption_style": "karaoke",
  "clip_analyzer": "gemini",
  "add_music": false,
  "gemini_emojis": false
}

GET /videos/{job_id}

Статус задачи и клипы

Используйте этот эндпоинт, чтобы периодически опрашивать статус задачи, получать прогресс обработки и ссылки на финальные клипы и JSON‑модель.

{
  "id": "job_123",
  "status": "queued | processing | completed | failed",
  "source_url": "https://example.com/video.mp4",
  "file_url": "https://...",
  "s3_final_url": "https://...",
  "s3_clip_urls": [
    "https://..."
  ],
  "model_json_url": "https://...",
  "s3_model_json_url": "https://...",
  "progress": 0.42,
  "error": null
}

GET /videos/{job_id}/file

Загрузка финального файла

Эндпоинт для скачивания результата обработки по идентификатору задачи. Подходит, если вы хотите забирать файл напрямую из Smart Reels API.

GET https://api.mnogo-reels.ru/videos/{job_id}/file

// returns the processed video file as response body
// or a string as defined in the OpenAPI schema

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

1
Создание задачи: ваш сервис отправляет POST https://api.mnogo-reels.ru/videos с url исходного видео и параметрами клипов.
2
Очередь: Smart Reels ставит задачу в очередь обработки и возвращает идентификатор job_id.
3
Polling: вы периодически вызываете GET https://api.mnogo-reels.ru/videos/{job_id}, чтобы узнать статус и прогресс обработки.
4
Метаданные: вместе со статусом вы получаете ссылки на JSON‑модель, клипы и финальный файл, которые можно сохранить в своей системе.
5
Готовые клипы: когда статус становится completed, все клипы и финальный файл готовы к использованию на вашем фронтенде или в бэк‑процессах.
6
Завершение: в случае ошибки статус становится failed, а поле error помогает понять, что пошло не так.

Параметры запроса POST /videos

Какие поля принимает Smart Reels API и какие значения сейчас реально используются в проекте.

url (string, обязательно) — публичный URL исходного видео (YouTube, Rutube, прямой .mp4 и т.п.). Это единственное обязательное поле.
clip_duration (number, опционально) — желаемая длительность одного клипа в секундах. По умолчанию 45 (если параметр не передан).
max_clips (number, опционально) — максимальное количество клипов, которое нужно сгенерировать. По умолчанию 10.
watermark (boolean, опционально) — добавлять ли водяной знак на клипы (true / false). По умолчанию true.
start_sec (number, опционально) — с какой секунды исходного видео начинать анализ. 0 или отсутствие параметра — с самого начала ролика.
end_sec (number, опционально) — на какой секунде остановить анализ. 0 или отсутствие параметра — до конца видео без обрезки.
video_mode (string, опционально) — режим анализа видео. В SDK сейчас используются значения "general" и "podcast". По умолчанию "general".
caption_style (string, опционально) — стиль субтитров. В проекте используются варианты "karaoke", "minimal" и "viral". По умолчанию "karaoke".
clip_analyzer (string, опционально) — движок анализа клипов.
add_music (boolean, опционально) — добавлять ли фоновую музыку к клипам (true / false). Параметр поддерживается внешним API; текущий клиент по умолчанию его не указывает.
gemini_emojis (boolean, опционально) — включить ли эмодзи в субтитрах при использовании Gemini-анализатора (true / false).