# 常见问题

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

开发者平台处于内测阶段,接口契约以联调时提供的正式文档为准;账号由对接工程师开通,见[联系我们](/docs/mcp-cli/contact/)。

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

## 接入与账号

  Embedded 内测怎么申请?到[联系我们](/docs/mcp-cli/contact/)页提交接入申请,说明你的应用形态与使用场景。对接工程师确认后为你的应用开通 Embedded,并发放 Client ID 与 Client Secret。完整开通步骤见[快速开始](/docs/embedded/quickstart/)。

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

  能不能先看文档,再决定是否接入?可以。文档中心完全公开,SDK 接口形态、API 契约与集成流程都可以先读完再评估,不需要账号。建议从[工作原理](/docs/embedded/how-it-works/)开始,它把 SDK 与各 API 如何拼在一起完整走了一遍;申请开通后才需要凭证。

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

  开通后拿到的凭证,应该怎么保管?Client ID 与 Client Secret 是应用级凭证,secret 只能保存在你的后端,绝不能打进移动应用、网页前端或任何可被反编译的分发包。怀疑泄露时联系对接工程师重置凭证。完整建议见[认证 API 总览](/docs/api-reference/auth/overview/)的令牌安全最佳实践。

## 设备与 SDK

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

  支持安卓吗?[Android SDK](/docs/embedded/android-sdk/) 正在内测排期中,尚未开放。当前请先用 [iOS SDK](/docs/embedded/ios-sdk/) 或 [React Native 桥](/docs/embedded/react-native/)接入;Android 侧接口稳定后会在文档更新,并同步到开通邮件。

  一台设备能同时给两个 App 用吗?不能。一台 S1 同一时间只能绑定一个应用,绑定用于文件加密与安全隔离,设备上的数据只与绑定的应用同步。切换应用前需先在原应用解绑,详见[工作原理](/docs/embedded/how-it-works/)的「绑定与加密」。

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

  开发调试需要准备什么?一部真机 iPhone 与一张 S1 录音卡。SDK 以 arm64 真机框架分发,模拟器不支持设备联调。完整环境要求见 [iOS SDK](/docs/embedded/ios-sdk/)。

## 转写与数据

  转写支持哪些语言?以中文为主力,支持中英混说,英语可用;更多语言正在评估中,以联调时提供的能力说明为准。语言参数支持 `auto` 自动识别,见[提交音频转写](/docs/api-reference/transcription/submit/)。

  说话人分离效果怎么样?转写引擎面向真实对话场景,多人交替发言时能自动区分并标注发言人,可选返回声纹向量。重叠抢话等复杂场景的效果,内测期建议用你的真实音频实测评估。开启方式见[提交音频转写](/docs/api-reference/transcription/submit/)的 `diarization` 参数。

  数据归谁?会被拿去训练吗?数据归接入方与其终端用户。你的用户音频与逐字稿不用于模型训练,存储与传输全程走境内节点。详见[安全与合规](/docs/embedded/security/)。

  转写一段音频要多久?转写是异步任务:提交后拿到任务标识,轮询到 `SUCCESS` 时结果就绪,流程见[查询转写任务](/docs/api-reference/transcription/get-task/)。耗时与音频长度相关,内测期以实测为准;对时延敏感的场景可选 `ikho-asr-fast`。

  数据存在哪里?同步到云端的音频与转写结果存储在境内,传输全程走境内节点,不出境。设备上的音频始终端上加密,只有用户选择同步的内容才会离开设备,详见 [iKho 硬件](/docs/embedded/devices/)与[安全与合规](/docs/embedded/security/)。

## 计费与商务

  免费额度是多少?新接入方有 50 台设备连接 + 300 小时转写的免费额度,足以覆盖联调测试与面向终端用户的小范围试点。详见[计费](/docs/embedded/billing/)。

  免费额度里的「设备连接」怎么计算?按历史唯一设备计:你的应用连接过的每台 iKho 设备计一台,曾经连接过、后来断开的设备仍计入。口径详见[计费](/docs/embedded/billing/)。

  超出免费额度后怎么收费?按连接设备数与转写小时数两个维度按量付费,费用按月结算,单价以商务合同为准。详见[计费](/docs/embedded/billing/)。

  有企业方案吗?有。需要量大折扣、更高限额或专属支持时,可以走企业方案,请通过[联系我们](/docs/mcp-cli/contact/)与团队沟通具体方案。

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

没找到你想问的问题,可以到[联系我们](/docs/mcp-cli/contact/)页直接提问,对接工程师会在联调沟通中答复。