# 总览
> Beatra 让 Agent 获得生产级的多模态创作能力——视频、图像、语音、音乐。一次安装、一次登录、一个积分余额。这份文档写给两类读者：接入 Beatra 的开发者，和真正执行调用的 Agent。

## 三层如何配合

- [1 · 起点 · Universal Skill](https://docs.beatra.ai/zh/docs/quickstart) — 一条消息安装的 Skill，教会 Agent 怎么扣积分、怎么认出同一次任务、怎么上传、怎么发现模型。 所有 Agent 平台从这里开始
- [2 · 执行 · OAuth MCP](https://docs.beatra.ai/zh/docs/authentication) — `mcp.beatra.ai` 上的认证执行层。创作、上传、模型、音色、任务，每个操作是一次 MCP 工具调用。 由 Skill 驱动
- [并行 · 直连 · REST / OpenAPI](https://docs.beatra.ai/zh/docs/api-reference) — 同一组能力的 HTTP 端点，位于 `api.beatra.ai`。 不经过 Agent 的自定义应用

三条路径落到同一套异步任务：同一套任务信息、继续查看进度、回调和扣费。推荐 Skill + MCP；REST 留给不经过 Agent 的应用。

## 选择你的路径

- [你在使用 Agent](https://docs.beatra.ai/zh/docs/quickstart) — 按快速开始走：一条消息、一次登录。能安装 Skill、能连接 MCP 的 Agent 都能用。
- [你在构建自定义应用](https://docs.beatra.ai/zh/docs/authentication) — 先读认证与请求约定，再看 API 参考和异步任务。
- [你是正在读本页的 Agent](https://docs.beatra.ai/llms.txt) — `llms.txt` 是站点地图，`/llms/*.md` 是自包含工作流，`openapi.json` 是机器契约。

## 能力地图

四个模态加公开社交数据。每一项都用同一套任务信息、继续查看进度，以及同样的回调方式，作为异步扣费任务交付。

| 模态 | 能做什么 |
| --- | --- |
| **图像** | [文本生成图像](https://docs.beatra.ai/zh/docs/capabilities/images/text-to-image) · [使用参考图变换图像](https://docs.beatra.ai/zh/docs/capabilities/images/image-to-image) · [编辑基础图像](https://docs.beatra.ai/zh/docs/capabilities/images/image-edit) · [图片理解](https://docs.beatra.ai/zh/docs/capabilities/images/image-understanding) |
| **视频** | [从文本生成视频](https://docs.beatra.ai/zh/docs/capabilities/videos/text-to-video) · [让图片动起来](https://docs.beatra.ai/zh/docs/capabilities/videos/image-to-video) · [从参考素材生成视频](https://docs.beatra.ai/zh/docs/capabilities/videos/reference-to-video) · [生成抵达指定尾帧的视频](https://docs.beatra.ai/zh/docs/capabilities/videos/frames-to-video) · [编辑已有视频](https://docs.beatra.ai/zh/docs/capabilities/videos/video-edit) · [延长已有视频](https://docs.beatra.ai/zh/docs/capabilities/videos/video-extend) · [增强视频提示词](https://docs.beatra.ai/zh/docs/capabilities/videos/video-prompt-enhancement) · [视频理解](https://docs.beatra.ai/zh/docs/capabilities/videos/video-understanding) |
| **语音与音色** | [语音合成](https://docs.beatra.ai/zh/docs/capabilities/speech/text-to-speech) · [音色克隆](https://docs.beatra.ai/zh/docs/capabilities/speech/voice-clone) · [音色管理](https://docs.beatra.ai/zh/docs/capabilities/speech/voices) |
| **音乐** | [文生音乐](https://docs.beatra.ai/zh/docs/capabilities/music/text-to-music) · [参考音频生音乐](https://docs.beatra.ai/zh/docs/capabilities/music/reference-audio-to-music) |
| **公开社交数据** | [公开社交数据](https://docs.beatra.ai/zh/docs/capabilities/social) |

能力页不绑定具体模型：Agent 通过 `beatra.models.list` 实时发现模型和价格。想直接浏览，看[当前模型阵容](https://docs.beatra.ai/zh/docs/models)。

## 平台机制

| 机制 | 回答什么 |
| --- | --- |
| [异步任务](https://docs.beatra.ai/zh/docs/mechanisms/async-tasks) | 任务从提交到终态怎么走，怎么轮询，什么算失败。 |
| [上传源素材](https://docs.beatra.ai/zh/docs/mechanisms/uploads) | 本地图片、音频、视频怎么变成可引用的素材 ID。 |
| [回调](https://docs.beatra.ai/zh/docs/mechanisms/callbacks) | 终态怎么推送到你的 HTTPS 地址，怎么验签。 |
| [计费与用量](https://docs.beatra.ai/zh/docs/mechanisms/billing) | 什么时候预扣、什么时候结算、失败怎么退回。 |
| [错误与重试](https://docs.beatra.ai/zh/docs/mechanisms/errors) | 错误信封长什么样，哪些能重试，怎么分支。 |
| [限流](https://docs.beatra.ai/zh/docs/mechanisms/rate-limits) | 并发和速率上限，以及超限后怎么退避。 |