快速开始
三步：提交、查询、下载
接口地址 https://api.bb.movie/v1，请求头带上 Authorization: Bearer 你的Key（在控制台创建）。生成是异步的：提交后拿到任务号，轮询状态，完成后下载。
curl https://api.bb.movie/v1/video/wan \
-H "Authorization: Bearer $BBM_KEY" -H "Content-Type: application/json" \
-d '{"image":"<首帧 base64>","describe":"女人端起冒着热气的茶杯慢慢喝了一口。固定镜头。"}'
# 返回
{"id":"4e570d5e…","model":"wan","status":"queued","queue_position":2}
模型与接口
| 接口 | 用途 | 主要参数 |
|---|---|---|
| POST /v1/video/ltx | 图生视频，有声 | image, describe 或 prompt, frames（8k+1，默认 121） |
| POST /v1/video/wan | 图生视频，无声 | image, describe 或 prompt, frames（4k+1，默认 81） |
| POST /v1/video/h3 | 图生视频，有声 | image, last_image, describe, duration（5–15）, quality（fast / standard） |
| POST /v1/video/wan-dub | 配音对口型 | image, describe, mode, lines |
| POST /v1/audio/tts | 单独配音 | text, speaker 或 instruct |
describe 写中文：动作、谁说什么、用什么口音、镜头动不动。我们按每个模型的官方写法改写，任务详情里返回实际使用的提示词。使用 MiniMax H3 生成的内容，产品界面须标注“MiniMax H3”。
配音对口型
{
"image": "<首帧 base64>",
"mode": "tts", // tts 我们配音 | upload 自带录音 | none 只要音效
"describe": "理疗师俯身说话，客人继续打字。固定镜头。",
"lines": [
{"speaker":"left", "text":"姐，把手机放一哈嘛。", "voice":"二十出头的女性，温柔，重庆话"},
{"speaker":"right", "text":"不得行，屋头离不开我。", "voice":"三十多岁女性，略沙哑，重庆话"}
]
}
left / right 指首帧里从左到右的人，系统自动找人脸分配口型。有台词时单段最长 10 秒。不支持声音克隆。
查询与下载
GET /v1/jobs/{id} # queued / running / done / failed，含 charge_cny
GET /v1/jobs/{id}/result # 下载成片（保留 72 小时）
GET /v1/usage # 余额与用量汇总
GET /v1/models # 你的账号可用的模型与每秒单价
计费规则
成功生成按视频秒数乘模型单价扣费，不论是否符合预期。平台故障导致的失败不收费。参数或内容不合规的请求在提交时直接拒绝，不产生费用。余额为 0 时无法提交新任务。