Voz a texto para agentes de IA y vibe coders

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.

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:

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):

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, 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

Facturación por segundo, sin mínimo. Tarifa completa: /llms/pricing.md.

Referencias legibles por máquina

• llms.txt: qué llamada y qué modelo usar para cada trabajo.
• llms-full.txt: la referencia completa en un solo archivo Markdown.
• openapi.json: OpenAPI 3.1 para generadores de código y definiciones de herramientas.
• 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