API 总览

所有示例请求使用 https://enterprise.beefapi.com。先按认证与密钥配置 Key，再选择模型支持的协议。

文本与目录

接口存在不代表每个模型都支持它；例如视频模型不能用于文本对话。工具、结构化输出、图像理解及其他可选参数需要按所选模型确认。

方法	路径	说明
POST	`/v1/videos`	创建视频任务
GET	`/v1/videos`	列出当前企业 Key 创建的 Seedance 任务，见列表与删除
GET	`/v1/videos/{task_id}`	查询任务
GET	`/v1/videos/{task_id}/content`	下载结果
DELETE	`/v1/videos/{task_id}`	取消排队中的任务或隐藏已完成结果，见列表与删除

视频创建返回任务 ID，不会立即返回完整视频。Seedance、Grok 与可灵的参数结构不同，分别参考 Seedance 和视频生成。

这三类都是同步调用：图片返回临时地址，语音与音乐返回音频字节（音乐可能以 302 跳到临时地址），转写返回文本或字幕。计费单位各不相同，见用量与计费。

方法	路径	说明
GET	`/v1/usage`	当前 Key 的人民币用量汇总
GET	`/v1/usage/requests`	按请求查看结算记录

这些接口以认证 Key 为范围，不返回整个企业钱包余额，也不代替充值订单查询。企业余额和充值记录在钱包查看。

非流式文本请求返回 JSON。流式文本使用 SSE，各协议事件结构不同。视频状态查询返回 JSON，视频下载返回文件或重定向。用量返回金额字符串，按 currency: CNY 处理，不要把金额当作内部额度值再次换算。

错误响应可能是 error 对象，也可能是认证阶段的 success: false 和 message。先检查 HTTP 状态，再检查响应正文，保留请求标识。处理方法见错误排查。媒体接口的上游错误会带上游错误码与中文说明，音乐与语音还可能在生成未完成时提示重试。

图片、语音与音乐的型号开放范围分别见图片能力、语音合成与音乐和语音识别。