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

可直接粘贴的提示词

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

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 或你所用工具的项目规则，之后每次会话都会使用同一份参考：

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：文本、起止时间和说话人标签。

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

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 创建账户、购买额度，并在 API 密钥页面生成密钥。智能体不能自行注册。请把密钥放在环境变量（KOLWRITE_API_KEY）或平台的密钥库中，只从服务器代码或无服务器函数调用 API，绝不要在浏览器中调用。

费用

按秒计费，无最低消费。完整价目表：/llms/pricing.md。

机器可读的参考资料

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

常见问题