API 文档 · 炳火 API

For Customers

客户只使用 `bh_` 令牌，不接触上游 `sk-` 密钥。

所有请求都从炳火 API 发起：系统先校验客户令牌和余额，再转发到上游视频生成接口。创建任务会扣除积分；查询和下载不扣积分。

AUTHAuthorization

鉴权方式

在控制台创建客户令牌后，将令牌放入请求头。令牌只显示一次，请保存到插件或服务端。

Authorization: Bearer bh_xxxxxxxxx

GET/api/v1/account

查询余额

用于插件启动前检查客户余额、计费单位和当前视频任务成本。

curl https://api.7tai.cc/api/v1/account \
  -H "Authorization: Bearer bh_xxx"

POST/api/v1/video/generations

创建视频任务

兼容上游异步视频生成思路。常用场景是字字动画图生视频：提交提示词、模型和首帧图片，返回 task_id 后轮询状态。

model必填。模型 ID，如 seedance-2.0+16:9+1080+5prompt必填。视频提示词，可包含参考素材占位符image可选。字字插件常用首帧图片文件image_url可选。远程首帧图片地址，服务端代取并上传input_reference[]可选。参考图文件，可重复上传video_reference[]可选。参考视频文件，可重复上传audio_reference可选。参考音频文件metadata可选。JSON 字符串，如 negative_prompt、style、quality_level

curl -X POST https://api.7tai.cc/api/v1/video/generations \
  -H "Authorization: Bearer bh_xxx" \
  -F "model=seedance-2.0+16:9+1080+5" \
  -F "prompt=镜头缓慢推进，人物回头，电影感光影" \
  -F "image=@first-frame.png"

POST/api/v1/video/generations

参考图 / 首尾帧示例

需要多参考素材时，按上游规则在 prompt 中写入占位符，并上传对应文件字段。

curl -X POST https://api.7tai.cc/api/v1/video/generations \
  -H "Authorization: Bearer bh_xxx" \
  -F "model=seedance-2.0+16:9+1080+5" \
  -F "prompt=让<<<image_0>>>的人物在海边奔跑，风格参考<<<image_1>>>" \
  -F "input_reference[]=@person.png" \
  -F "input_reference[]=@style.png" \
  -F "metadata={\"negative_prompt\":\"模糊、变形\",\"quality_level\":\"high\"}"

GET/api/v1/video/generations/:task_id

查询任务状态

创建任务后保存 task_id，轮询该接口获取进度、状态和上游返回字段。

curl https://api.7tai.cc/api/v1/video/generations/task_123 \
  -H "Authorization: Bearer bh_xxx"

GET/api/v1/videos/:task_id/content

下载视频内容

任务完成后下载 MP4。建议业务侧保存到自己的对象存储或本地目录。

curl -L https://api.7tai.cc/api/v1/videos/task_123/content \
  -H "Authorization: Bearer bh_xxx" \
  -o result.mp4

PLUGIN字字动画

字字插件参数

插件读取当前作品分镜，优先取视频提示词，其次取图片提示词或文案。客户在插件 UI 中填写以下内容。

API 地址https://api.7tai.cc 客户令牌控制台创建的 bh_ 令牌分镜选择要生成视频的分镜 图片 URL / 本机图片路径首帧素材二选一

客户只使用 bh_ 令牌，不接触上游 sk- 密钥。