面向视频产品的 AI Music Video API。

AI Music Video API 会把音频、歌词或 SRT、提示词和参考图片组织成产品可控的视频工作流。BeatAPI 返回任务 ID，暴露生命周期与 Storyboard 状态，并交付托管的镜头媒体和最终 MP4 URL。

原始模型 API 主要生成单个素材。BeatAPI 补齐产品工作流：输入校验、统一任务状态、可编辑 Storyboard、文件持久化、用量记账、轮询与 Webhook、托管输出和支持日志，对外只提供一套 API 契约。

BeatAPI 接收 10–180 秒音频和 1–7 张公开 HTTPS 参考图。可选参数包括提示词、歌词或 SRT、字幕、Lip Sync、风格、画幅、540p/720p/1080p 分辨率、质量和自动或手动合成。本地素材可先上传到 /v1/files。

可以。支持该能力的工作流会返回带稳定 Shot ID 和镜头元数据的有序 Storyboard。你可以获取或编辑一个镜头，再把选中的 Shot ID 合成为新 MP4，无需重启整个任务；每次操作都关联原任务 ID。

创建任务后会返回任务 ID。你可每 5–10 秒轮询 GET /v1/tasks/{task_id} 作为状态事实源，也可添加生命周期 Webhook。状态会区分排队与处理、Storyboard 审核或操作、镜头编辑、合成、成功和失败。

BeatAPI 会在生成任务或 Storyboard 操作被接受时预留或扣除积分，对成功工作进行结算，并退回符合条件的失败用量。费用取决于时长、分辨率、质量、可选 Lip Sync，以及单独的镜头编辑或合成操作；积分账本保留扣除、结算和退回记录。

BeatAPI 会把源输入、上传文件、Storyboard 镜头、编辑与合成操作、状态历史、积分事件、执行日志、托管输出、Webhook 交付、请求 ID 和失败原因关联在一起，让开发与支持团队从请求到交付都只查一条可追溯记录。

BeatAPI 的 AI Ecommerce Video API 会把产品或生活方式图片、营销简报、时长、画幅、语言和创意方向转换为异步短视频广告任务，并与 Music Video 复用同一套任务、文件、积分、Webhook 和托管输出层。

开发者文档包含端点指南、请求与响应 Schema、工作流示例、积分规则、任务状态和 Storyboard 操作。也可下载 /openapi.yaml，将可导入的 API 契约用于代码生成、API 客户端和测试工具。