常见问题

可用的是服务端三组接口:认证 API、文件上传 API 与转写 API,host 为 ikho.cn/developer/api。按端到端教程·后端篇可以从签发令牌一路跑到取回逐字稿,不依赖任何未开放的能力。

尚未开放的是:Embedded SDK(iOS / Android / React Native 桥)、Starter App 模板,以及 iKho MCP 与命令行工具。文档中这些章节写的是开放后的接口形态,便于你提前评估接入成本。

不给具体日期。设备 SDK 与 Starter App 目前规划中,开放范围与时间以开通邮件为准。如果你的产品依赖设备侧集成,请到联系我们页登记需求,说明目标平台(iOS / Android / React Native)、设备型号与预计用量;开放时会通过开通时登记的邮箱通知,并同步更新更新日志。

用你自己的音频把转写链路跑通:任何来源的音频文件(手机录音、现有业务录音、iKho 设备导出的文件)都可以走文件上传 API 传到 iKho 存储,再交给转写 API 出稿,拿到带说话人与时间戳的逐字稿。这样一来,你的业务侧逻辑 —— 稿件存储、检索、二次加工、权限 —— 可以先建起来,等 SDK 开放后只需补上设备采集与同步这一段。

动手路径:端到端教程·后端篇;想先看请求与响应结构,可用 API Playground。

到联系我们页提交接入申请,说明你的应用形态与使用场景。对接工程师确认后为你的应用开通 Embedded,并发放 Client ID 与 Client Secret。完整开通步骤见快速开始。

内测期定向开通,开通时间以对接排期为准。提交申请时把应用形态、预计设备用量与期望联调时间写清楚,有助于排期。

可以。文档中心完全公开,API 契约与集成流程都可以先读完再评估,不需要账号。建议从工作原理开始,它把各 API 如何拼在一起完整走了一遍;申请开通后才需要凭证。

读文档时请注意区分:标注现已可用的是服务端三组接口;标注规划中的章节(SDK、Starter App、MCP & CLI)描述的是开放后的接口形态,现在还不能取用。

免费额度内不收接入费。新接入方有 300 小时转写的免费额度,足以覆盖联调测试与小范围试点;超出后走按量付费。设备连接相关的额度与计费在设备 SDK 开放后适用,当前尚未计量。详见计费。

Client ID 与 Client Secret 是应用级凭证,secret 只能保存在你的后端,绝不能打进移动应用、网页前端或任何可被反编译的分发包。怀疑泄露时联系对接工程师重置凭证。完整建议见认证 API 总览的令牌安全最佳实践。

不必,而且当前可用的正是不依赖硬件的那条路径:你自己的音频来源 + 文件上传 API + 转写 API,按后端篇就能跑通。

Embedded 规划中的完整链路是围绕 iKho 硬件设计的:设备采集、加密绑定、双通道同步都以 S1 / MDS 为前提,见 iKho 硬件;这部分要等设备 SDK 开放。

三端 SDK 目前都尚未开放:iOS SDK、Android SDK 与 React Native 桥均为规划中,文档写的是开放后的接口形态。请到联系我们页登记你需要的平台,开放时通过开通邮件通知,并同步更新文档与更新日志。在此之前,安卓侧可以直接调用服务端接口处理你自己的音频。

不能。一台 S1 同一时间只能绑定一个应用,绑定用于文件加密与安全隔离,设备上的数据只与绑定的应用同步。切换应用前需先在原应用解绑,详见工作原理的「绑定与加密」。

可以录。录制过程不依赖网络,音频先加密落在设备本地存储;回到手机附近后,再通过 BLE 或 Wi-Fi 快传同步到你的应用。同步与转写需要网络。

调服务端三组接口:一个能发 HTTPS 请求的运行时就够(教程后端篇用 Node.js 20),加上对接工程师发放的凭证,不需要硬件。

设备联调要等 SDK 开放后进行,届时需要一部真机 iPhone 与一张 S1 录音卡 —— SDK 以 arm64 真机框架分发,模拟器不支持设备联调。环境要求见 iOS SDK。

以中文为主力,支持中英混说,英语可用;更多语言正在评估中,以联调时提供的能力说明为准。语言参数支持 auto 自动识别,见提交音频转写。

转写引擎面向真实对话场景,多人交替发言时能自动区分并标注发言人,可选返回声纹向量。重叠抢话等复杂场景的效果,内测期建议用你的真实音频实测评估。开启方式见提交音频转写的 diarization 参数。

数据归接入方与其终端用户。你的用户音频与逐字稿不用于模型训练,存储与传输全程走境内节点。详见安全与合规。

转写是异步任务:提交后拿到任务标识,轮询到 SUCCESS 时结果就绪,流程见查询转写任务。耗时与音频长度相关,内测期以实测为准;对时延敏感的场景可选 ikho-asr-fast。

同步到云端的音频与转写结果存储在境内,传输全程走境内节点,不出境。设备上的音频始终端上加密,只有用户选择同步的内容才会离开设备,详见 iKho 硬件与安全与合规。

新接入方有 300 小时转写的免费额度,足以覆盖联调测试与面向终端用户的小范围试点。详见计费。

该维度当前尚未计量:设备连接依赖规划中的设备 SDK,SDK 开放后这项额度与计费才适用,口径届时在计费页公布。现在唯一在计量的用量维度是转写时长。

当前按转写时长按量付费,费用按月结算,单价以商务合同为准。设备连接维度随设备 SDK 开放后适用。详见计费。

有。需要量大折扣、更高限额或专属支持时,可以走企业方案,请通过联系我们与团队沟通具体方案。

可以,正式合作后按合同开具。结算周期与开票信息在商务合同中约定。