跳到正文
总览

常见问题

关于 iKho Embedded 接入与账号、设备与 SDK、转写与数据、计费与商务的常见问题,按主题分组。

开发者平台处于内测阶段,接口契约以联调时提供的正式文档为准;账号由对接工程师开通,见联系我们

这里汇总接入方最常问的问题,按主题分为四组。答案给出结论与关键口径,细节请随链接进对应页面。

接入与账号

Embedded 内测怎么申请?

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

提交申请后多久能开通?

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

能不能先看文档,再决定是否接入?

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

接入要收费吗?

免费额度内不收接入费。新接入方有 50 台设备连接 + 300 小时转写的免费额度,足以覆盖联调测试与小范围试点;超出后走按量付费。详见计费

开通后拿到的凭证,应该怎么保管?

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

设备与 SDK

必须使用 iKho 硬件吗?

Embedded 的完整链路是围绕 iKho 硬件设计的:设备采集、加密绑定、双通道同步都以 S1 / MDS 为前提,见 iKho 硬件。如果你的场景已有自己的音频来源,只需要纯转写 API,可在申请时说明,由对接工程师联调评估。

支持安卓吗?

Android SDK 正在内测排期中,尚未开放。当前请先用 iOS SDKReact Native 桥接入;Android 侧接口稳定后会在文档更新,并同步到开通邮件。

一台设备能同时给两个 App 用吗?

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

设备离线时还能用吗?

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

开发调试需要准备什么?

一部真机 iPhone 与一张 S1 录音卡。SDK 以 arm64 真机框架分发,模拟器不支持设备联调。完整环境要求见 iOS SDK

转写与数据

转写支持哪些语言?

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

说话人分离效果怎么样?

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

数据归谁?会被拿去训练吗?

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

转写一段音频要多久?

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

数据存在哪里?

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

计费与商务

免费额度是多少?

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

免费额度里的「设备连接」怎么计算?

按历史唯一设备计:你的应用连接过的每台 iKho 设备计一台,曾经连接过、后来断开的设备仍计入。口径详见计费

超出免费额度后怎么收费?

按连接设备数与转写小时数两个维度按量付费,费用按月结算,单价以商务合同为准。详见计费

有企业方案吗?

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

可以开发票吗?

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

没找到你想问的问题,可以到联系我们页直接提问,对接工程师会在联调沟通中答复。