快速开始
iKho Embedded 有两个核心组件:转写 API 现已可用,Embedded SDK 规划中。开通内测账号后可以先从服务端接口开始。
开发者平台处于内测阶段,接口契约以联调时提供的正式文档为准;账号由对接工程师开通,见联系我们。
能力边界:本页的开通流程、区域 host 与环境要求适用于服务端三组接口(认证 / 文件上传 / 转写),这部分现已可用。Embedded SDK 与 Starter App 规划中,尚未开放,开放时间以开通邮件为准。
iKho Embedded 有两个核心组件,用来和 iKho 集成:
把用户的 S1 / MDS 设备绑定到你的移动应用。该 SDK 尚未开放,文档描述的是开放后的接口形态。
上传音频文件,并用 iKho 转写引擎(ikho-asr-pro / ikho-asr-fast)转成结构化文本。
开通内测账号
Embedded 目前定向开通。按下面三步拿到你的凭证:
确认接入区域
Embedded API 按区域提供服务,没有全球统一 host。使用你的应用所在区域的 host 发起调用。
| 区域 | 公网 Host | 状态 |
|---|---|---|
| 中国大陆 | https://ikho.cn/developer/api | 内测现役 |
| 中国大陆(独立域名) | platform.ikho.cn/developer/api | 规划中:启用后同契约,现地址 ikho.cn/developer/api 保留兼容 |
| 海外区域 | 规划中 | 规划中 |
系统与版本要求
其中 iOS 与 Xcode 两项在 Embedded SDK 开放后适用;只用服务端三组接口时,只需要一个能发 HTTPS 请求的运行时,教程后端篇用的是 Node.js 20。以下要求与 iOS SDK 页一致,如有更新以正式发布说明为准。
| 项目 | 要求 |
|---|---|
| iOS 部署目标 | iOS 15.0 及以上(以正式发布说明为准) |
| Xcode | 15 及以上 |
| Node.js(服务端示例与工具) | 20 及以上 |
开始构建
当前能完整走通的是第一张卡:纯服务端,不依赖任何未开放的能力。另外两张卡对应的 SDK 与起步应用规划中,现在可以先读接口形态,评估接入成本。
用 Node.js 从零搭一个合作方后端:签发令牌、上传音频、提交转写、取回逐字稿。今天就能跑通。
预置 Embedded SDK 的 iOS 模板。模板与 SDK 均尚未开放,当前作为接口形态参考。
把 Embedded SDK 集成进现有移动应用的接口说明。SDK 尚未开放,开放时通过开通邮件通知。