Loading...

    会后根据录制文件的vodId触发文字转写

    功能说明

    若会中做了录制,但未触发文字转写。会后可以调用本接口,根据录制文件内容生成文字转写。

    默认接口请求频率限制:20次/秒。

    实现方法

    REST URL

    POST https://sdk.xylink.com/api/rest/external/v1/transcription/offline/start?enterpriseId=XXX&vodId=XXXsignature=XXX

    请求参数说明:

    参数

    参数类型

    参数位置

    必须

    默认值

    说明

    初始平台

    enterpriseId

    String

    Query

    是

    无

    企业ID,通过管理平台-云视讯API获得

    5.2-20250926

    公有云

    signature

    String

    Query

    签名鉴权1.0(旧):是

    签名鉴权2.0:否

    无

    API签名,参考

    签名鉴权

    5.2-20250926

    公有云

    vodId

    String

    Query

    是

    无

    录制文件 id

    5.2-20250926

    公有云


    srcLang


    String

    body

    否

    zh

    源语言 默认是中文 zh


    5.2-20250926

    公有云

    dstLang

    String

    body

    否

    无

    目标语言,如果不带表示不翻译


    5.2-20250926

    公有云


    示例代码

    请求示例:

    {
    "srcLang": "zh",
    "dstLang": ""
    }

    结果示例:

    action=start:

    {
    "taskId": "example-task-id",
    "aiMode": "EXCLUSIVE",
    "occupyId": "window-id"
    }

    action=stop:

    {}

    重复启动判定为可复用时返回同一 taskId;任务结束后再启动不保证沿用历史 ID。成功表示启动调用成功或复用了任务,不代表转写已完成。aiMode 表示该任务的实际模式,不能用当前授权配置替代;不返回 occupyId。

    action=stop 成功返回 JSON 空对象 {},

    响应参数说明

    以下字段仅在 action=start 成功时返回;

    参数

    参数类型

    说明

    初始平台

    taskId

    String

    任务标识

    公有云不存在

    分区云5.2-20261225

    aiMode

    String

    SHARED / EXCLUSIVE;该任务实际采用的授权模式

    公有云不存在

    分区云5.2-20261225

    occupyId

    String

    授权占用id

    公有云不存在

    分区云5.2-20261225

    请求失败结果示例:

    {
    "developerMessage": "ErrorStatus: INVALID_CLOUD_MEETING_NUMBER enterpriseId is INVALID",
    "userMessage": "invalid cloud meeting number",
    "errorCode": 4117,
    "moreInfo": "http://www.com.ainemo.com/errors/4117"
    }

    以下仅列出该接口业务逻辑错误码,其他错误码见小鱼RESTAPI错误码