# API Playground

> 认证、上传、转写,三步走完整条管线。演示模式在本地生成 curl 与示例响应,不发网络请求;切到「真实调用」后,各步直接请求 https://ikho.cn/developer/api 线上接口。

演示模式
  真实调用

Playground 当前为演示模式:所有「运行」按钮只在本地生成请求命令与示例响应,不会调用线上接口。内测账号开通后,可切换上方「真实调用」,或把生成的 curl 命令在你自己的终端里执行。
真实调用会消耗你的内测额度;凭证仅保存在本页内存,不落 localStorage。接口地址 https://ikho.cn/developer/api,错误响应将原样展示契约错误体。

  
    
## 1 · 认证

    签发用户级令牌,用于绑定设备与上传文件。

    
      
        
Client ID

        
Client Secret

        
User ID

        运行
      

      
        

  获取合作方令牌

  curl
  

  ``

        

  响应演示响应

  json
  

  `{}`

        

  获取用户令牌

  curl
  

  ``

        

  响应演示响应

  json
  

  `{}`

      

    

  

  

  
    
## 2 · 上传 S1 录制的音频

    用用户令牌把设备同步下来的音频分片上传到 iKho 存储,拿到下载地址。

    
      
        
          
        

        
          模拟录音
          00:00
        
        
          选择音频文件(真实上传)
          

          
文件大小(字节)

          文件格式
          mp3 / m4a / wav

          运行
        

      

      
        

  生成预签名上传地址

  curl
  

  ``

        

  响应演示响应

  json
  

  `{}`

        

  分片直传(终端等效命令)

  curl
  

  ``

        

  分片上传结果演示响应

  json
  

  `{}`

        

  合并分片完成上传

  curl
  

  ``

        

  响应演示响应

  json
  

  `{}`

      

    

  

  

  
    
## 3 · 转写上传的文件

    把下载地址交给转写 API,异步拿回带说话人与时间戳的逐字稿。

    
      
        
API Key

        转写模型
        ikho-asr-pro / ikho-asr-fast

        发起转写
        查询结果
      

      
        

  提交转写任务

  curl
  

  ``

        

  响应演示响应

  json
  

  `{}`

        

  查询转写任务

  curl
  

  ``

        

  响应演示响应

  json
  

  `{}`