# iKho 开发者文档

## 页面
- [平台总览](https://ikho.cn/docs/index.md): 用真实对话数据构建你的产品:接入 iKho 的设备 SDK 与转写 API,或通过 MCP 把你的 iKho 数据接进任何 AI 客户端。
- [Embedded 总览](https://ikho.cn/docs/embedded/overview/index.md): iKho Embedded 是开发者平台的一部分:面向想把自己的用户产品,与 iKho 一等公民录音硬件和转写引擎集成的团队。
- [iKho 硬件](https://ikho.cn/docs/embedded/devices/index.md): 为对话型工作打造的录音设备:数据端上加密、由用户决定同步什么、境内存储。
- [快速开始](https://ikho.cn/docs/embedded/quickstart/index.md): iKho Embedded 有两个核心组件:Embedded SDK 与转写 API。开通内测账号后即可开始构建。
- [工作原理](https://ikho.cn/docs/embedded/how-it-works/index.md): 走一遍完整的 Embedded 集成:从认证、绑定设备、同步音频,到上传与转写,理解 SDK 与各 API 如何拼在一起。
- [iOS SDK](https://ikho.cn/docs/embedded/ios-sdk/index.md): 在你的 iOS 应用里集成 iKho Embedded SDK:扫描并绑定 S1 录音卡、读取设备状态、把录音通过 BLE 或 Wi-Fi 同步到手机。
- [Android SDK](https://ikho.cn/docs/embedded/android-sdk/index.md): Android Embedded SDK 正在内测排期中。当前请先用 iOS SDK 或 React Native 桥接入,本页给出 Kotlin 侧的预告接口形态。
- [认证 API 总览](https://ikho.cn/docs/api-reference/auth/overview/index.md): 接入 iKho Embedded 需要两级令牌:应用级的合作方令牌用于签发用户令牌,用户级的用户令牌用于绑定设备与上传文件。
- [获取合作方令牌](https://ikho.cn/docs/api-reference/auth/get-partner-token/index.md): 用 client_id 与 secret 换取应用级的合作方令牌,后续用它为每位用户签发用户令牌。
- [获取用户令牌](https://ikho.cn/docs/api-reference/auth/get-user-token/index.md): 用合作方令牌为你系统里的某位用户签发用户级令牌,交给 Embedded SDK 与文件上传接口使用。
- [刷新合作方令牌](https://ikho.cn/docs/api-reference/auth/refresh-partner-token/index.md): 用有效的 refresh_token 换取新的合作方访问令牌,应在当前令牌到期前刷新。
- [文件上传 API 总览](https://ikho.cn/docs/api-reference/file/overview/index.md): 把用户在 S1 上录制的音频分片上传到 iKho 存储,合并后拿到下载地址,作为 file_url 交给转写 API。
- [生成预签名上传地址](https://ikho.cn/docs/api-reference/file/generate-presigned-urls/index.md): 按文件大小申请一组分片上传用的预签名地址,每个分片一个地址。
- [合并分片完成上传](https://ikho.cn/docs/api-reference/file/complete-upload/index.md): 提交各分片的 ETag,合并为一个文件,拿到可下载地址 DownloadUrl。
- [转写 API 总览](https://ikho.cn/docs/api-reference/transcription/overview/index.md): 把音频提交给 iKho 转写引擎,异步拿回带说话人与逐句时间戳的结构化逐字稿。
- [提交音频转写](https://ikho.cn/docs/api-reference/transcription/submit/index.md): 提交一段音频发起转写任务,返回 transcription_id 用于轮询结果。
- [查询转写任务](https://ikho.cn/docs/api-reference/transcription/get-task/index.md): 按 transcription_id 查询任务状态与结果。进行中持续轮询,SUCCESS 时 data 就绪。
- [API Playground](https://ikho.cn/docs/embedded/playground/index.md): 认证、上传、转写,三步走完整条管线。当前为演示模式:curl 命令真实可拷,响应为本地模拟数据,不会发出网络请求。
- [Starter App 指南](https://ikho.cn/docs/embedded/starter-app-guide/index.md): 用官方 iOS 起步应用几分钟跑通:绑定 S1 录音卡、把录音同步到手机、发起转写并查看逐字稿。
- [Starter App 规格](https://ikho.cn/docs/embedded/starter-app-specs/index.md): 起步应用内置的能力清单、架构概览与目录结构。
- [Web 应用套壳 iOS](https://ikho.cn/docs/embedded/web-app-wrapper/index.md): 已有 Web 产品如何最快上 iOS:用 WKWebView 壳加载你的站点,再原生桥接 Embedded SDK 拿到设备能力。
- [React Native 接入](https://ikho.cn/docs/embedded/react-native/index.md): 通过内测桥模块在 React Native 里复用 Embedded SDK 的设备能力:扫描、绑定、同步。
- [计费](https://ikho.cn/docs/embedded/billing/index.md): Embedded 采用按量计费,随连接设备数与转写小时数两个维度伸缩;新接入方有一档免费额度。
- [更新日志](https://ikho.cn/docs/embedded/changelog/index.md): iKho Embedded 内测期的版本更新记录,倒序排列。
- [iKho MCP](https://ikho.cn/docs/mcp-cli/mcp/index.md): 把 iKho 的录音、逐字稿与智能笔记接进任何兼容 MCP 的 AI 客户端。搜索录音、读取逐字稿、生成文档,全程不离开你的 AI 助手。
- [iKho CLI](https://ikho.cn/docs/mcp-cli/cli/index.md): 在终端里访问你的 iKho 录音:浏览、搜索、读取逐字稿、下载音频、查看智能笔记,无需打开应用。
- [更新日志](https://ikho.cn/docs/mcp-cli/changelog/index.md): iKho MCP 与 CLI 的版本更新记录。
- [联系我们](https://ikho.cn/docs/mcp-cli/contact/index.md): 申请开发者平台内测账号,以及 MCP、CLI 与接入过程中的技术支持。

## OpenAPI 规范
- https://ikho.cn/docs/openapi/auth.json
- https://ikho.cn/docs/openapi/file.json
- https://ikho.cn/docs/openapi/transcription.json