创建文件转录
POST
https://openapi.myvocal.ai/asr/v1/transcriptions
鉴权与输入
API-Key 请求头传入企业 ASR Key。请求体使用 multipart/form-data。model_id 必填；file 与 cloud_url 为两种输入方式，二选一。上传本地文件时使用 file，使用云端音频地址时使用 cloud_url。不要同时提交两种输入。echo_v2_medical 的基本接入示例使用文件上传。参数阅读顺序
speaker_diarization；兼容写法 diarize 也可使用，请避免在同一请求中混用。角色识别需先启用说话人分离，或提供有效的正数 speakers；不能与多声道独立转写组合使用。返回结果
text，逐词信息读取 words；启用说话人功能时，词项可能包含 speaker_id。字段可能随模型和参数而变化，客户端应兼容缺省字段及新增字段。错误处理
| 返回 | 含义 | 处理方式 |
|---|---|---|
| HTTP 401 | Key 无效或缺少鉴权 | 检查 API-Key 请求头 |
HTTP 400 / missing_input | 缺少音频输入 | 上传文件或提供可读取的云端地址 |
HTTP 400 / validation_error | 模型或参数不合法 | 按错误消息检查字段及组合 |
detail.status、detail.message 或 error 提供原因。先判断 HTTP 状态，再读取错误内容。计费与用量
请求参数
Header 参数
Body 参数multipart/form-data
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.myvocal.ai/asr/v1/transcriptions' \
--header 'API-Key: YOUR_API_KEY' \
--form 'model_id="echo_v1"' \
--form 'file=@""'响应示例响应示例
{
"language": "en",
"confidence_score": 0.98,
"text": "Hello.",
"words": [
{
"text": "Hello.",
"start_time": 0,
"end_time": 0.5,
"confidence_score": 0.98,
"token_type": "word"
}
]
}