主题切换
GEN_VIDEO_ACTIVE_COUNT API 接口文档
🌐 语言切换
接口信息
GET /openapi/capcut-mate/v1/gen_video_active_count功能描述
查询当前排队中与渲染中的导出任务数量，即状态为 pending 或 processing 的任务数；已完成与失败的任务不计入。可在调用 gen_video 前用于判断当前导出压力。
请求参数
本接口无需任何参数。
响应格式
成功响应 (200)
json
{
"code": 0,
"message": "success",
"count": 3
}响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| count | integer | 处于 pending 或 processing 的任务数量 |
错误响应
json
{
"code": 9998,
"message": "系统内部错误"
}使用示例
cURL 示例
1. 查询进行中的导出数量
bash
curl -X GET https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/gen_video_active_count错误码说明
| 错误码 | 错误信息 | 说明 | 解决方案 |
|---|---|---|---|
| 9998 | 系统内部错误 | 统计任务时发生未预期异常 | 稍后重试或联系技术支持 |
注意事项
- 无参数: 本接口没有请求体，也没有查询参数
- 统计范围: 只统计
pending（排队中）与processing（渲染中），不含completed与failed - 免费: 不需要
apiKey - 配合 gen_video 使用: 导出并发有上限，count 较大时新提交的任务排队时间会更长
工作流程
- 读取内存中的导出任务列表
- 统计状态为
pending或processing的任务 - 返回数量