API · MCP · Агенты

Доверьте студию Reels своему AI-агенту

Подключите Claude, Cursor или любой MCP-агент к WowReveal одной строкой. Пишите обычными словами — агент найдёт трендовые видео, сделает шортсы-истории на 9 языках, напишет пост-киты и пришлёт ссылки.

Получить API-ключ Читать документацию

Входит во все платные тарифы · те же кредиты, что и в приложении

WowReveal MCP connector – tool definition quality and endpoint health on Glama

Claude · WowReveal подключён MCP

Найди 3 трендовых прослушивания с «золотой кнопкой» за неделю и сделай шортсы-истории на испанском.

search_trends · ниша: talent-show · 7 дней

create_short × 3 · шаблон: talent-show · es

wait_for_project · готово 3 из 3

Готово! 3 шортса ждут вас (34–38 с, испанская озвучка, субтитры). Вот ссылки на скачивание…

Работает с

Claude Code
Claude Desktop
claude.ai
Cursor
Windsurf
Cline
VS Code
OpenAI Agents SDK

Как это работает

От нуля до агента, который выпускает Reels, — меньше чем за две минуты.

01
Создайте API-ключ
В разделе «Разработчикам» в приложении. Ключ показывается один раз, хранится в виде хэша и отзывается в любой момент.
02
Подключите агента
Одна команда для Claude Code, коннектор для claude.ai и блок JSON для Cursor и остальных.
03
Попросите своими словами
Агент сам выберет инструменты, проверит цену, запустит задачи и дождётся готовых видео.

Подключите агента

Один адрес для всех клиентов. Вставьте свой ключ вместо YOUR_API_KEY.

Адрес MCP-сервера

Streamable HTTP · без сессий · API-ключ: Bearer или X-API-Key

Выполните команду один раз в терминале. Потом просто спросите Claude — например, «Сколько у меня кредитов в WowReveal?».

bash

claude mcp add --transport http wowreveal https://wowreveal.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Проверить подключение можно командой /mcp внутри Claude Code.

Для всей команды (.mcp.json)

Закоммитьте файл, а каждый участник пусть задаст WOWREVEAL_API_KEY в своём окружении.

.mcp.json

{
  "mcpServers": {
    "wowreveal": {
      "type": "http",
      "url": "https://wowreveal.com/mcp",
      "headers": {
        "Authorization": "Bearer ${WOWREVEAL_API_KEY}"
      }
    }
  }
}

Все инструменты, которые нужны агенту

Чтение бесплатно. Действия тратят те же кредиты, что и в приложении, а за неудачные задачи кредиты возвращаются автоматически.

23 инструмента с понятными названиями, описаниями и пометками безопасности. Цены актуальные.

Инструменты MCP
Инструмент	Что делает	Цена
Аккаунт и справочники
`get_account`	Баланс, тариф, лимиты и текущие цены. Агенты вызывают его первым.	Бесплатно
`list_templates`	Шаблоны ниш (талант-шоу, преображения, спасение животных…) с настройками по умолчанию.	Бесплатно
`list_languages`	9 языков для сценариев, озвучки, субтитров и пост-китов.	Бесплатно
`list_caption_styles`	Стили анимированных субтитров для каждого видео.	Бесплатно
`list_voices`	Голоса AI-диктора — сначала лучшие для историй.	Бесплатно
`estimate_credits`	Узнать цену любого действия заранее и хватит ли баланса.	Бесплатно
Шортсы и проекты
`create_short`Фоновая задача	Шортс-история, преображение или лучший момент по ссылке или загрузке — id задачи сразу.	История — 8 кредитов · Преображение — 14 кредитов · Моменты — 3 кредита
`get_project`	Статус, прогресс, сценарий и подписанная ссылка на готовое видео.	Бесплатно
`list_projects`	Ваши проекты от новых к старым, с фильтром по статусу и пагинацией.	Бесплатно
`wait_for_project`	Ждёт завершения задачи до 50 секунд — без частого опроса.	Бесплатно
`create_compilation`Фоновая задача	Длинная нумерованная подборка «Топ-10» из готовых шортсов.	8 кредитов
AI Clipper
`start_clipper`Фоновая задача	Анализирует длинное видео и предлагает лучшие самостоятельные клипы.	6 кредитов / 30 мин исходника
`get_clip_plan`	Кандидаты в клипы с оценкой, таймкодами и обоснованием.	Бесплатно
`generate_clips`Фоновая задача	Монтирует выбранные клипы в вертикальные видео 9:16 с субтитрами.	2 кредита / клип
Мгновенные инструменты
`write_script`	Вирусный сценарий озвучки по видео или тексту нужной длины.	1 кредит
`create_post_kit`	Заголовки, описание, хэштеги и первый комментарий под платформу и язык.	1 кредит
`generate_voiceover`	Текст → естественная озвучка в MP3 на любом из 9 языков.	1 кредит / 100 символов
Планирование
`search_trends`	Свежие вирусные видео YouTube в нише, по просмотрам в день.	1 кредит · повтор бесплатно
`earnings_estimate`	Примерный доход в месяц по просмотрам, платформе, аудитории и нише.	Бесплатно
AI Studio
`list_studio_models`	Доступные вам модели изображений и видео — с настройками и ценами.	Бесплатно
`list_studio_presets`	Эффекты в один клик: движения камеры, переходы, VFX, предметная съёмка.	Бесплатно
`studio_generate`Фоновая задача	Генерация AI-изображений и видео — id генераций сразу.	Зависит от модели
`get_generation`	Статус и подписанные ссылки на результаты генерации.	Бесплатно

