千问办公企业旗舰版开发者文档:润色语音转写。
认证方式见APP开发者文档 → 认证接入。
Content-Type 为 application/json,整个请求体最多 64 KiB,未知字段不接受。
长度上限按 UTF-8 字节计算。润色固定使用 qwen3.6-flash,关闭思考、temperature=0.1;与聊天档位无关。前后上下文分别保留靠近光标的最多 4000 个字符。上下文只用于理解衔接,不应重复插入;只使用返回的 text 作为本次插入文字。
HTTP 200,Content-Type 为 application/json,Cache-Control 为 no-store。
模型不可用、额度或上游权限错误、限流、超时及空回复等,都回退完整原文,返回 HTTP 200 和 polished=false。HTTP 200 不代表一定完成润色。服务端润色调用预算为 20 秒,客户端应保留完整原文以处理请求失败。
入口认证和请求格式错误不会转换为润色成功:401 / 403 按登录与权限错误处理,400 / 422 等按请求错误处理;请求体过大可能被入口或解析器拒绝。只在转写已完整成功时允许回退原文,不能用局部预览替代。
开始录音时保存输入框版本、当前会话和插入位置。取消、切换会话或编辑输入框时,调用 AbortController.abort() 并使本次操作失效;即使请求已完成,也应在插入前核对操作版本,丢弃迟到结果。取消不触发原文回填。插入文本后由用户确认并发送,不自动提交指令。
- 模块:会话服务(session)
- 接口:POST
/api/openapi/app/v1/sessions/voice-input/polish
请求参数
Content-Type 为 application/json,整个请求体最多 64 KiB,未知字段不接受。
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| transcript | body | string | 是 | 收到转写 finished 后按索引拼接的完整原文,不能全为空白,最多 32 KiB |
| text_before_cursor | body | string | 是 | 光标前上下文,最多 8 KiB,无内容传空字符串 |
| text_after_cursor | body | string | 是 | 光标后上下文,最多 8 KiB,无内容传空字符串 |
| mode | body | string | 否 | 兼容字段,最多 128 字节;不参与润色选模,可以省略 |
响应
HTTP 200,Content-Type 为 application/json,Cache-Control 为 no-store。
| 字段 | 类型 | 说明 |
|---|---|---|
| text | string | 应插入的文本;润色不可用时等于去除首尾空白的 transcript |
| raw_text | string | 完整 transcript(去除首尾空白) |
| polished | boolean | true 表示校对后文字确实发生变化;false 表示无需修改或失败回退 |