create_compel从上传的音频创建Compel从主要音频媒体和可选参考媒体创建Compeller生成任务。返回compel ID、状态以及跟踪进度和检索渲染的链接。
MCP SERVER
https://compeller.ai/api/mcpSUMMARY
Compeller是一个MCP服务器,支持从歌曲创建和跟踪AI生成的音乐视频和音频反应式视觉内容。它提供音乐搜索、媒体上传、compel(生成任务)创建、渲染和webhook管理工具。服务器要求对生成和账户工具进行身份验证,而发现工具无需身份验证即可访问。
CAPABILITIES
已根据可验证证据建立能力档案
TOOLS IN THIS MCP SERVER
create_compel从上传的音频创建Compel从主要音频媒体和可选参考媒体创建Compeller生成任务。返回compel ID、状态以及跟踪进度和检索渲染的链接。
create_compel_from_music从音乐搜索创建Compel从选定的Deezer预览曲目创建compel。如果用户提供音频文件,则上传该文件并使用create_compel。
delete_webhook删除Webhook按ID删除webhook端点。移除注册并停止未来的投递。
get_capabilities获取Compeller能力获取Compeller平台能力、支持的功能和API版本。
get_compel获取Compel状态获取Compeller生成任务的当前状态、进度和详细信息。
get_pricing获取Compeller定价获取当前Compeller订阅计划和定价。
get_rendering获取渲染详情获取特定视频渲染的详细信息。
list_compels列出Compels列出认证账户的所有Compeller生成任务,最新的在前。
list_renderings列出Compel渲染列出特定compel的所有视频渲染。
list_styles列出视觉风格列出Compeller视频生成可用的视觉风格。
list_webhooks列出Webhooks列出认证账户注册的所有webhook端点。此工具从不返回密钥。
register_webhook注册Webhook注册一个HTTPS端点以接收compel生命周期事件(可渲染时的compel.ready、compel.completed、compel.failed)的签名推送通知。返回webhook_id和HMAC-SHA256签名密钥仅一次——立即存储密钥,之后不再返回。投递通过X-Compeller-Signature: sha256=<hex>对原始正文签名。投递至少一次:失败的投递会以退避方式重试(最多6次),每次重试携带相同的X-Compeller-Event-Id,因此请据此去重。
rotate_webhook_secret轮换Webhook密钥为已注册的webhook端点生成新的HMAC-SHA256签名密钥。之前的密钥立即失效——集成者必须在下一个compel终端事件触发前更新其接收器。返回新密钥仅一次;收到后请存储。
search_compels搜索Compels按标题搜索认证账户的Compeller生成任务。
search_media搜索上传的媒体搜索并列出认证账户上传的媒体文件。
search_music搜索音乐预览按歌曲、艺术家或专辑搜索Deezer预览曲目。当用户提供歌曲字符串但没有MP3/WAV/FLAC文件时使用。
start_render开始Compel渲染使用默认配置开始渲染READY状态的compel,以便代理无需打开浏览器UI即可继续生成最终MP4。
test_webhook_delivery测试Webhook投递同步向注册端点POST一个合成的webhook.test事件。使用与真实投递相同的HMAC-SHA256签名,在投递时运行标准URL安全检查,并返回{webhook_id, event_id, event_type, delivered, response_status, response_body_preview, latency_ms, error?}。忽略端点的事件订阅——测试投递始终按需进行。在依赖compel.completed / compel.failed事件之前,使用此工具验证您的集成。
update_webhook更新Webhook更新已注册webhook端点的一个或多个可变字段:url、events、active。必须至少提供其中一个。验证与register_webhook相同(仅https,<=2048字符,URL安全黑名单)。返回更新后的端点(此工具从不返回密钥——请使用rotate_webhook_secret)。
upload_media获取媒体上传说明获取媒体文件(音频、图像、视频)的上传说明。返回上传URL和所需标头。需要API令牌认证。
MACHINE-READABLE ENDPOINTS
ACCESS
USAGE OBSERVATIONS