Аккаунт и справочники

get_accountБесплатно
Баланс, тариф, лимиты и текущие цены. Агенты вызывают его первым.
list_templatesБесплатно
Шаблоны ниш (талант-шоу, преображения, спасение животных…) с настройками по умолчанию.
list_languagesБесплатно
9 языков для сценариев, озвучки, субтитров и пост-китов.
list_caption_stylesБесплатно
Стили анимированных субтитров для каждого видео.
list_voicesБесплатно
Голоса AI-диктора — сначала лучшие для историй.
estimate_creditsБесплатно
Узнать цену любого действия заранее и хватит ли баланса.

Шортсы и проекты

create_shortИстория — 8 кредитов · Преображение — 14 кредитов · Моменты — 3 кредита
Шортс-история, преображение или лучший момент по ссылке или загрузке — id задачи сразу.
Фоновая задача
get_projectБесплатно
Статус, прогресс, сценарий и подписанная ссылка на готовое видео.
list_projectsБесплатно
Ваши проекты от новых к старым, с фильтром по статусу и пагинацией.
wait_for_projectБесплатно
Ждёт завершения задачи до 50 секунд — без частого опроса.
create_compilation8 кредитов
Длинная нумерованная подборка «Топ-10» из готовых шортсов.
Фоновая задача

AI Clipper

start_clipper6 кредитов / 30 мин исходника
Анализирует длинное видео и предлагает лучшие самостоятельные клипы.
Фоновая задача
get_clip_planБесплатно
Кандидаты в клипы с оценкой, таймкодами и обоснованием.
generate_clips2 кредита / клип
Монтирует выбранные клипы в вертикальные видео 9:16 с субтитрами.
Фоновая задача

Мгновенные инструменты

write_script1 кредит
Вирусный сценарий озвучки по видео или тексту нужной длины.
create_post_kit1 кредит
Заголовки, описание, хэштеги и первый комментарий под платформу и язык.
generate_voiceover1 кредит / 100 символов
Текст → естественная озвучка в MP3 на любом из 9 языков.

Планирование

search_trends1 кредит · повтор бесплатно
Свежие вирусные видео YouTube в нише, по просмотрам в день.
earnings_estimateБесплатно
Примерный доход в месяц по просмотрам, платформе, аудитории и нише.

AI Studio

list_studio_modelsБесплатно
Доступные вам модели изображений и видео — с настройками и ценами.
list_studio_presetsБесплатно
Эффекты в один клик: движения камеры, переходы, VFX, предметная съёмка.
studio_generateЗависит от модели
Генерация AI-изображений и видео — id генераций сразу.
Фоновая задача
get_generationБесплатно
Статус и подписанные ссылки на результаты генерации.

О чём можно попросить

Вставьте в Claude после подключения WowReveal. Агент сам выберет инструменты, проверит баланс и дождётся готовых видео.

“Найди 5 трендовых прослушиваний с талант-шоу за эту неделю и сделай из них шортсы-истории на испанском по шаблону talent-show. Дождись готовности и пришли ссылки на видео.”

“Разбери этот подкаст в AI Clipper и смонтируй 4 клипа с самой высокой оценкой, с субтитрами: https://www.youtube.com/watch?v=…”

“Сколько у меня кредитов в WowReveal и сколько шортсов с озвучкой и преображений я ещё могу сделать в этом месяце?”

“Напиши пост-кит для Facebook на русском для моего последнего готового шортса и подскажи лучшее время публикации.”

“Собери подборку с обратным отсчётом «Топ-5 золотых кнопок» из пяти моих последних готовых шортсов.”

“Сколько может заработать страница с Reels в Facebook при 2 млн просмотров в месяц, в основном из США? Покажи диапазон.”

Справочник REST API

JSON по HTTPS. Базовый адрес https://wowreveal.com/api/v1. Те же проверки, лимиты и кредиты, что и в приложении.

