乐享知识库接口文档 对音视频知识节点的当前版本发起 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 |
多个内容的投递不是原子操作;任一环节失败时,其他内容可能已受理,调用方可使用相同参数幂等重试。条目不存在、条目类型不允许、转写未完成及语种不支持等情况将返回相应错误。