# 面向 AI 智能体和氛围编程开发者的语音转文字

> 把一段提示词粘贴进编程智能体，它就能为你的应用加入转写：KolWrite API 只有两个 HTTP 调用、一个放在环境变量里的密钥，并按秒计费，每小时音频 0.48 美元起。

最后更新: 2026-10-08 · HTML: https://console.kolwrite.com/zh/use-cases/ai-agents

## 可直接粘贴的提示词

适用于 Cursor、Claude Code、Codex、Windsurf、Lovable、Replit、Bolt 和 v0。它会把智能体引导到机器可读的说明，确保使用正确的模型 ID 和参数。

```text
Add speech-to-text to this app with the KolWrite API.
Read https://console.kolwrite.com/agent-instructions.md first.
- Key: process.env.KOLWRITE_API_KEY, sent as the x-api-key header (server side only).
- POST https://app.kolwrite.com/transcribe {"audio_url", "model": "oracle", "language": "auto", "output_format": "json"}
- Local files: POST /upload first, then use fileUrl as audio_url.
- Poll GET /transcribe/{jobId} every 5 s until COMPLETED or FAILED.
- Show result.segments (start, end, speaker, text).
```

## 固定到项目中

把这一行加入 `AGENTS.md`、`CLAUDE.md`、`.cursorrules` 或你所用工具的项目规则，之后每次会话都会使用同一份参考：

```text
For speech-to-text use the KolWrite API; read https://console.kolwrite.com/agent-instructions.md and https://console.kolwrite.com/llms-full.txt before writing code.
```

## 智能体会构建什么

1. 读取文件 URL（或用 `POST /upload` 上传本地文件并使用 `fileUrl`）。
2. 用 `POST /transcribe` 创建任务并保存 `jobId`。
3. 轮询 `GET /transcribe/{jobId}` 直到 `COMPLETED`，或接收 webhook。
4. 展示 `result.segments`：文本、起止时间和说话人标签。

最小可用请求（语音消息转为纯文本）：

```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/voice-note.m4a", "model": "oracle_mini", "output_format": "txt"}'
```

## API 密钥从哪里来

由一个人在 [console.kolwrite.com/auth](https://console.kolwrite.com/auth?lang=zh) 创建账户、购买额度，并在 API 密钥页面生成密钥。智能体不能自行注册。请把密钥放在环境变量（`KOLWRITE_API_KEY`）或平台的密钥库中，只从服务器代码或无服务器函数调用 API，绝不要在浏览器中调用。

## 费用

| 任务 | 模型 | 费用 |
| --- | --- | --- |
| 10 条一分钟的语音消息 | `oracle_mini` | 0.16 美元 |
| 一小时带说话人的会议 | `oracle` | 1.44 美元 |
| 100 小时清晰音频 | `base` | 48.00 美元 |

按秒计费，无最低消费。完整价目表：[/llms/pricing.md](https://console.kolwrite.com/llms/pricing.md)。

## 机器可读的参考资料

- [llms.txt](https://console.kolwrite.com/llms.txt)：什么任务用哪个调用和模型。
- [llms-full.txt](https://console.kolwrite.com/llms-full.txt)：完整参考，一个 Markdown 文件。
- [openapi.json](https://console.kolwrite.com/openapi.json)：OpenAPI 3.1，供代码生成器和工具定义使用。
- [agent-instructions.md](https://console.kolwrite.com/agent-instructions.md)：提示词、模型 ID 和常见陷阱。
- 本站每个页面都有 Markdown 版本：在地址后加上 `.md`。

## 常见问题

### AI 智能体能创建 KolWrite 账户或 API 密钥吗？

不能。由人注册并创建密钥，智能体从环境变量读取。

### 智能体默认应选哪个模型？

生产音频用 `oracle`，清晰音频要最低成本用 `base`，同时需要低成本翻译时用 `oracle_mini`。务必传 `model`：默认值是旧版模型 `core`。

### 能否在用 Lovable、Bolt 或 v0 构建的纯前端应用中调用 API？

不能把密钥放在浏览器里。请使用平台的服务器函数或边缘函数调用 KolWrite，并妥善保密密钥。

## 相关页面

- [开发者与产品团队](https://console.kolwrite.com/zh/use-cases/developers)
- [媒体、播客与字幕](https://console.kolwrite.com/zh/use-cases/media)
- [呼叫中心与销售电话](https://console.kolwrite.com/zh/use-cases/call-centers)
- [支持的语言](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