GET/api/v1/me
Аккаунт: баланс, тариф, лимиты и текущие цены.
Бесплатно
GET/api/v1/templates?locale=en
Шаблоны ниш на нужном языке (locale=en|ru).
Бесплатно
GET/api/v1/languages
Языки контента.
Бесплатно
GET/api/v1/caption-styles
Стили субтитров.
Бесплатно
GET/api/v1/voices
Голоса дикторов.
Бесплатно
POST/api/v1/uploads
Загрузка видео, аудио или изображения (multipart, поле «file») → id загрузки.
Бесплатно
POST/api/v1/projects
Запуск шортсов (история / преображение / моменты) по ссылкам или загрузкам.Idempotency-Key
История — 8 кредитов · Преображение — 14 кредитов · Моменты — 3 кредита
GET/api/v1/projects
Список проектов (status, tool, q, cursor, limit).
Бесплатно
GET/api/v1/projects/:id
Проект с подписанными ссылками на видео, скачивание и обложку.
Бесплатно
POST/api/v1/compilations
Нумерованная подборка из готовых проектов.Idempotency-Key
8 кредитов
POST/api/v1/clipper/plans
Анализ длинного видео в AI Clipper.Idempotency-Key
6 кредитов / 30 мин исходника
GET/api/v1/clipper/plans
20 последних планов клипов, сначала новые.
Бесплатно
GET/api/v1/clipper/plans/:id
Статус плана и кандидаты в клипы.
Бесплатно
POST/api/v1/clipper/plans/:id/generate
Монтаж выбранных кандидатов.Idempotency-Key
2 кредита / клип
POST/api/v1/post-kit
Заголовки, описание, хэштеги, первый комментарий.Idempotency-Key
1 кредит
POST/api/v1/script
Сценарий озвучки по видео или тексту.Idempotency-Key
1 кредит
POST/api/v1/tts
Текст → озвучка MP3 (подписанная ссылка).Idempotency-Key
1 кредит / 100 символов
POST/api/v1/trends/search
Трендовые видео по нише или запросу.
1 кредит · повтор бесплатно
GET/api/v1/studio/models
Модели и пресеты AI Studio.
Бесплатно
POST/api/v1/studio/generations
Запуск генерации изображений и видео.Idempotency-Key
Зависит от модели
GET/api/v1/studio/generations/:id
Статус генерации и подписанные ссылки на результат.
Бесплатно
POST/api/v1/estimate
Цена действия до запуска.
Бесплатно
POST/api/v1/earnings/estimate
Оценка дохода автора.
Бесплатно

Запрос и ответ

POST /api/v1/projects — запрос

{
  "tool": "story",
  "sources": [
    {
      "url": "https://www.youtube.com/watch?v=VIDEO_ID"
    }
  ],
  "settings": {
    "templateId": "talent-show",
    "language": "es",
    "targetSeconds": 35,
    "captionStyle": "pop_bounce",
    "voiceId": "nPczCjzI2devNBz1zQrb",
    "music": "auto",
    "headline": true,
    "endingCta": true
  }
}

201 Created

{
  "projects": [
    {
      "id": "6f1c2d9e-8a41-4c1b-9f0e-2b7d5a3c9e11",
      "name": "Golden buzzer audition",
      "tool": "story",
      "templateId": "talent-show",
      "language": "es",
      "status": "queued",
      "step": "queued",
      "progress": 0,
      "videoUrl": null,
      "downloadUrl": null,
      "thumbnailUrl": null,
      "queue": {
        "position": 2,
        "ahead": 1
      },
      "creditsCharged": 8,
      "createdAt": "2026-10-04T09:30:00.000Z"
    }
  ],
  "creditsCharged": 8,
  "balance": 442
}

GET /api/v1/projects/:id — когда готово

{
  "project": {
    "id": "6f1c2d9e-8a41-4c1b-9f0e-2b7d5a3c9e11",
    "status": "complete",
    "step": "complete",
    "progress": 100,
    "title": "Nadie esperaba esta voz…",
    "durationSec": 34.2,
    "videoUrl": "https://wowreveal.com/api/media/eyJrIjoicHYi…",
    "downloadUrl": "https://wowreveal.com/api/media/eyJrIjoicHYi…d",
    "thumbnailUrl": "https://wowreveal.com/api/media/eyJrIjoicHQi…",
    "errorCode": null,
    "completedAt": "2026-10-04T09:36:12.000Z",
    "expiresAt": "2026-11-18T09:36:12.000Z"
  }
}

402 Payment Required

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits: 8 required, 3 available",
    "details": {
      "required": 8,
      "balance": 3
    }
  }
}

Авторизация

