# 知识节点接口

# 发起音视频内容翻译

对音视频知识节点的当前版本发起 ASR 文稿、AI 知识点、AI 摘要翻译。不传 include 时默认翻译这三类内容;也可显式指定一种或多种内容,幂等可安全重试。显式空数组、未知值和 all 均返回 400。

请求URL

POST https://lxapi.lexiangla.com/cgi-bin/v1/kb/entries/{entry_id}/content-translations

请求头

参数 是否必须 说明
Content-Type 是 固定值:"application/json; charset=utf-8"
Authorization 是 接口调用凭证 access_token
值格式:"Bearer access_token"
示例值:"Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJS"

其他说明

事项 说明
权限要求 AI 助手
授权范围 AppKey绑定团队时,入参entry_id知识需在授权的团队下
频率限制 3000次/分钟

URL 参数说明

参数 是否必须 说明
entry_id 是 知识节点 ID,仅支持音视频类型(entry_type=video/audio)的知识节点

请求参数

{
  "data": {
    "type": "content_translation",
    "attributes": {
      "lang": "ja",
      "include": ["transcript", "knowledge_points", "summary"]
    }
  }
}

参数说明

参数 是否必须 说明
data.type 是 资源类型,固定为 content_translation
data.attributes.lang 是 目标语种代码,最长 20 个字符,可选值见 支持的目标语种
data.attributes.include 否 内容类型字符串数组;不传时默认为 ["transcript", "knowledge_points", "summary"],即翻译 ASR 文稿、AI 知识点与 AI 摘要。显式传入时必须非空且不可重复;未知值、重复值、空数组和 all 均返回 400

# 支持的目标语种

代码 语言
en 英语
zh 中文
ja 日语
ko 韩语
th 泰语
vi 越南语
es 西班牙语
id 印尼语
tl 菲律宾语
hi 印地语
ar 阿拉伯语
fr 法语
de 德语
pt 葡萄牙语
ru 俄语
it 意大利语
nl 荷兰语

响应

200 Ok 状态码,表示本次请求的内容已按项受理;data 为状态资源数组,id 即内容类型。

{
  "data": [
    {
      "type": "content_translation",
      "id": "transcript",
      "attributes": {"status": "finished", "triggered": false}
    },
    {
      "type": "content_translation",
      "id": "knowledge_points",
      "attributes": {"status": "translating", "triggered": true}
    },
    {
      "type": "content_translation",
      "id": "summary",
      "attributes": {"status": "translating", "triggered": true}
    }
  ]
}

参数说明

参数 说明
data[].type 资源类型,固定为 content_translation
data[].id 内容类型:transcript / knowledge_points / summary
data[].attributes.status 该项内容的受理状态。三类内容均可能在 fresh 时直接返回 finished,无需新建翻译任务;实际就绪状态以各自查询接口为准。
transcript:运行中返回 translating;失败后 5 分钟重试窗口内返回 failed,超过窗口可重新触发。
knowledge_points、summary:发起响应仅返回 finished 或 translating;历史失败按待续翻内容处理,实际失败状态通过各自查询接口获取
data[].attributes.triggered 本次请求是否真正新建了该项翻译任务:true 表示本次新建;false 表示译文已 fresh、同任务正在运行等防重命中,本次未新建任务。其中 transcript 还包括失败后 5 分钟重试窗口内的防重命中;knowledge_points、summary 不使用该失败窗口,历史失败会按待续翻内容处理。false 也会显式返回,可据此识别重复触发是否被防重拦截

译文轮询

使用同一个 lang 分别调用原查询接口。AI 摘要和 AI 知识点通过 meta.translation_status 表示翻译状态,未翻译或译文过期时返回 untranslated,不下发原文;ASR 文稿仍按原接口错误语义,在未翻译或译文过期时分别返回 30021006、30021007:

译文内容 获取接口
ASR 文稿 获取音视频解析结果:GET /cgi-bin/v1/kb/entries/{entry_id}/parsed-asr-content?lang=ja
AI 摘要 获取知识节点的 AI 摘要:GET /cgi-bin/v1/kb/entries/{entry_id}/summary?lang=ja
AI 知识点 获取知识节点的 AI 知识点:GET /cgi-bin/v1/kb/entries/{entry_id}/knowledge-points?lang=ja

多个内容的投递不是原子操作;任一环节失败时,其他内容可能已受理,调用方可使用相同参数幂等重试。条目不存在、条目类型不允许、转写未完成及语种不支持等情况将返回相应错误。