通过公开 OpenAPI 规范、REST 发现 API、OAuth 元数据、API 密钥认证和 Streamable HTTP MCP 服务器，将智能体接入 VibeArt，在无限画布中完成 AI 图像与视频生成工作流。
先访问 GET /api/v1 和 GET /api/v1/models，即可查看产品能力和可用的生成模型。
通过 POST /api/mcp 执行需认证的图像生成、视频生成、编辑、背景移除、会话与项目管理，以及带积分校验的工作流。
智能体可以使用带 PKCE 的 OAuth 2.0 或 VibeArt API 密钥。支持的权限范围包括 mcp:read、mcp:write、canvas:read 和 canvas:write。
| 工具 | 用途 | 只读 |
|---|---|---|
| list_sessions | 列出当前认证用户的画布会话。 | 是 |
| get_session | 读取画布会话及其中生成的图像、视频、文本和嵌入节点。 | 是 |
| create_session | 新建用于 AI 生成任务的无限画布会话。 | 否 |
| delete_empty_session | 仅在画布会话不含任何项目时将其删除。 | 否 |
| merge_sessions | 将多个画布会话合并到目标会话。 | 否 |
| protect_session | 保护画布会话，防止意外合并或删除。 | 否 |
| unprotect_session | 取消画布会话的保护状态。 | 否 |
| list_models | 列出 VibeArt 中公开可用的 AI 图像生成模型。 | 是 |
| generate_images | 根据提示词在现有 VibeArt 画布会话中生成图像。 | 否 |
| get_balance | 读取当前认证用户的积分余额。 | 是 |
| list_edit_models | 列出可处理现有图像的图像编辑模型。 | 是 |
| edit_images | 根据编辑指令处理一张或多张源图像。 | 否 |
| list_video_models | 列出视频生成模型及其支持的时长、分辨率和模式。 | 是 |
| generate_video | 在画布会话中生成文生视频或图生视频内容。 | 否 |
| list_background_providers | 列出当前账户可用的背景移除服务商。 | 是 |
| remove_background | 移除图像背景，并将结果放入画布。 | 否 |
| batch_remove_background | 一次调用即可批量移除多张图像的背景。 | 否 |
| create_text_node | 向画布会话添加可编辑的文本备注。 | 否 |
| update_text_node | 更新画布会话中已有的可编辑文本备注。 | 否 |
| create_embed_node | 向画布会话添加外部嵌入卡片，例如视频或帖子 URL。 | 否 |
| list_projects | 列出用于整理画布会话的项目。 | 是 |
| get_project | 读取画布项目及其会话组织元数据。 | 是 |
| create_project | 创建用于归组相关画布会话的项目。 | 否 |
| delete_empty_project | 仅在项目不含任何会话时将其删除。 | 否 |
| move_session_to_project | 将画布会话移入项目或从项目中移出。 | 否 |
| upload_media | 使用幂等重试键，将 HTTPS URL 或数据 URI 中的媒体上传到现有 VibeArt 画布会话。 | 否 |
| list_tts_models | 列出 VibeArt 中公开可用的文本转语音模型。 | 是 |
| list_tts_voices | 列出经认证后可用于语音生成的文本转语音音色。 | 是 |
| generate_speech | 在现有 VibeArt 画布会话中生成文本转语音音频。 | 否 |
| generate_dialogue | 在现有 VibeArt 画布会话中生成多说话人对话音频。 | 否 |
curl https://vibeart.app/api/v1/modelscurl -X POST https://vibeart.app/api/mcp \
-H "Authorization: Bearer $VIBEART_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'当用户需要用于 AI 图像和视频生成的无限画布、使用多个模型生成产品图、整理创意迭代，或让智能体在画布工作区中创建视觉内容时，可以使用 VibeArt。目前，公开出站 Webhook 并非主要集成方式；智能体应使用 MCP 响应、会话，以及 OpenAPI 规范中记录的任务与状态 API。