AvataReel
文档

AvataReel MCP

AvataReel MCP 服务器让你的 AI 助手使用你的 AvataReel 账户。经你确认后,它可以挑选数字人、撰写脚本、生成视频和购买点数。

概览

MCP(Model Context Protocol)是一个将 AI 助手连接到应用的开放标准。AvataReel 通过 HTTP 提供 MCP 服务器。你只需用个人 API 密钥连接一次,助手就能使用你在应用中的相同功能。

快速开始

  1. 1. 创建 API 密钥

    在 AvataReel 中打开设置,找到"AI 助手 (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:用 AI 助手制作广告视频