总览
Beatra 是什么，Skill、MCP 与 REST 三层如何配合，以及从哪里开始。
Beatra 让 Agent 获得生产级的多模态创作能力——视频、图像、语音、音乐——只需 一次安装、一次登录、一个 credits 余额。这份文档面向两类读者：接入 Beatra 的 开发者，和真正执行调用的 Agent 本身。
三层如何配合
| 层 | 是什么 | 何时用到 |
|---|---|---|
| Universal Skill | 一条消息即可安装的便携技能包，教会 Agent Beatra 的工作流：计费纪律、任务身份、上传、模型发现。 | 所有 Agent 平台的起点。 |
| OAuth MCP | mcp.beatra.ai 上的认证执行层。创作、上传、模型、音色、任务等每个操作都是一次 MCP 工具调用。 | 由 Skill 驱动；连接后 Agent 直接调用。 |
| REST/OpenAPI | 同一组能力的 HTTP 端点，位于 api.beatra.ai。 | 适合非 Agent 的自定义应用直连。 |
推荐通过 Skill + MCP 接入：安装一次，Agent 即可直接调用全部能力； REST API 适合非 Agent 的自定义应用直连。
选择你的路径
- 你在使用 Agent：按 Quickstart 走——一条消息、 一次登录。不挑 Agent：能安装技能包、能连接 MCP 就能用。
- 你在构建自定义应用：从认证开始，然后阅读 API Reference 与异步任务。
- 你是正在阅读本页的 Agent：读取 llms.txt 获得站点地图，
/llms/*.md指南提供自包含工作流，openapi.json 是机器契约。
能力
四个模态，每一项都以相同的任务信封、轮询与回调契约交付为异步计费任务：
能力总览是一页式矩阵：能力 × MCP 工具 × REST 端点 ×
执行模式。能力页不绑定具体模型——Agent 通过 beatra.models.list 实时发现
模型与价格；想直接浏览，看当前模型阵容。