参考
术语表
开发者平台文档中反复出现的核心术语,按平台与账号、设备与连接、文件与转写、生态四组归纳,每条附出处页面。
开发者平台处于内测阶段,术语口径以联调时提供的正式文档为准。本页定义与文档各页用法一致,遇到不确定的概念,可从「出处」一列进入对应页面查看完整上下文。
本页同时收录已开放与规划中的能力:服务端三组接口(认证 / 文件上传 / 转写)现已可用;设备 SDK、绑定与同步、MCP 服务与命令行工具规划中,尚未开放,对应术语描述的是开放后的形态,词条内已逐条标注。
平台与账号
| 术语 | 一句话定义 | 出处 |
|---|---|---|
| 合作方应用 | 接入 Embedded 的你的应用。接入后可绑定用户的 iKho 设备,并调用转写引擎驱动你的业务场景。 | Embedded 总览 |
| Client ID / Client Secret | 应用级凭证,由对接工程师开通时发放。以 Basic 鉴权换取合作方令牌;Secret 仅保存在你的后端,切勿随包下发。 | 获取合作方令牌 |
| API Key | 调用转写 API 的凭证,内测期由对接工程师随开通邮件发放;与 Client ID 配对使用:client_id 经 X-Client-Id 头、API Key 经 X-Client-Api-Key 头传入,不同于 Client Secret。 | 提交音频转写 |
| 合作方令牌 | 应用级令牌,用 Client ID 与 Client Secret 换取,有效期约 2 小时;用于签发用户令牌,可通过 refresh_token 续期。 | 认证 API 总览 |
| 用户令牌 | 用户级令牌,由合作方令牌签发,携带你系统里的用户标识,有效期在签发时指定(教程示例为 24 小时);交给 Embedded SDK 绑定设备,也用于文件上传接口鉴权。 | 获取用户令牌 |
设备与连接
| 术语 | 一句话定义 | 出处 |
|---|---|---|
| S1 录音卡 | 卡片式随身录音设备:多麦克风阵列、BLE + Wi-Fi 双通道同步、加密本地存储、长续航(以量产规格为准);2026 Q3 量产,接入你自己应用的 SDK 规划中。 | iKho 硬件 |
| MDS 移动数据站 | 影视飓风联名款,小米有品在售;承担对话采集与存储扩展,适合桌面与移动场景。 | iKho 硬件 |
| Embedded SDK(规划中) | 集成进你移动应用的 SDK,负责扫描、加密绑定、读取设备状态,以及把设备上的录音同步到手机。尚未开放,文档描述的是开放后的接口形态。 | iOS SDK |
| 绑定(规划中) | 把用户的 iKho 设备与你的应用关联;一台 S1 同一时间只能绑定一个应用,绑定后你的凭证用于该用户数据的加密、解密与同步。随设备 SDK 开放后适用。 | 工作原理 |
| BLE 同步(规划中) | 设备默认的连接方式:通过 BLE(低功耗蓝牙)与你的应用配对,并同步音频文件。随设备 SDK 开放后适用。 | 工作原理 |
| Wi-Fi 快传(规划中) | BLE 之外面向大文件的同步通道,在设备与手机之间建立直连,速度比 BLE 快约一个数量级;需申请热点权限,失败自动回退 BLE。随设备 SDK 开放后适用。 | 工作原理 |
文件与转写
| 术语 | 一句话定义 | 出处 |
|---|---|---|
| 预签名上传地址 | 已预授权的分片上传地址(PresignedUrl),把分片的原始字节直接 PUT 上去即可,无需再带鉴权头。 | 生成预签名上传地址 |
| 分片上传 | 把音频按 ChunkSize 切片逐片上传,保存每片响应头里的 ETag,最后提交分片信息合并成一个文件。 | 文件上传 API 总览 |
DownloadUrl | 合并分片后返回的预签名下载地址,有效期约 24 小时;作为 file_url 交给转写 API。 | 合并分片完成上传 |
| 转写任务 | 提交音频后创建的异步任务,以 transcription_id 标识;SUCCESS 表示结果就绪,FAILURE、REVOKED 为终态失败。 | 转写 API 总览 |
| 轮询 | 按 transcription_id 周期性查询任务状态,直到进入终态;PENDING、RECEIVED、STARTED、PROGRESS 表示进行中,继续轮询。 | 查询转写任务 |
| 说话人分离 | 自动区分并标注不同发言人;开启后逐字稿片段带 speaker 标签,可选返回说话人声纹向量。 | 转写 API 总览 |
| 时间戳 | 逐字稿每个片段的毫秒级起止时间(start_ms / end_ms),便于把文本对齐到音频回放位置。 | 查询转写任务 |
ikho-asr-pro | 精度优先的转写模型,适合会议纪要、医疗随访、销售拜访等对准确度要求高的长音频。 | 转写 API 总览 |
ikho-asr-fast | 时延优先的转写模型,适合需要尽快拿到结果的场景,如门店巡检速记。 | 转写 API 总览 |
生态
| 术语 | 一句话定义 | 出处 |
|---|---|---|
| iKho 智能引擎 | iKho 智能能力的统称,在转写之上生成摘要、待办事项与关键议题等笔记。面向开发者平台的笔记类接口规划中,当前对外开放的是转写。 | 转写 API 总览 |
| MCP(规划中) | 把外部数据与工具接进 AI 客户端的开放协议;iKho MCP 计划把你的录音、逐字稿与智能笔记提供给兼容 MCP 的客户端。该服务尚未开放,开放时间与接入方式以开通邮件为准。 | iKho MCP |
| iKho CLI(规划中) | 规划中的命令行工具,开放后可在终端里浏览、搜索、读取逐字稿与下载录音。尚未发布,包名与安装方式在开放时公布;在此之前请不要按任何来源的安装命令自行安装同名包。 | iKho CLI |
llms.txt | 本文档站生成的机器可读索引,列出各页地址与简介,便于 AI 工具抓取与引用文档内容。 | llms.txt |
| 演示模式(Playground) | API Playground 的运行方式:「运行」按钮只在本地生成 curl 命令与示例响应,不会发出真实网络请求。 | API Playground |
这一页有帮助吗?
已在此浏览器记录,谢谢。