# 中文语音转文字 API

> KolWrite 只需一次 API 调用即可转写普通话音频和视频：发送 "language": "zh"，即可获得带时间戳和说话人标签的中文分段，输出为 JSON、TXT 或 SRT。Oracle 模型还能把中文翻译成英语或其他 99 种语言。

最后更新: 2026-10-08 · HTML: https://console.kolwrite.com/zh/speech-to-text/chinese

## 一次请求转写中文

把 `language` 设为 `zh` 并创建任务。通过 `GET /transcribe/{jobId}` 获取结果，或传入 `webhook_url`。

```bash
curl https://app.kolwrite.com/transcribe \
  -H "x-api-key: $KOLWRITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url": "https://example.com/meeting-zh.m4a", "model": "oracle", "language": "zh", "include_diarization": true, "output_format": "json"}'
```

在同一任务中把中文音频翻译成英语（仅限 Oracle 模型）：

```bash
curl https://app.kolwrite.com/transcribe \
  -H "x-api-key: $KOLWRITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url": "https://example.com/meeting-zh.m4a", "model": "oracle_mini", "language": "zh", "translate_to": "en", "output_format": "srt"}'
```

## 中文速览

| 属性 | 说明 |
| --- | --- |
| API 代码 | `zh` |
| 本地名称 | 中文 |
| 书写方向 | 从左到右 |
| 自动检测 | 支持：省略 `language` 或发送 `"auto"` |
| 中文音频可翻译为 | 100 种支持语言中的任意一种（Oracle 模型） |
| 其他语言翻译成中文 | 支持：在 Oracle 模型上使用 `translate_to: "zh"` |
| 输出 | JSON（分段、时间戳、说话人）、TXT、SRT |
| 价格 | 每小时音频 0.48 美元（Base）至 3.60 美元（Oracle Max）；Oracle 为 1.44 美元 |

## 中文转写需要了解的事项

- API 只有一个中文代码 `zh`，没有字形参数。如果你的产品需要统一的简体或繁体，请在转写后转换（例如使用 OpenCC）。
- 中文书写不带空格，因此时间戳中的“词”可能是单个汉字或较短的片段。制作字幕和高亮时请按时间范围，而不是按词数。
- 粤语等其他汉语方言没有单独列出。在依赖粤语、闽南语或吴语录音之前，请先测试。

## 团队在哪些场景使用中文转写

- 与中国团队合作时的会议和访谈记录。
- 视频和在线课程的中文字幕（`srt`）。
- 把普通话内容翻译成英语，用于研究或尽职调查。

## 选择模型

生产环境的中文音频建议从 `oracle`（每小时 1.44 美元）开始。清晰的单人录音大批量处理用 `base`（0.48 美元），最便宜的翻译用 `oracle_mini`（0.96 美元），嘈杂或困难的音频用 `oracle_pro` 或 `oracle_max`。KolWrite 没有为此 API 发布中文准确率数据，请先用你自己的录音样本测试再做决定。完整对比：[模型与价格](https://console.kolwrite.com/zh/models)。

## 常见问题

### KolWrite 返回简体还是繁体中文？

没有相关参数。请在后处理中转换为你需要的字形。

### 支持粤语吗？

支持列表中只有一个中文代码 `zh`，面向普通话。粤语没有单独列出，请用你自己的音频测试。

### 能把中文音频翻译成英语吗？

可以，使用 Oracle 模型并设置 `translate_to: "en"`。

## 相关页面

- [Japanese speech-to-text (日本語)](https://console.kolwrite.com/speech-to-text/japanese)
- [Korean speech-to-text (한국어)](https://console.kolwrite.com/speech-to-text/korean)
- [开发者与产品团队](https://console.kolwrite.com/zh/use-cases/developers)
- [语言研究与语言学](https://console.kolwrite.com/zh/use-cases/researchers)
- [支持的语言](https://console.kolwrite.com/zh/languages/)

---
获取 API 密钥: https://console.kolwrite.com/auth?lang=zh · API 文档: https://console.kolwrite.com/zh/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt