能力总览
一张矩阵看全 Beatra 能力：模态、MCP 工具、REST 端点与执行模式。
每个能力一行。Agent 在这里选定工具，再进入能力页查看参数、任务状态与恢复
策略。模型、控制项与价格由 beatra.models.list 实时发现；想直接浏览现在
可用的模型与价格，看当前模型阵容。
图像
| 能力 | 输入 → 输出 | MCP 工具 | REST 端点 |
|---|---|---|---|
| 文生图 | 文本 → 图像 | beatra.images.generate | POST /v1/images/generations |
| 图生图 | 图像 + 文本 → 图像 | beatra.images.transform | POST /v1/images/image-to-image |
| 图像编辑 | 图像 + 文本 → 图像 | beatra.images.edit | POST /v1/images/edits |
视频
| 能力 | 输入 → 输出 | MCP 工具 | REST 端点 |
|---|---|---|---|
| 文生视频 | 文本 → 视频 | beatra.videos.generate | POST /v1/videos/text-to-video |
| 图生视频 | 图像 + 文本 → 视频 | beatra.videos.animate | POST /v1/videos/image-to-video |
| 参考生视频 | 参考素材 + 文本 → 视频 | beatra.videos.generate_from_references | POST /v1/videos/reference-to-video |
| 首尾帧生视频 | 首/尾帧 + 文本 → 视频 | beatra.videos.interpolate | POST /v1/videos/frames-to-video |
| 视频编辑 | 视频 + 参考 + 文本 → 视频 | beatra.videos.edit | POST /v1/videos/edit |
| 视频延展 | 视频 + 文本 → 视频 | beatra.videos.extend | POST /v1/videos/extend |
语音与音色
| 能力 | 输入 → 输出 | MCP 工具 | REST 端点 |
|---|---|---|---|
| 语音合成 | 文本 + 音色 → 音频 | beatra.speech.synthesize | POST /v1/audio/speech |
| 音色克隆 | 音频样本 → 音色 | beatra.voices.clone | POST /v1/voices |
| 音色管理 | —（管理） | beatra.voices.list | GET /v1/voices |
音乐
| 能力 | 输入 → 输出 | MCP 工具 | REST 端点 |
|---|---|---|---|
| 文生音乐 | 提示词 / 歌词 → 音频 | beatra.music.generate | POST /v1/music/text-to-music |
| 参考音频生音乐 | 音频 + 文本 → 音频 | beatra.music.generate | POST /v1/music/reference-audio-to-music |
共享契约
上表中每个生成调用都是计费的，并返回异步任务：202 + Task envelope，
用 beatra.tasks.get（或 GET /v1/tasks/{task_id}）轮询到终态。发现与管理类
读取（音色、模型、任务）为同步调用。完整生命周期——envelope 结构、取消、退款——在
异步任务中定义一次，适用于每一行。