BeefAPI创建视频任务
提交 JSON 视频请求并保存异步任务 ID。
POST https://enterprise.beefapi.com/v1/videos
使用企业 Key 的 Bearer 认证和 Content-Type: application/json。请求会创建任务并可能预留企业额度。此接口不使用文本 SSE，不要发送 stream: true。
Seedance 最小请求
curl --fail-with-body https://enterprise.beefapi.com/v1/videos \
-H "Authorization: Bearer $BEEFAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"seedance-2.0-mini","prompt":"阳光穿过树叶，镜头缓慢推近","seconds":"5","metadata":{"resolution":"720p","ratio":"16:9"}}'按型号选择字段
| 字段 | Seedance | Grok 视频 |
|---|---|---|
model | 四个 Seedance ID 之一 | grok-imagine-video-1.5 |
prompt | 必填非空文本 | 必填非空文本 |
| 时长 | seconds: "5"，或顶层 duration: 5 / -1 | 顶层 duration，整数 1–15，参考模式 ≤10 |
| 分辨率 | 顶层或 metadata.resolution，按型号限制 | 顶层 resolution |
| 比例 | metadata.ratio | 顶层 aspect_ratio |
| 首帧 | image 或 content 角色项 | image |
| 多参考图 | content 中 reference_image | reference_images |
不要一次混用两类模型的素材结构。完整能力、组合限制与示例见 Seedance 和 视频生成。
返回任务
成功响应返回任务对象。示例（ID、时间均为示例值）：
{"id":"task_example","object":"video","model":"seedance-2.0-mini","status":"queued","progress":0,"created_at":1790000000}保存真实 id，随后使用 查询视频任务。不要把任务 ID 当作可下载文件地址。
提交异常
400 常见于素材组合、时长或分辨率错误；401/403 检查 Key；余额不足时检查企业钱包及预扣需求。若创建请求超时但无法确认是否执行，先查控制台记录并保留 Request ID，不要自动重提。
请求中设置相同提示词或模型不会让多次提交自动合并为同一个任务。应用应保存创建结果，防止用户重复点击造成多次生成。