Передавайте ключ в заголовке Authorization в каждом запросе: Authorization: Bearer wr_live_…. MCP-сервер (/mcp) принимает его и в заголовке X-API-Key: wr_live_… — для каталогов и клиентов, которые умеют только так; если пришли оба заголовка, используется Bearer. Ключи принадлежат вашему аккаунту, хранятся в виде хэша SHA-256 и отзываются в любой момент в разделе «Разработчикам». Без ключа или с отозванным ключом — ответ 401 с заголовком WWW-Authenticate; на тарифе без доступа к API — 403.

http

Authorization: Bearer wr_live_…

MCP (/mcp) принимает и так

X-API-Key: wr_live_…

Ссылки на медиа

Ссылки на видео, обложки и аудио в ответах API и MCP — абсолютные подписанные URL, действуют 24 часа. Скачивайте их или передавайте дальше; за свежими ссылками просто запросите проект ещё раз.

Безопасные повторы

Добавляйте заголовок Idempotency-Key (REST) или аргумент idempotency_key (MCP) к запросам на создание. Тот же запрос с тем же ключом в течение 24 часов вернёт первый результат без повторного списания; тот же ключ с другим телом — ответ 409.

Вебхуки

Вебхуков нет: задачи выполняются за минуты, поэтому опрашивайте GET /api/v1/projects/:id раз в 10–20 секунд, а MCP-агенты пусть используют wait_for_project.

Лимиты запросов

Лимиты считаются на аккаунт и общие с приложением. При превышении — ответ 429 RATE_LIMITED с заголовком Retry-After. Ещё тариф ограничивает число параллельных задач (ACTIVE_JOBS_LIMIT).

Все запросы к API и MCP: 120 / мин
Видео-задачи (шортсы, клиппер, подборки): 20 / мин
Мгновенные инструменты (сценарий, пост-кит, озвучка, тренды): 30 / мин
Генерации AI Studio: 30 / мин
Загрузки: 60 / час

Стоимость

Доступ к API и MCP входит во все платные тарифы, начиная с «Старт». Вызовы тратят те же кредиты, что и в приложении, чтение бесплатно, а за неудачные задачи кредиты возвращаются автоматически.

Посмотреть тарифы

Ошибки

Ошибки всегда выглядят одинаково: HTTP-статус и стабильный машиночитаемый код. Инструменты MCP возвращают то же самое в виде понятного результата с isError.

Статус	Код	Значение
400	`VALIDATION_ERROR`	Проверьте поля формы — некоторые заполнены неверно.
	`INVALID_URL`	Это не похоже на ссылку на видео.
	`UNSUPPORTED_SITE`	С этого сайта пока нельзя загрузить видео. Попробуйте YouTube, Facebook, TikTok или загрузите файл.
401	`INVALID_API_KEY`	API-ключ недействителен или отозван.
402	`INSUFFICIENT_CREDITS`	Недостаточно кредитов. Пополните баланс или перейдите на тариф выше.
403	`API_ACCESS_REQUIRES_PLAN`	Доступ к API и MCP есть на любом платном тарифе.
	`PLAN_LIMIT`	Это превышает лимиты вашего тарифа. Перейдите на тариф выше, чтобы снять ограничения.
	`SOURCE_TOO_LONG`	Видео длиннее, чем позволяет ваш тариф. Возьмите видео покороче или улучшите тариф.
404	`NOT_FOUND`	Ничего не нашлось. Возможно, это удалили или истёк срок хранения.
	`UPLOAD_NOT_FOUND`	Загруженный файл больше недоступен. Загрузите его снова.
409	`CONFLICT`	Данные изменились в другом месте. Обновите страницу и попробуйте снова.
	`PLAN_NOT_READY`	Анализ ещё не завершён.
	`PLAN_EXPIRED`	Срок хранения плана нарезки истёк. Проанализируйте видео заново.
413	`PAYLOAD_TOO_LARGE`	Файл слишком большой для вашего тарифа.
429	`RATE_LIMITED`	Слишком много запросов. Подождите немного и повторите.
	`ACTIVE_JOBS_LIMIT`	Запущено максимальное число задач. Дождитесь завершения одной из них или улучшите тариф.
503	`FEATURE_DISABLED`	Эта функция временно отключена.
	`MAINTENANCE`	WowReveal ненадолго закрыт на обновление. Загляните через несколько минут.

Дайте своему агенту студию

Создайте ключ, вставьте одну строку и попросите первую пачку Reels.

Получить API-ключ Тарифы

Доверьте студию Reels своему AI-агенту

Работает с

Как это работает

Создайте API-ключ

Подключите агента

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

Подключите агента

Для всей команды (.mcp.json)

Все инструменты, которые нужны агенту

Аккаунт и справочники

Шортсы и проекты

AI Clipper

Мгновенные инструменты

Планирование

AI Studio

О чём можно попросить

Справочник REST API

Запрос и ответ

Авторизация

Ссылки на медиа

Безопасные повторы

Вебхуки

Лимиты запросов

Стоимость

Ошибки

Дайте своему агенту студию