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

> Вставьте один промпт в агента для программирования, и он добавит транскрибацию в ваше приложение: KolWrite API — это два HTTP-вызова, ключ в переменной окружения и посекундная оплата от 0,48 доллара США за час аудио.

Обновлено: 2026-10-08 · HTML: https://console.kolwrite.com/ru/use-cases/ai-agents

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

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

```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` или получит вебхук.
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=ru), покупает кредиты и создаёт ключ на странице ключей API. Агент не может зарегистрироваться сам. Храните ключ в переменной окружения (`KOLWRITE_API_KEY`) или в хранилище секретов платформы и вызывайте API только из серверного кода или serverless-функции, никогда из браузера.

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

| Задача | Модель | Стоимость |
| --- | --- | --- |
| 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): промпт, идентификаторы моделей и подводные камни.
- У каждой страницы сайта есть версия в Markdown: добавьте `.md` к адресу.

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

### Может ли ИИ-агент создать аккаунт или ключ API KolWrite?

Нет. Регистрируется и создаёт ключ человек; агент читает ключ из переменной окружения.

### Какую модель агенту выбирать по умолчанию?

`oracle` для рабочего аудио, `base` для минимальной цены на чистом звуке, `oracle_mini`, когда нужен ещё и недорогой перевод. Всегда передавайте `model`: по умолчанию используется устаревшая модель `core`.

### Можно ли вызывать API из чисто фронтенд-приложения на Lovable, Bolt или v0?

Только не с ключом в браузере. Используйте серверные или edge-функции платформы, чтобы вызывать KolWrite и держать ключ в секрете.

## Связанные страницы

- [Разработчики и продуктовые команды](https://console.kolwrite.com/ru/use-cases/developers)
- [Медиа, подкасты и субтитры](https://console.kolwrite.com/ru/use-cases/media)
- [Колл-центры и продажи](https://console.kolwrite.com/ru/use-cases/call-centers)
- [Поддерживаемые языки](https://console.kolwrite.com/ru/languages/)

---
Получить ключ API: https://console.kolwrite.com/auth?lang=ru · Документация API: https://console.kolwrite.com/ru/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt