跳到正文
联系我们 开始接入
开发者平台BetaiKho EmbeddediKho MCP & CLI
文件上传 API

文件上传 API 总览

把用户在 S1 上录制的音频分片上传到 iKho 存储,合并后拿到下载地址,作为 file_url 交给转写 API。

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

上传流程

音频以分片方式上传,分三步完成:

1
生成预签名上传地址
调用 generate-presigned-urls,按文件大小返回一组预签名地址,每个地址对应一个分片。
2
逐片 PUT 上传
把每个分片的原始字节直接 PUT 到对应的预签名地址(该地址已预授权,无需再带鉴权头)。保存每次响应头里的 ETag。
3
合并分片完成上传
把收集到的 ETag 列表提交给 complete-upload,拿到可下载地址 DownloadUrl,作为 file_url 交给转写 API。

支持格式与限制

  • 支持音频格式:mp3、m4a、wav。
  • 单文件大小与分片大小上限:内测期以联调口径为准。

鉴权

文件上传的两个平台接口都使用用户令牌鉴权(见获取用户令牌)。逐片 PUT 到预签名地址的请求直连存储、不经平台,因此不需要鉴权头,也不在此单列为端点。

文件上传 API 是可选的。如果你已有可公网访问的音频地址,可跳过上传,直接把地址作为 file_url 交给转写 API。