第二步创建 OCR 字幕提取任务

POST

/v1/tasks/ocr-extraction

从视频中识别并提取字幕文件。

必填参数：

file_ids — 视频文件 ID（支持单个或列表）

可选参数：

mode — 识别模式：

bilingual（双语，默认）— 中英文字幕

multilingual（多语种）— 60+ 语言支持

audio（音频识别）— 从音轨提取

language — 目标语言（multilingual/audio 模式，默认 Auto-Detect）

subtitle_position — 字幕位置：auto、top、middle、bottom、custom

time_start / time_end — 提取时间范围（秒，0 表示起始/结束）

计费： 12 积分/分钟

输出： 提取的 SRT 字幕文件

请求参数

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"
    },
    "file_ids": "string",
    "mode": "bilingual",
    "language": "Auto-Detect",
    "subtitle_position": "auto",
    "y_offset_start": 0,
    "y_offset_end": 1,
    "time_start": 0,
    "time_end": 0,
    "callback_data": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.jieshuo.cn/v1/tasks/ocr-extraction' \
--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"
    },
    "file_ids": "string",
    "mode": "bilingual",
    "language": "Auto-Detect",
    "subtitle_position": "auto",
    "y_offset_start": 0,
    "y_offset_end": 1,
    "time_start": 0,
    "time_end": 0,
    "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:59:02

第一步视频转码

第三步创建字幕擦除任务

第二步 创建 OCR 字幕提取任务

请求参数

请求示例代码

返回响应

第二步创建 OCR 字幕提取任务