# 术语表

> 开发者平台文档中反复出现的核心术语,按平台与账号、设备与连接、文件与转写、生态四组归纳,每条附出处页面。

开发者平台处于内测阶段,术语口径以联调时提供的正式文档为准。本页定义与文档各页用法一致,遇到不确定的概念,可从「出处」一列进入对应页面查看完整上下文。

## 平台与账号

| 术语 | 一句话定义 | 出处 |
|---|---|---|
| 合作方应用 | 接入 Embedded 的你的应用。接入后可绑定用户的 iKho 设备,并调用转写引擎驱动你的业务场景。 | [Embedded 总览](/docs/embedded/overview/) |
| Client ID / Client Secret | 应用级凭证,由对接工程师开通时发放。以 Basic 鉴权换取合作方令牌;Secret 仅保存在你的后端,切勿随包下发。 | [获取合作方令牌](/docs/api-reference/auth/get-partner-token/) |
| API Key | 调用转写 API 的凭证,内测期由对接工程师随开通邮件发放;与 Client ID 配对使用:client_id 经 `X-Client-Id` 头、API Key 经 `X-Client-Api-Key` 头传入,不同于 Client Secret。 | [提交音频转写](/docs/api-reference/transcription/submit/) |
| 合作方令牌 | 应用级令牌,用 Client ID 与 Client Secret 换取,有效期约 2 小时;用于签发用户令牌,可通过 `refresh_token` 续期。 | [认证 API 总览](/docs/api-reference/auth/overview/) |
| 用户令牌 | 用户级令牌,由合作方令牌签发,携带你系统里的用户标识,有效期在签发时指定(教程示例为 24 小时);交给 Embedded SDK 绑定设备,也用于文件上传接口鉴权。 | [获取用户令牌](/docs/api-reference/auth/get-user-token/) |

## 设备与连接

| 术语 | 一句话定义 | 出处 |
|---|---|---|
| S1 录音卡 | 卡片式随身录音设备:多麦克风阵列、BLE + Wi-Fi 双通道同步、加密本地存储、长续航(以量产规格为准);2026 Q3 量产,Embedded 内测同步开放。 | [iKho 硬件](/docs/embedded/devices/) |
| MDS 移动数据站 | 影视飓风联名款,小米有品在售;承担对话采集与存储扩展,适合桌面与移动场景。 | [iKho 硬件](/docs/embedded/devices/) |
| Embedded SDK | 集成进你移动应用的 SDK(内测先支持 iOS),负责扫描、加密绑定、读取设备状态,以及把设备上的录音同步到手机。 | [iOS SDK](/docs/embedded/ios-sdk/) |
| 绑定 | 把用户的 iKho 设备与你的应用关联;一台 S1 同一时间只能绑定一个应用,绑定后你的凭证用于该用户数据的加密、解密与同步。 | [工作原理](/docs/embedded/how-it-works/) |
| BLE 同步 | 设备默认的连接方式:通过 BLE(低功耗蓝牙)与你的应用配对,并同步音频文件。 | [工作原理](/docs/embedded/how-it-works/) |
| Wi-Fi 快传 | BLE 之外面向大文件的同步通道,在设备与手机之间建立直连,速度比 BLE 快约一个数量级;需申请热点权限,失败自动回退 BLE。 | [工作原理](/docs/embedded/how-it-works/) |

## 文件与转写

| 术语 | 一句话定义 | 出处 |
|---|---|---|
| 预签名上传地址 | 已预授权的分片上传地址(`PresignedUrl`),把分片的原始字节直接 `PUT` 上去即可,无需再带鉴权头。 | [生成预签名上传地址](/docs/api-reference/file/generate-presigned-urls/) |
| 分片上传 | 把音频按 `ChunkSize` 切片逐片上传,保存每片响应头里的 `ETag`,最后提交分片信息合并成一个文件。 | [文件上传 API 总览](/docs/api-reference/file/overview/) |
| `DownloadUrl` | 合并分片后返回的预签名下载地址,有效期约 24 小时;作为 `file_url` 交给转写 API。 | [合并分片完成上传](/docs/api-reference/file/complete-upload/) |
| 转写任务 | 提交音频后创建的异步任务,以 `transcription_id` 标识;`SUCCESS` 表示结果就绪,`FAILURE`、`REVOKED` 为终态失败。 | [转写 API 总览](/docs/api-reference/transcription/overview/) |
| 轮询 | 按 `transcription_id` 周期性查询任务状态,直到进入终态;`PENDING`、`RECEIVED`、`STARTED`、`PROGRESS` 表示进行中,继续轮询。 | [查询转写任务](/docs/api-reference/transcription/get-task/) |
| 说话人分离 | 自动区分并标注不同发言人;开启后逐字稿片段带 `speaker` 标签,可选返回说话人声纹向量。 | [转写 API 总览](/docs/api-reference/transcription/overview/) |
| 时间戳 | 逐字稿每个片段的毫秒级起止时间(`start_ms` / `end_ms`),便于把文本对齐到音频回放位置。 | [查询转写任务](/docs/api-reference/transcription/get-task/) |
| `ikho-asr-pro` | 精度优先的转写模型,适合会议纪要、医疗随访、销售拜访等对准确度要求高的长音频。 | [转写 API 总览](/docs/api-reference/transcription/overview/) |
| `ikho-asr-fast` | 时延优先的转写模型,适合需要尽快拿到结果的场景,如门店巡检速记。 | [转写 API 总览](/docs/api-reference/transcription/overview/) |

## 生态

| 术语 | 一句话定义 | 出处 |
|---|---|---|
| iKho 智能引擎 | iKho 智能能力的统称,在转写之上生成摘要、待办事项与关键议题等笔记。 | [iKho MCP](/docs/mcp-cli/mcp/) |
| MCP | 把外部数据与工具接进 AI 客户端的开放协议;iKho MCP 把你的录音、逐字稿与智能笔记提供给任何兼容 MCP 的客户端,数据全程走境内节点。 | [iKho MCP](/docs/mcp-cli/mcp/) |
| iKho CLI | 随 `@ikho/mcp` 包附带的 `ikho` 命令行工具,在终端里浏览、搜索、读取逐字稿与下载录音。 | [iKho CLI](/docs/mcp-cli/cli/) |
| `llms.txt` | 本文档站生成的机器可读索引,列出各页地址与简介,便于 AI 工具抓取与引用文档内容。 | [llms.txt](/docs/llms.txt) |
| 演示模式(Playground) | API Playground 的运行方式:「运行」按钮只在本地生成 curl 命令与示例响应,不会发出真实网络请求。 | [API Playground](/docs/embedded/playground/) |