AvataReel
Документация

AvataReel MCP

MCP-сервер AvataReel позволяет вашему ИИ-ассистенту работать с аккаунтом AvataReel. Он может выбирать аватаров, писать сценарии, создавать видео и покупать кредиты — с вашего подтверждения.

Обзор

MCP (Model Context Protocol) — открытый стандарт, который связывает ИИ-ассистентов с приложениями. AvataReel предоставляет MCP-сервер по HTTP. Вы подключаете его один раз с личным API-ключом, и ассистент получает те же функции, что и вы в приложении.

Быстрый старт

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

    В AvataReel откройте Настройки, найдите "ИИ-ассистенты (MCP)", назовите ключ и создайте его. Сразу скопируйте его: мы показываем ключ только один раз. Открыть Настройки

  2. 2. Добавьте сервер в клиент

    Вставьте это в MCP-конфигурацию клиента и замените avr_… своим ключом.

    {
      "mcpServers": {
        "avatareel": {
          "type": "http",
          "url": "https://api.avatareel.com/mcp",
          "headers": {
            "Authorization": "Bearer avr_…"
          }
        }
      }
    }

    В Claude Code выполните:

    claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
  3. 3. Попросите, что нужно

    Пишите простыми словами. Ассистент сам выберет инструменты, покажет цену до списания кредитов и пришлёт ссылку на видео, когда оно будет готово.

Что можно попросить

Вы проситеАссистент
“Сделай 30-секундную рекламу моей кофейни с дружелюбным аватаром.”Показывает аватаров, пишет сценарий, называет цену, создаёт видео и присылает ссылку для скачивания.
“Напиши сценарий по этой странице товара.”Читает страницу и готовит UGC-сценарий и сцену.
“Сделай три версии с разными хуками.”Пишет новые вступления и создаёт по видео для каждого.
“Сколько у меня кредитов? Купи ещё.”Показывает баланс и предложения, затем даёт ссылку на оплату картой или код Pix.
“Создай аватара по этому фото.”Загружает фото, создаёт аватара и сообщает, когда он готов.
“Отмени мой тариф.”Начинает отмену и спрашивает вас перед подтверждением.

Инструменты

Вот инструменты, которые предлагает сервер. Ассистент выбирает их за вас; названия пригодятся, если захотите попросить конкретный.

Видео

Расчёт цены, создание, отслеживание, повтор и публикация видео.

  • quote_video
  • create_video
  • wait_for_video
  • list_videos
  • get_video
  • get_video_steps
  • retry_video
  • delete_video
  • create_videos_from_brief
  • create_hook_variations
  • generate_post_caption
  • create_product_image_upload
  • create_character_swap_upload
  • complete_character_swap_upload
  • create_character_swap_image_upload
  • complete_character_swap_image_upload
  • claim_video_guarantee
  • get_video_feedback
  • send_video_feedback
  • submit_post_link
  • list_listing_images
  • create_listing_images
  • regenerate_listing_image

Сценарии

Написание, переписывание и перевод сценариев или старт со страницы товара.

  • list_scripts
  • generate_script
  • generate_guided_script
  • script_from_url
  • rewrite_script
  • translate_script
  • generate_hooks
  • suggest_avatar
  • preview_speech
  • preview_voice
  • generate_batch_scripts

Аватары и голоса

Просмотр аватаров и голосов или создание аватара по фото или описанию.

  • list_avatars
  • get_avatar
  • list_voices
  • get_avatar_quota
  • create_avatar_photo_upload
  • assess_avatar_photo
  • generate_avatar_face
  • create_avatar
  • confirm_avatar_likeness
  • get_avatar_source_photo
  • replace_avatar_photo
  • set_avatar_voice
  • create_voice_recording_upload
  • merge_voice_takes
  • retry_avatar
  • delete_avatar

Редактирование

Смена одежды и фона, правка готовых видео и редактор движения.

  • classify_video
  • check_product_script
  • suggest_wardrobe
  • create_background_upload
  • create_brand_logo_upload
  • create_scene_image_upload
  • preview_appearance
  • change_appearance
  • get_video_captions
  • edit_video
  • get_motion_editor_access
  • create_motion_edit
  • create_automatic_motion_edit
  • get_motion_edit
  • get_video_motion_edit
  • save_motion_edit
  • direct_motion_edit
  • add_motion_soundtrack
  • export_motion_edit

Пакеты

Создание и скачивание многих видео сразу. Нужны пакетные видео в аккаунте.

  • quote_video_batch
  • create_video_batch
  • get_video_batch
  • get_video_batch_download
  • create_batch_motion_edits
  • list_batch_motion_edits

Бренд и товары

Брендбуки, логотипы и сохранённые фото товаров.

  • list_brand_kits
  • create_brand_kit
  • brand_kit_from_brief
  • update_brand_kit
  • list_brand_assets
  • generate_brand_asset
  • delete_brand_kit
  • list_product_assets
  • create_product_asset_upload
  • complete_product_asset_upload

Кредиты и оплата

Баланс, история, пакеты кредитов, тарифы, Pix и отмена.

  • get_credit_balance
  • list_credit_transactions
  • list_unseen_refunds
  • get_billing_offers
  • create_pack_checkout
  • create_pix_charge
  • get_payment_order
  • get_subscription
  • create_subscription_checkout
  • create_subscription_pix
  • get_subscription_pix
  • change_subscription
  • start_subscription_cancel
  • accept_cancel_offer
  • confirm_subscription_cancel
  • create_billing_portal
  • get_billing_profile
  • update_billing_profile

Аккаунт и помощь

Профиль, удаление аккаунта и поддержка.

  • get_profile
  • update_profile
  • create_profile_photo_upload
  • delete_account
  • send_support_report
  • ask_support

Кредиты и оплата

Видео расходуют те же кредиты, что и в приложении. Ассистент сначала узнаёт цену и показывает её до создания видео.

Когда кредиты закончатся, ассистент покажет пакеты и тарифы для вашего аккаунта. Он даст ссылку на оплату картой или код Pix для оплаты в банковском приложении. Кредиты поступят сразу после подтверждения оплаты.

Безопасность

  • API-ключ действует от вашего имени, в том числе тратит кредиты. Храните его в секрете, как пароль.
  • Отозвать ключ можно в Настройках в любой момент. Он перестанет работать со следующего запроса.
  • Хорошие ассистенты спрашивают перед оплатой, отменой или удалением. Проверяйте такие запросы перед одобрением.
  • API-ключи дают доступ только к клиентским функциям. Они не могут создавать или отзывать другие ключи.

Ошибки

При сбое инструмент возвращает HTTP-статус и сообщение. Самые частые:

400
Неверные данные. В сообщении сказано, что исправить.
401
API-ключ отсутствует, неверен или отозван.
402
Недостаточно кредитов. Купите кредиты и повторите.
403
В вашем аккаунте нет этой функции.
429
Слишком много запросов. Подождите немного и повторите.
AvataReel MCP: создавайте рекламные видео через ИИ-ассистента