# 快速开始

> iKho Embedded 有两个核心组件:转写 API 现已可用,Embedded SDK 规划中。开通内测账号后可以先从服务端接口开始。

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

能力边界:本页的开通流程、区域 host 与环境要求适用于服务端三组接口(认证 / 文件上传 / 转写),这部分现已可用。Embedded SDK 与 Starter App 规划中,尚未开放,开放时间以开通邮件为准。

iKho Embedded 有两个核心组件,用来和 iKho 集成:

[Embedded SDK 规划中 把用户的 S1 / MDS 设备绑定到你的移动应用。该 SDK 尚未开放,文档描述的是开放后的接口形态。 查看接口形态](/docs/embedded/ios-sdk/)

[转写 API 现已可用 上传音频文件,并用 iKho 转写引擎(`ikho-asr-pro` / `ikho-asr-fast`)转成结构化文本。 了解转写流程](/docs/embedded/how-it-works/)

## 开通内测账号

Embedded 目前定向开通。按下面三步拿到你的凭证:

  
    1

    联系我们申请
到[联系我们](/docs/mcp-cli/contact/)页提交接入申请,说明你的应用与使用场景。

  

  
    2

    对接工程师开通并发放凭证
对接工程师为你的应用开通 Embedded,并发放 Client ID 与 Client Secret,用于签发合作方令牌与用户令牌;用用户令牌绑定用户设备要等 SDK 开放后适用。

  

  
    3

    创建 API Key
API Key 用于调用转写 API 处理音频文件。内测期由对接工程师随开通邮件发放与重置;开发者控制台上线后可自助管理。

  图示占位API Key 开通与管理流程示意(控制台上线前由对接工程师发放)

  

## 确认接入区域

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](/docs/embedded/ios-sdk/) 页一致,如有更新以正式发布说明为准。

| 项目 | 要求 |
|---|---|
| iOS 部署目标 | iOS 15.0 及以上(以正式发布说明为准) |
| Xcode | 15 及以上 |
| Node.js(服务端示例与工具) | 20 及以上 |

## 开始构建

当前能完整走通的是第一张卡:纯服务端,不依赖任何未开放的能力。另外两张卡对应的 SDK 与起步应用规划中,现在可以先读接口形态,评估接入成本。

[端到端教程·后端篇 现已可用 用 Node.js 从零搭一个合作方后端:签发令牌、上传音频、提交转写、取回逐字稿。今天就能跑通。 开始后端篇教程](/docs/embedded/tutorial-backend/)

[Starter App 指南 规划中 预置 Embedded SDK 的 iOS 模板。模板与 SDK 均尚未开放,当前作为接口形态参考。 查看起步应用形态](/docs/embedded/starter-app-guide/)

[iOS SDK 规划中 把 Embedded SDK 集成进现有移动应用的接口说明。SDK 尚未开放,开放时通过开通邮件通知。 查看 iOS SDK 形态](/docs/embedded/ios-sdk/)