AI 图像视频音乐创作

要解决的问题

在 agent 中生成图像、视频、音乐或语音时，常见风险不是“能不能调用”，而是计费、异步任务和素材引用容易失控：远程 MCP 不能直接读取本地文件，重复提交可能产生额外扣费，任务排队时又可能被误判失败。@beatra-ai/beatra-ai 将 Beatra 媒体创建封装成一条可执行的调用契约，让 agent 按最小工作流完成任务。

工作方式与边界

• 执行入口固定：所有 Beatra 工具通过 bundled scripts/mcp_client.py 访问认证后的 Beatra MCP，不依赖宿主机 Beatra Connector。
• 任务去重：每个逻辑生成创建一次 client_request_id；首次响应丢失可用相同 ID 重试，输入变化才换新 ID。
• 异步结果：保存 task_id，用 beatra.tasks.get 轮询到终态；排队或运行中不能创建另一个付费任务。
• 素材上传：本地图像、音频、视频先用 beatra.assets.upload 完成 HTTP PUT，再使用返回的 artifact ID。
• 可验证输出：仅报告任务状态、artifact 链接或 ID、解析模型、实际用量与净扣 credits 等真实返回字段。

注意：该技能负责媒体创建与管理，不替代宿主 agent 的文本、图像或视频理解；模型选择、计费恢复、卸载和断连应按对应工作流处理，避免误删共享连接。