# 常见问题

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

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

能力边界:服务端三组接口(认证 / 文件上传 / 转写)现已可用;设备 SDK、Starter App、录音／逐字稿类 MCP 工具与命令行工具规划中,尚未开放。记忆 MCP 的接入方式与所需密钥另见[记忆 MCP 文档](/docs/mcp-cli/mcp/)。

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

## 当前可用范围

  现在到底能用什么?可用的是服务端三组接口:[认证 API](/docs/api-reference/auth/overview/)、[文件上传 API](/docs/api-reference/file/overview/) 与[转写 API](/docs/api-reference/transcription/overview/),host 为 `ikho.cn/developer/api`。按[端到端教程·后端篇](/docs/embedded/tutorial-backend/)可以从签发令牌一路跑到取回逐字稿,不依赖任何未开放的能力。

      尚未开放的是:Embedded SDK(iOS / Android / React Native 桥)、Starter App 模板、录音／逐字稿类 MCP 工具与命令行工具。文档中这些章节写的是开放后的接口形态,便于你提前评估接入成本。记忆 MCP 不属于这些规划中的录音工具,其接入说明见[记忆 MCP 文档](/docs/mcp-cli/mcp/)。

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

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

      动手路径:[端到端教程·后端篇](/docs/embedded/tutorial-backend/);想先看请求与响应结构,可用 [API Playground](/docs/embedded/playground/)。

## 接入与账号

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

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

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

      读文档时请注意区分:服务端三组接口标注现已可用;记忆 MCP 有独立的接入说明。标注规划中的设备 SDK、Starter App、录音／逐字稿类 MCP 工具与 CLI 描述的是开放后的接口形态,现在还不能取用。

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

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

## 设备与 SDK

本组问题涉及的设备 SDK 与绑定能力规划中,尚未开放,答案描述的是开放后的形态;硬件本身真实存在(MDS 已在售,S1 按 2026 Q3 量产计划推进)。

  必须使用 iKho 硬件吗?不必,而且当前可用的正是不依赖硬件的那条路径:你自己的音频来源 + [文件上传 API](/docs/api-reference/file/overview/) + [转写 API](/docs/api-reference/transcription/overview/),按[后端篇](/docs/embedded/tutorial-backend/)就能跑通。

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

  支持安卓吗?三端 SDK 目前都尚未开放:[iOS SDK](/docs/embedded/ios-sdk/)、[Android SDK](/docs/embedded/android-sdk/) 与 [React Native 桥](/docs/embedded/react-native/)均为规划中,文档写的是开放后的接口形态。请到[联系我们](/docs/mcp-cli/contact/)页登记你需要的平台,开放时通过开通邮件通知,并同步更新文档与[更新日志](/docs/embedded/changelog/)。在此之前,安卓侧可以直接调用服务端接口处理你自己的音频。

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

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

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

      设备联调要等 SDK 开放后进行,届时需要一部真机 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/)。

## 计费与商务

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

  「设备连接数」也计费吗?该维度当前尚未计量:设备连接依赖规划中的设备 SDK,SDK 开放后这项额度与计费才适用,口径届时在[计费](/docs/embedded/billing/)页公布。现在唯一在计量的用量维度是转写时长。

  超出免费额度后怎么收费?当前按转写时长按量付费,费用按月结算,单价以商务合同为准。设备连接维度随设备 SDK 开放后适用。详见[计费](/docs/embedded/billing/)。

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

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

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