语音转文字 API
上传音频,轮询任务,然后获取带有逐词时间戳和说话人标签的片段,格式为 JSON、TXT 或 SRT。语言可自动识别或按请求指定;Oracle 模型还支持翻译。
快速入门
先创建任务,再读取结果。全部参数见 API 文档。
curl https://app.kolwrite.com/transcribe \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_url": "https://example.com/meeting.m4a",
"model": "oracle",
"language": "he",
"include_diarization": true,
"output_format": "json"}'
{"jobId": "34c63d45-4cb5-473b-bc60-25c175e69c57"}
curl https://app.kolwrite.com/transcribe/34c63d45-4cb5-473b-bc60-25c175e69c57 \
-H "x-api-key: YOUR_API_KEY"
{
"jobId": "34c63d45-4cb5-473b-bc60-25c175e69c57",
"status": "COMPLETED",
"result": {
"language": "he",
"segments": [
{
"start": 0.5,
"end": 3.2,
"speaker": "Speaker 1",
"text": "שלום, נתחיל את הפגישה.",
"words": [{"start": 0.5, "end": 0.8, "word": "שלום"}]
}
]
}
}
API 返回的内容
- JSON 与 SRT 中包含每个词的起止时间。
- 来自说话人分离的说话人标签,或每个物理声道一个标签。
- 在 Oracle 模型上翻译为其他语言。
- JSON、纯文本或 SRT,可按请求选择。
- 任务完成时发送 webhook,或自行轮询任务。
- 自动检测语言,也可按请求指定。
基准测试
在 Google FLEURS 和 Mozilla CommonVoice 上的准确率,越高越好。
Google FLEURS 准确率(%)
定价
按每小时音频计算的用量额度,按任务计费。
1 额度 US$1.20
| 模型 | 额度/小时 |
|---|---|
| Base | 0.40 |
| Oracle Mini | 0.80 |
| Oracle | 1.20 |
| Oracle Pro | 1.40 |
| Oracle Max | 3.00 |
| Core旧版 | 1.00 |
| Edge旧版 | 1.20 |
标准声道说话人分离已包含。重叠语音分离按所选模型费率计费,按录音时长与其各物理声道中检测到的语音总时长中的较大者计算。两种模式均不收取说话人分离附加费。
模型对比
模型选项一览。
| 模型 | 额度/小时 | 摘要 | 最适合 |
|---|---|---|---|
| Base | 0.40 | 低成本转写,含词级时间戳。 | 清晰音频和大批量任务 |
| Oracle Mini | 0.80 | 快速、经济的 Oracle 层级。 | 草稿和高吞吐量任务 |
| Oracle旗舰 | 1.20 | 生产级转写和翻译。 | 兼顾质量、速度和成本 |
| Oracle Pro | 1.40 | 更高质量的 Oracle 层级。 | 高要求的生产音频 |
| Oracle Max | 3.00 | 最高质量的 Oracle 层级。 | 高难度、高风险音频 |
| Core旧版 | 1.00 | 高速旧版通用模型。 | 现有 Core 集成 |
| Edge旧版 | 1.20 | 上一代高准确率模型。 | 现有 Edge 集成 |
获取 API 密钥
先注册账户,再在 API 密钥页面生成密钥。