创建多模态视频理解任务

POST

/v1/tasks/video-understanding

AI 分析视频内容，为后续文案生成提供参考信息。

必填参数：

episodes — 集数列表，每集包含 video_file_id 和 num

可选参数：

frame_interval — 采样间隔（1-60 秒，默认 3 秒，值越小分析越细但费用越高）

api_key — 自定义 API Key（不提供则使用系统 Key，费用更高）

计费：

使用系统 Key：3.8 积分/分钟

使用自定义 Key：0.8 积分/分钟

输出： 视频理解结果 JSON

请求参数

Authorization

API Key

在 header 添加参数

app-key

示例：

app-key: ********************

Header 参数

Body 参数application/json必填

示例

{
    "pipeline_id": "string",
    "callback_url": "string",
    "callback_auth": {
        "type": "bearer",
        "token": "string",
        "header_name": "string",
        "header_value": "string"
    },
    "episodes": [
        {
            "num": 0,
            "video_file_id": "string"
        }
    ],
    "frame_interval": 3,
    "api_key": "string",
    "callback_data": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.jieshuo.cn/v1/tasks/video-understanding' \
--header 'x-code;' \
--header 'app-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pipeline_id": "string",
    "callback_url": "string",
    "callback_auth": {
        "type": "bearer",
        "token": "string",
        "header_name": "string",
        "header_value": "string"
    },
    "episodes": [
        {
            "num": 0,
            "video_file_id": "string"
        }
    ],
    "frame_interval": 3,
    "api_key": "string",
    "callback_data": "string"
}'

返回响应

🟢200OK

application/json

Successful Response

Bodyapplication/json

示例

{
    "code": 10000,
    "message": "Success",
    "data": {
        "task_id": "string",
        "status": 0,
        "estimated_points": 0,
        "message": "Task created"
    }
}

🟠422Parameter Error

修改于 2026-07-10 07:58:13

创建视觉模板视频任务

第一步视频转码