字幕翻译

字幕翻译功能用于处理已有的SRT字幕文件，将其从源语言翻译为目标语言。

使用场景：

已有字幕文件，仅需翻译服务

需要快速获取多语言字幕版本

无需视频处理，仅需字幕文件

处理流程：

上传SRT文件：将原始字幕文件上传至平台

指定语言：设置源语言与目标语言

专有名词处理：系统自动识别并建议专有名词翻译方案

字幕翻译：系统执行翻译处理

下载结果：获取翻译后的SRT文件

确保上传的SRT文件格式正确

检查并修正专有名词翻译可提高翻译准确性

若是连续剧集，字幕文件命名必须包含序号（顺序命名，如短剧名1.srt、短剧名2.srt；），确保系统能正确识别剧集顺序。

字幕翻译API流程示例

本文档提供了SRT字幕翻译的完整API流程示例，包括创建项目、上传SRT文件、创建翻译任务、查询结果和下载翻译结果的全流程。

步骤1: 创建项目

响应示例

{
    "code": 10000,
    "message": "创建项目成功",
    "data": {
        "id": "012345ab-cd67-8901-ef23-456789abcdef",
        "name": "纯字幕翻译示例",
        "createTime": "2025-03-26T21:15:01+08:00"
    },
    "trace": {
        "request_id": "0195d297-88e1-737c-b6ec-faec90b43e39",
        "timestamp": 1742994901,
        "take_time": 1
    }
}

步骤2: 上传SRT文件

响应示例

{
    "code": 10000,
    "message": "文件上传成功，资源将在30天内保存",
    "data": {
        "files": [
            {
                "file_id": "0d7f070e-e727-4bf7-8b06-f5baee8dcd1a",
                "file_name": "剧名1.srt",
                "file_type": "srt"
            }
        ],
        "file_set_id": "012345ab-cd67-8901-ef23-456789abcdef",
        "file_set_name": "纯字幕翻译示例"
    },
    "trace": {
        "request_id": "0195d299-6ea3-7256-b003-a1fa29c8436d",
        "timestamp": 1742995026,
        "take_time": 1
    }
}

步骤3: 创建SRT翻译任务

响应示例

{
    "code": 10000,
    "message": "success",
    "data": {
        "id": "123456ab-cd78-9012-ef34-567890abcdef",
        "task_type": "srt_translation",
        "status": 1,
        "original_language": "中文",
        "target_languages": [
            {
                "language": "英语",
                "area": "英国"
            }
        ],
        "created_at": "2025-03-26T12:44:01.000000Z"
    },
    "trace": {
        "request_id": "0195d27b-270f-7290-b7e9-b70bade9becc",
        "timestamp": 1742993041,
        "take_time": 0
    }
}

步骤4: 查询任务状态

响应示例

{
    "code": 10000,
    "message": "success",
    "data": {
        "id": "123456ab-cd78-9012-ef34-567890abcdef",
        "task_order_num": "de04e4059888f0361083d77752fd696b",
        "openapi_user_id": "234567ab-cd89-0123-ef45-678901abcdef",
        "file_set_id": "012345ab-cd67-8901-ef23-456789abcdef",
        "task_type": "srt_translation",
        "status": 2,
        "original_language": "中文",
        "target_languages": [
            {
                "area": "美国",
                "language": "英语"
            }
        ],
        "video_erase_mode": "normal",
        "auto_run": true,
        "translation_style": "technical",
        "style_prompt": "casual",
        "resources": {
            "file_set_name": "SRT字幕翻译示例"
        },
        "subtitle_style": [],
        "callback_url": "",
        "error_message": null,
        "result": true,
        "started_at": "2025-03-26T08:43:52.000000Z",
        "completed_at": null,
        "created_at": "2025-03-26T08:43:52.000000Z",
        "updated_at": "2025-03-26T08:43:52.000000Z",
        "deleted_at": null,
        "consumed_points": 1216,
        "message": "成功"
    },
    "trace": {
        "request_id": "0195d1fb-73ad-73b0-bedd-2ef9416dce3c",
        "timestamp": 1742984672,
        "take_time": 0
    }
}

完整流程总结

通过以上步骤，可以完成从创建项目、上传SRT文件、创建翻译任务、查询状态的完整SRT字幕翻译流程。

字幕翻译中间结果编辑与确认流程指南

在字幕翻译过程中，我们提供了灵活的编辑和确认机制，允许用户在关键节点审核和修改中间结果，以确保最终翻译质量。以下是详细说明：

中间结果编辑与确认机制

设置任务确认模式

在创建字幕翻译任务时，您可以通过auto_run参数控制任务的执行方式：

自动执行模式 (auto_run=1，默认值)：全流程自动执行，无需确认也无法编辑中间结果

手动确认模式 (auto_run=0)：在关键节点暂停任务，等待人工审核和确认

可编辑的关键节点

在手动确认模式下，任务会在以下关键节点暂停等待确认：

本土化内容处理后：可调整本土化的处理结果

翻译内容生成后：可编辑和优化翻译结果

编辑与确认流程

创建任务：设置auto_run=0启用手动确认模式

{
  "task_type": "srt_translation",
  "original_language": "中文",
  "target_languages": [{"language":"英语", "area":"英国"}],
  "auto_run": 0,
  // 其他参数...
}

节点暂停：任务在关键节点处理完成后自动暂停

获取中间结果：调用任务详情接口查看中间结果的详情

获取视频翻译任务详情

GET /api/narrator/ai/v1/videoTasks/{id}

编辑中间结果：调用相应节点的编辑更新接口修改内容

本土化内容/翻译内容编辑接口

POST /api/narrator/ai/v1/videoTasks/update/{task_id}/srt/content

确认继续执行：完成编辑后，调用通用确认接口让任务继续执行

POST /api/narrator/ai/v1/confirm/task/flow/{taskId}

重要注意事项

确认不可逆：任务确认继续执行后，无法返回上一步进行修改，请确保在确认前仔细检查结果

编辑时机：只有在任务处于暂停状态且对应节点已完成处理时，才能编辑该节点的结果

效率与质量平衡：手动确认模式可提高翻译质量但会延长处理时间，请根据实际需求选择适当模式

最佳实践建议

对质量要求较高的重要视频，建议使用手动确认模式

在字幕提取阶段重点检查时间轴和专业术语的准确性

在翻译内容阶段关注文化表达和语言流畅度

批量处理大量视频时，可优先使用自动执行模式提高效率

通过合理利用中间结果编辑与确认机制，您可以在保证处理效率的同时，显著提升翻译的质量和准确性。

字幕翻译

字幕翻译#

字幕翻译API流程示例#

步骤1: 创建项目#

响应示例#

步骤2: 上传SRT文件#

响应示例#

步骤3: 创建SRT翻译任务#

响应示例#

步骤4: 查询任务状态#

响应示例#

完整流程总结#

字幕翻译中间结果编辑与确认流程指南#

中间结果编辑与确认机制#

设置任务确认模式#

可编辑的关键节点#

编辑与确认流程#

重要注意事项#

最佳实践建议#

字幕翻译

字幕翻译API流程示例

步骤1: 创建项目

响应示例

步骤2: 上传SRT文件

响应示例

步骤3: 创建SRT翻译任务

响应示例

步骤4: 查询任务状态

响应示例

完整流程总结

字幕翻译中间结果编辑与确认流程指南

中间结果编辑与确认机制

设置任务确认模式

可编辑的关键节点

编辑与确认流程

重要注意事项

最佳实践建议