📦 Mosaic Video Editor — AI视频剪辑

# Mosaic API 技能 借助 Mosaic，你将成为一名 AI 视频编辑师。你可以创建并运行视频编辑工作流（“Agents”）、上传媒体、连接社交账号，并自动发布编辑好的视频。 ## API 密钥设置 在进行任何 API 调用之前，你需要一个 Mosaic API 密钥（前缀为 mk_）。 1. 首先检查环境变量。 如果 MOSAIC_API_KEY 已经设置（例如通过 edit.mosaic.so 的一键设置），直接使用它。 2. 如果环境中没有该密钥，向用户索要。引导他们前往 edit.mosaic.so/automations?tab=api 使用 OpenClaw 或 Claude Code 的一键设置来生成密钥。 3. 将密钥存储为环境变量 MOSAIC_API_KEY，以便后续会话使用。 4. 使用 Authorization: Bearer $MOSAIC_API_KEY 头调用 GET https://api.mosaic.so/whoami 进行验证。 ## HTTP 约定 - Base URL: https://api.mosaic.so - Auth: Authorization: Bearer $MOSAIC_API_KEY - Content: Content-Type: application/json ## 工作流 每个工作流都有独立的指南。根据当前任务阅读对应文件。 | 任务 | 指南 | |------|-------| | 创建并管理 agents | workflows/managing-agents.md | | 在视频上运行 agent | workflows/running-agents.md | | 上传视频/音频/图片素材 | workflows/uploading-assets.md | | 发布到社交平台 | workflows/social-publishing.md | | 积分、计费与自动充值 | workflows/credits-and-billing.md | ## 节点（tiles） Agents 是由节点（也称“tiles”）组成的图。每个节点执行一个编辑动作。 要发现可用节点及其参数，调用： `` GET /node_types — 列出所有节点类型 GET /node_type/{node_type_id} — 获取某个节点的详细信息 ` 每个节点的参考文件（含 ID 与文档链接）位于 nodes/ 目录。需要为 update_params 填写参数细节时，请阅读对应节点文件。 ## 编辑最佳实践 - 为了更紧凑的剪辑，在风格节点前放置 Rough Cut 或 Clips。 - 在对布局敏感的节点（Captions、Cinematic Captions、Motion Graphics、Watermark）之前放置 Reframe。 - 通过将前序 node_render_ids 传递给后续运行，实现链式编辑。 ## 护栏 - update_params 的键必须与 GET /agent/{agent_id} 返回的 agent_node_id 值匹配。 - 无效覆盖将返回 400。 - 对于 captions，caption_font_weight 必须为字符串类型（例如 "700"）。 - 对于 Motion Graphics，使用 style_video_url 和 only_generate_full_screen_graphics。 - 如果运行因积分不足被拦截（needs_credits: true 或 needsCredits: true），先按 workflows/credits-and-billing.md 中的计划检查与升级流程操作，再尝试恢复。 - 读取积分配置时，不要使用 GET /credits/settings；请使用 GET /credits 查看当前自动充值设置。 - 对于免费/无付费计划用户，先用 GET /plan/list 列出可选方案，提示用户选择 plan_id，然后调用 POST /plan/upgrade。 - 升级成功后，务必询问是否启用自动充值；若用户同意，通过 POST /credits/settings` 并传入用户提供的阈值进行配置。 ## 端点映射 完整端点参考：references/docs-endpoints.md