Mosaic 视频编辑技能

使用 Mosaic，您将成为一名 AI 视频编辑器。您可以创建并运行视频编辑工作流（“代理”），上传媒体内容，连接社交账号，并自动发布编辑后的视频。

API 密钥设置

在进行任何 API 调用之前，您需要一个 Mosaic API 密钥（前缀为 mk_）。

1. 首先检查环境变量。 如果已设置 MOSAIC_API_KEY（例如通过 [edit.mosaic.so](https://edit.mosaic.so) 的一键设置），可直接使用。
2. 如果环境变量中没有密钥，请向用户索取。引导他们前往 [edit.mosaic.so/automations?tab=api](https://edit.mosaic.so/automations?tab=api)，通过一键设置功能生成密钥，支持 OpenClaw 或 Claude Code。
3. 将密钥存储为 MOSAIC_API_KEY 以供后续会话使用。
4. 使用以下命令验证：GET https://api.mosaic.so/whoami，请求头中包含 Authorization: Bearer $MOSAIC_API_KEY。

HTTP 约定

• 基础 URL： https://api.mosaic.so
• 认证方式： Authorization: Bearer $MOSAIC_API_KEY
• 内容类型： Content-Type: application/json

工作流

每个工作流都有对应的指南文件。请根据当前任务查阅相关文档。

节点（图块）

代理是由多个 节点（也称为“图块”）组成的图形结构。每个节点执行一项编辑操作。如需了解可用节点及其参数，请调用：

GET /node_types          — 列出所有节点类型
GET /node_type/{id}      — 获取特定节点的详细信息

每个节点的参考文件（含 ID 和文档链接）位于 [nodes/](nodes/) 目录中。当需要 update_params 的参数详情时，请查阅对应节点文件。

视频编辑最佳实践

• 为获得更紧凑的剪辑效果，建议将 粗剪 或 片段 节点置于风格类节点之前。
• 重新构图 节点应放在对布局敏感的节点（如字幕、电影字幕、动态图形、水印）之前。
• 通过传递前一个节点的 node_render_ids 给后续操作，实现编辑链式处理。

安全限制

• update_params 中的键必须与 GET /agent/{agent_id} 返回的 agent_node_id 值匹配。
• 无效的覆盖操作将返回 400 错误。
• 字幕相关参数中，caption_font_weight 必须为字符串类型（例如 "700"）。
• 使用动态图形节点时，应使用 style_video_url 和 only_generate_full_screen_graphics 参数。

端点映射

完整端点参考文档：[references/docs-endpoints.md](references/docs-endpoints.md)