Распознавание речи для ИИ-агентов и vibe-кодеров

Промпт для вставки

Работает в Cursor, Claude Code, Codex, Windsurf, Lovable, Replit, Bolt и v0. Он отправляет агента к машиночитаемым инструкциям, чтобы тот использовал правильные идентификаторы моделей и параметры.

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 или получит вебхук.
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 только из серверного кода или serverless-функции, никогда из браузера.

Сколько это стоит

Посекундная оплата без минимума. Полный прайс: /llms/pricing.md.

Машиночитаемые справочники

• llms.txt: какой вызов и какую модель использовать для какой задачи.
• llms-full.txt: полный справочник в одном файле Markdown.
• openapi.json: OpenAPI 3.1 для генераторов кода и описаний инструментов.
• agent-instructions.md: промпт, идентификаторы моделей и подводные камни.
• У каждой страницы сайта есть версия в Markdown: добавьте .md к адресу.

Вопросы и ответы