能力总览
一张矩阵看全 Beatra 能力：模态、MCP 工具、REST 端点与执行模式。
每个能力一行。Agent 在这里选定工具，再进入能力页查看参数、任务状态与恢复
策略。模型、控制项与价格由 beatra.models.list 实时发现；想直接浏览现在
可用的模型与价格，看当前模型阵容。
图像
| 能力 | 输入 → 输出 | MCP 工具 | REST 端点 |
|---|---|---|---|
| 图片理解 | 1–8 张图片 + 文本 → 文本 | beatra.images.understand | POST /v1/images/responses |
| 文生图 | 文本 → 图像 | 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.understand | POST /v1/videos/responses |
| 视频提示词增强 | 文本 + 可选参考素材 → 增强文本 | beatra.videos.enhance_prompt | POST /v1/videos/prompts/enhance |
| 文生视频 | 文本 → 视频 | 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 |
公开社交数据
| 能力 | 输入 → 输出 | MCP 工具 | REST 端点 |
|---|---|---|---|
| 公开社交数据 | 公开社交查询 → JSON（正文、指标、媒体 URL） | beatra.social.tools.search / get / execute | 仅 MCP |
社交读取复用现有 OAuth MCP 连接。每次 execute 是一条预付费任务，价格为 6、12、30 或 60 credits。没有公开 Social REST API。
共享契约
上表中每个创作或理解调用都是计费的，并返回异步任务：202 + Task envelope，
用 beatra.tasks.get（或 GET /v1/tasks/{task_id}）轮询到终态。发现与管理类
读取（音色、模型、任务）为同步调用。完整生命周期——envelope 结构、取消、退款——在
异步任务中定义一次，适用于每一行。