# Voz a texto para agentes de IA y vibe coders

> Pega un prompt en tu agente de programación y añadirá transcripción a tu app: la API de KolWrite son dos llamadas HTTP, una clave en una variable de entorno y facturación por segundo desde 0,48 US$ por hora de audio.

Última actualización: 2026-10-08 · HTML: https://console.kolwrite.com/es/use-cases/ai-agents

## El prompt para pegar

Funciona en Cursor, Claude Code, Codex, Windsurf, Lovable, Replit, Bolt y v0. Dirige al agente a las instrucciones legibles por máquina para que use los identificadores de modelo y los parámetros correctos.

```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).
```

## Fíjalo en tu proyecto

Añade esta línea a `AGENTS.md`, `CLAUDE.md`, `.cursorrules` o a las reglas de proyecto de tu herramienta, para que cada sesión futura use la misma referencia:

```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.
```

## Lo que construirá el agente

1. Toma la URL del archivo (o sube un archivo local con `POST /upload` y usa `fileUrl`).
2. Inicia una tarea con `POST /transcribe` y guarda el `jobId`.
3. Consulta `GET /transcribe/{jobId}` hasta `COMPLETED`, o recibe un webhook.
4. Muestra `result.segments`: texto, tiempos de inicio y fin y etiquetas de hablante.

La solicitud mínima que funciona (nota de voz a texto plano):

```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"}'
```

## De dónde sale la clave de API

Una persona crea la cuenta en [console.kolwrite.com/auth](https://console.kolwrite.com/auth?lang=es), compra créditos y genera una clave en la página de claves de API. Los agentes no pueden registrarse solos. Guarda la clave en una variable de entorno (`KOLWRITE_API_KEY`) o en el almacén de secretos de tu plataforma, y llama a la API solo desde código de servidor o una función serverless, nunca desde el navegador.

## Cuánto cuesta

| Tarea | Modelo | Coste |
| --- | --- | --- |
| 10 notas de voz de un minuto | `oracle_mini` | 0,16 US$ |
| Una reunión de una hora con hablantes | `oracle` | 1,44 US$ |
| 100 horas de audio claro | `base` | 48,00 US$ |

Facturación por segundo, sin mínimo. Tarifa completa: [/llms/pricing.md](https://console.kolwrite.com/llms/pricing.md).

## Referencias legibles por máquina

- [llms.txt](https://console.kolwrite.com/llms.txt): qué llamada y qué modelo usar para cada trabajo.
- [llms-full.txt](https://console.kolwrite.com/llms-full.txt): la referencia completa en un solo archivo Markdown.
- [openapi.json](https://console.kolwrite.com/openapi.json): OpenAPI 3.1 para generadores de código y definiciones de herramientas.
- [agent-instructions.md](https://console.kolwrite.com/agent-instructions.md): el prompt, los identificadores de modelo y los errores habituales.
- Cada página de este sitio tiene también versión Markdown: añade `.md` a su dirección.

## Preguntas y respuestas

### ¿Puede un agente de IA crear una cuenta o una clave de API de KolWrite?

No. Una persona se registra y crea la clave; el agente la lee de una variable de entorno.

### ¿Qué modelo debería elegir un agente por defecto?

`oracle` para audio de producción, `base` para el menor coste con audio claro, `oracle_mini` cuando además necesitas traducción barata. Envía siempre `model`: el valor por defecto es el modelo heredado `core`.

### ¿Puedo llamar a la API desde una app solo de front-end hecha con Lovable, Bolt o v0?

No con la clave en el navegador. Usa las funciones de servidor o edge de la plataforma para llamar a KolWrite y mantener la clave en secreto.

## Páginas relacionadas

- [Desarrolladores y equipos de producto](https://console.kolwrite.com/es/use-cases/developers)
- [Medios, pódcasts y subtítulos](https://console.kolwrite.com/es/use-cases/media)
- [Centros de llamadas y ventas](https://console.kolwrite.com/es/use-cases/call-centers)
- [Idiomas compatibles](https://console.kolwrite.com/es/languages/)

---
Obtener una clave de API: https://console.kolwrite.com/auth?lang=es · Documentación de la API: https://console.kolwrite.com/es/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt