Vidrush MCP

连接 Vidrush MCP，实现视频、图片、音乐和音频生成、任务轮询和积分查询。

端点与认证

Vidrush 提供远程 Streamable HTTP MCP Server：

https://vidrush-ai.com/api/mcp

支持两种认证方式。Server 名称为 vidrush。

OAuth(claude.ai 与 Claude 桌面版)。 添加名为 Vidrush 的自定义连接器,粘贴上方 URL,点击 Connect 并用 Vidrush 账号登录即可。客户端会通过 /.well-known/oauth-protected-resource 自动发现授权流程,无需 API key。

API key(Claude Code、Cursor、Codex、SDK)。 在支持 HTTP 请求头的 MCP 客户端中配置：

Authorization: Bearer sk-your-api-key

没有有效 OAuth token 或 API key 的请求会被拒绝。

工具

Vidrush MCP Server 可生成视频、图片、音乐和音频。生成会消耗积分——Agent 应在调用任何 generate_* 工具前读取模型并向用户说明成本。

共享工具

工具	输入	结果
`get_task`	`task_id`	当前 `status`、`media_type`，可用时的 `output_urls`（视频还带 `video_urls`）
`wait_for_task`	`task_id`、可选 `timeout_seconds`	轮询并返回最新任务；默认 45 秒，最小 1，最大 50
`get_credits`	无	已认证账户的 `remaining_credits`

视频

工具	输入	结果
`list_video_models`	无	视频模型 ID、标签、厂商、模式、时长、分辨率、积分标签
`get_video_model`	`model`	单个视频模型完整的能力和价格数据
`generate_video`	`model`、`prompt`、可选 `mode`、`image_urls`、`video_urls`、`duration`、`resolution`、`aspect_ratio`、`audio`、`source_video_duration_seconds`	创建任务，返回 `task_id`、`status`、`cost_credits` 和轮询提示

图片

工具	输入	结果
`list_image_models`	无	图片模型 ID、模式、比例、质量、积分标签
`get_image_model`	`model`	单个图片模型完整的能力和价格数据
`generate_image`	`model`、`prompt`、可选 `scene`、`image_urls`、`aspect_ratio`、`quality`	创建任务，轮询 `get_task` 获取 `output_urls`

音乐

工具	输入	结果
`list_music_models`	无	音乐模型、控制项和积分成本
`generate_music`	`prompt`、可选 `duration_seconds`、`instrumental`、`style`、`lyrics`	同步生成，通常立即返回 `output_urls`

音频

工具	输入	结果
`list_voices`	无	文本转语音音色（`id`、`name`、`gender`、`accent`、`language`）和积分成本
`generate_speech`	`text`、`voice_id`、可选 `model_id`、`speed`、`stability`、`similarity_boost`	同步生成，通常立即返回 `output_urls`
`generate_sound_effect`	`prompt`、可选 `duration_seconds`、`prompt_influence`	同步生成，通常立即返回 `output_urls`

它与 v1 API 使用相同的模型校验和积分规则。

典型工作流

调用对应的 list_* 工具（如 list_video_models 或 list_voices），再为所选模型调用 get_*_model。
确认生成将消耗展示的积分。
调用对应的 generate_* 工具。
调用 wait_for_task，或每 5 秒调用一次 get_task，直到状态为 success、failed 或 canceled。音乐和音频通常会立即完成。
成功时将 output_urls 返回给用户。

错误与恢复

工具失败会作为 MCP 错误结果返回带操作建议的文本。积分不足错误会包含 Vidrush 定价页 URL。模型或选项无效时，应再次调用 get_video_model 并修正输入，不要盲目重试会扣费的工具。

Vidrush MCP

On this page