视频翻译

视频翻译功能将视频内容从一种语言翻译成另一种语言，是一套完整的翻译解决方案。

核心流程：

上传视频：将源视频上传至平台

字幕提取：系统自动从视频中提取字幕

字幕擦除：擦除视频中原有字幕

字幕翻译：将提取的字幕翻译成目标语言

视频压制：将翻译后的字幕重新添加到视频中

视频需确保为竖屏视频，mp4格式，建议不超过400 MB，否则会上传失败。

字幕文件需为srt文件。

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

主要参数：

源语言与目标语言：支持中文、英语等多种语言

字幕样式：自定义字体、大小、颜色等

最佳实践：

手动检查并修正提取的原始字幕可提高翻译质量

适当调整字幕样式提升观看体验

视频翻译API流程示例

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

视频翻译API流程示例

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

步骤1: 创建项目

响应示例

{
    "code": 10000,
    "message": "创建项目成功",
    "data": {
        "id": 123
        "name": "视频翻译示例",
        "createTime": "2025-03-24T21:16:15+08:00"
    },
    "trace": {
        "request_id": "0195d53d-5139-7209-b8de-2a2d976f9c9d",
        "timestamp": 1742994975,
        "take_time": 1
    }
}

步骤2: 上传视频文件

响应示例

{
    "code": 10000,
    "message": "文件上传成功，资源将在30天内保存",
    "data": {
        "files": [
            {
                "file_id": "012345ab-cd67-8901-ef23-456789abcdef",
                "file_name": "短剧视频01.mp4",
                "file_type": "video"
            }
        ],
        "file_set_id": 184,
        "file_set_name": "视频翻译示例"
    },
    "trace": {
        "request_id": "012345ab-cd67-8901-ef23-456789abcdef",
        "timestamp": 1742995036,
        "take_time": 1
    }
}

步骤3: 创建视频翻译任务

响应示例

{
    "code": 10000,
    "message": "success",
    "data": {
        "id": "012345ab-cd67-8901-ef23-456789abcdef",
        "task_type": "video_translation",
        "status": 1,
        "original_language": "中文",
        "target_languages": [
            {
                "language": "英语",
                "area": "英国"
            }
        ],
        "created_at": "2025-03-26T12:50:21.000000Z"
    },
    "trace": {
        "request_id": "012345ab-cd67-8901-ef23-456789abcdef",
        "timestamp": 1742993421,
        "take_time": 0
    }
}

步骤4: 查询任务状态

响应示例

{
    "code": 10000,
    "message": "success",
    "data": {
        "id": "012345ab-cd67-8901-ef23-456789abcdef",
        "task_order_num": "fe15e5160999g1472094e88863ge707c",
        "openapi_user_id": "789012cd-ef34-5678-gh90-123456abcdef",
        "file_set_id": "456789ab-cd01-2345-ef67-890123abcdef",
        "task_type": "video_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": "视频翻译示例"
        },
        "subtitle_style": [],
        "callback_url": null,
        "error_message": null,
        "result": true,
        "started_at": "2025-03-26T09:15:52.000000Z",
        "completed_at": null,
        "created_at": "2025-03-26T09:15:52.000000Z",
        "updated_at": "2025-03-26T09:15:52.000000Z",
        "deleted_at": null,
        "consumed_points": 1450,
        "message": "成功"
    },
    "trace": {
        "request_id": "012345ab-cd67-8901-ef23-456789abcdef",
        "timestamp": 1742985672,
        "take_time": 0
    }
}

完整流程总结

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

视频翻译中间结果编辑与确认流程指南

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

中间结果编辑与确认机制

设置任务确认模式

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

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

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

可编辑的关键节点

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

字幕提取完成后：可检查和修正提取的原始字幕

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

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

编辑与确认流程

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

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

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

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

获取视频翻译任务详情

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

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

字幕提取编辑接口

POST /api/narrator/ai/v1/videoTasks/update/{srt_id}/originSrt/content

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

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

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

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

重要注意事项

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

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

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

最佳实践建议

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

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

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

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

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

视频翻译

视频翻译#

视频翻译API流程示例#

视频翻译API流程示例#

步骤1: 创建项目#

响应示例#

步骤2: 上传视频文件#

响应示例#

步骤3: 创建视频翻译任务#

响应示例#

步骤4: 查询任务状态#

响应示例#

完整流程总结#

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

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

设置任务确认模式#

可编辑的关键节点#

编辑与确认流程#

重要注意事项#

最佳实践建议#

视频翻译

视频翻译API流程示例

视频翻译API流程示例

步骤1: 创建项目

响应示例

步骤2: 上传视频文件

响应示例

步骤3: 创建视频翻译任务

响应示例

步骤4: 查询任务状态

响应示例

完整流程总结

视频翻译中间结果编辑与确认流程指南

中间结果编辑与确认机制

设置任务确认模式

可编辑的关键节点

编辑与确认流程

重要注意事项

最佳实践建议