AvataReel MCP
AvataReel MCP 服务器让你的 AI 助手使用你的 AvataReel 账户。经你确认后,它可以挑选数字人、撰写脚本、生成视频和购买点数。
概览
MCP(Model Context Protocol)是一个将 AI 助手连接到应用的开放标准。AvataReel 通过 HTTP 提供 MCP 服务器。你只需用个人 API 密钥连接一次,助手就能使用你在应用中的相同功能。
快速开始
1. 创建 API 密钥
在 AvataReel 中打开设置,找到"AI 助手 (MCP)",为密钥命名并创建。请立即复制:密钥只显示一次。 打开设置
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. 说出你的需求
用简单的话提出请求。助手会选择工具,在花费点数前显示价格,并在视频完成后给你链接。
你可以提出的请求
| 你说 | 助手 |
|---|---|
| “用一个亲切的数字人为我的咖啡店做一个 30 秒广告。” | 列出数字人,撰写脚本,显示价格,生成视频并返回下载链接。 |
| “根据这个产品页面写一个脚本。” | 读取页面,起草一份 UGC 脚本和一个场景。 |
| “做三个开头不同的版本。” | 撰写新的开场,并为每个开场生成一个视频。 |
| “我还有多少点数?再买一些。” | 显示你的余额和优惠,然后给你银行卡付款链接或 Pix 代码。 |
| “用这张照片创建一个数字人。” | 上传照片,创建数字人,并在完成时通知你。 |
| “取消我的套餐。” | 开始取消流程,并在确认前征求你的同意。 |
工具
以下是服务器提供的工具。助手会替你选择;如果你想直接指定某个工具,这些名称会有帮助。
视频
报价、创建、跟踪、重试和分享视频。
quote_videocreate_videowait_for_videolist_videosget_videoget_video_stepsretry_videodelete_videocreate_videos_from_briefcreate_hook_variationsgenerate_post_captioncreate_product_image_uploadcreate_character_swap_uploadcomplete_character_swap_uploadcreate_character_swap_image_uploadcomplete_character_swap_image_uploadclaim_video_guaranteeget_video_feedbacksend_video_feedbacksubmit_post_linklist_listing_imagescreate_listing_imagesregenerate_listing_image
脚本
撰写、改写和翻译脚本,或从产品页面开始。
list_scriptsgenerate_scriptgenerate_guided_scriptscript_from_urlrewrite_scripttranslate_scriptgenerate_hookssuggest_avatarpreview_speechpreview_voicegenerate_batch_scripts
数字人与声音
浏览数字人和声音,或用照片或描述创建数字人。
list_avatarsget_avatarlist_voicesget_avatar_quotacreate_avatar_photo_uploadassess_avatar_photogenerate_avatar_facecreate_avatarconfirm_avatar_likenessget_avatar_source_photoreplace_avatar_photoset_avatar_voicecreate_voice_recording_uploadmerge_voice_takesretry_avatardelete_avatar
编辑
更换服装和背景,编辑已完成的视频,使用动作编辑器。
classify_videocheck_product_scriptsuggest_wardrobecreate_background_uploadcreate_brand_logo_uploadcreate_scene_image_uploadpreview_appearancechange_appearanceget_video_captionsedit_videoget_motion_editor_accesscreate_motion_editcreate_automatic_motion_editget_motion_editget_video_motion_editsave_motion_editdirect_motion_editadd_motion_soundtrackexport_motion_edit
批量
一次创建和下载多个视频。需要账户开通批量视频。
quote_video_batchcreate_video_batchget_video_batchget_video_batch_downloadcreate_batch_motion_editslist_batch_motion_edits
品牌与产品
品牌套件、标志和已保存的产品照片。
list_brand_kitscreate_brand_kitbrand_kit_from_briefupdate_brand_kitlist_brand_assetsgenerate_brand_assetdelete_brand_kitlist_product_assetscreate_product_asset_uploadcomplete_product_asset_upload
点数与付款
余额、记录、点数包、套餐、Pix 和取消。
get_credit_balancelist_credit_transactionslist_unseen_refundsget_billing_offerscreate_pack_checkoutcreate_pix_chargeget_payment_orderget_subscriptioncreate_subscription_checkoutcreate_subscription_pixget_subscription_pixchange_subscriptionstart_subscription_cancelaccept_cancel_offerconfirm_subscription_cancelcreate_billing_portalget_billing_profileupdate_billing_profile
账户与帮助
个人资料、删除账户和客服支持。
get_profileupdate_profilecreate_profile_photo_uploaddelete_accountsend_support_reportask_support
点数与付款
视频使用与应用中相同的点数。助手会先获取报价,在创建视频前向你显示价格。
点数用完时,助手会显示你账户可用的点数包和套餐。它会给你银行卡付款链接,或可在银行应用中支付的 Pix 代码。付款确认后点数立即到账。
安全
- 你的 API 密钥代表你本人操作,包括花费点数。请像密码一样保密。
- 你可以随时在设置中撤销密钥。下一次请求起它就会失效。
- 好的助手会在付款、取消或删除前先询问。请在批准前仔细检查这些请求。
- API 密钥只能访问客户功能,不能创建或撤销其他密钥。
错误
出错时,工具会返回 HTTP 状态码和一条消息。最常见的有:
- 400
- 输入无效。消息会说明需要修正的内容。
- 401
- API 密钥缺失、错误或已撤销。
- 402
- 点数不足。请购买点数后重试。
- 403
- 你的账户没有此功能。
- 429
- 请求过多。请稍等后重试。