端点一览

Base URL：https://api.beatra.ai/v1 · 认证与公共 Header 见认证与请求约定。

这个页面是人工阅读索引。Agent 应优先读取下面的机器可读契约，并回链到 operation 页面查看参数细节。

端点

方法	路径	说明	模式
GET	`/v1/models`	模型列表（OpenAI 兼容）	同步
GET	`/v1/catalog/models`	模型目录（含能力元数据）	同步
GET	`/v1/catalog/capabilities`	能力目录	同步
GET	`/v1/catalog/capabilities/{capability}`	能力详情（含各模型的参数与价格）	同步
GET	`/v1/catalog/models/{model}`	模型详情（含支持的能力与价格）	同步
POST	`/v1/images/generations`	文生图	异步
POST	`/v1/images/image-to-image`	图生图	异步
POST	`/v1/images/edits`	图像编辑	异步
POST	`/v1/videos/text-to-video`	文生视频	异步
POST	`/v1/videos/image-to-video`	图生视频	异步
POST	`/v1/videos/reference-to-video`	参考图生视频	异步
POST	`/v1/videos/frames-to-video`	首尾帧生视频	异步
POST	`/v1/videos/edit`	指令与参考图驱动的视频编辑	异步
POST	`/v1/videos/extend`	从源视频结尾继续生成	异步
POST	`/v1/audio/speech`	语音合成	异步
POST	`/v1/voices`	声音克隆	异步
GET	`/v1/voices`	音色列表	同步
GET	`/v1/voices/{voice_id}`	音色详情	同步
DELETE	`/v1/voices/{voice_id}`	删除音色	同步
POST	`/v1/music/text-to-music`	文生音乐	异步
POST	`/v1/music/reference-audio-to-music`	参考音频生音乐	异步
POST	`/v1/uploads`	上传源素材（≤100MB，返回 `artifact_id`）	同步
GET	`/v1/tasks`	任务列表（游标分页）	同步
GET	`/v1/tasks/{task_id}`	任务详情（完整 envelope）	同步
POST	`/v1/tasks/{task_id}/cancel`	取消任务（幂等）	同步
GET	`/v1/health`	健康检查	同步

参数级契约由 OpenAPI 自动生成，从各能力页的"接口定义"链接进入。