Transcription audio pour agents IA et vibe coders

Le prompt à coller

Fonctionne dans Cursor, Claude Code, Codex, Windsurf, Lovable, Replit, Bolt et v0. Il renvoie l’agent vers les instructions lisibles par machine pour qu’il utilise les bons identifiants de modèle et paramètres.

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

L’épingler dans votre projet

Ajoutez cette ligne à AGENTS.md, CLAUDE.md, .cursorrules ou aux règles de projet de votre outil, pour que chaque session future utilise la même référence :

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.

Ce que l’agent va construire

1. Récupérer l’URL du fichier (ou envoyer un fichier local avec POST /upload et utiliser fileUrl).
2. Lancer une tâche avec POST /transcribe et garder le jobId.
3. Interroger GET /transcribe/{jobId} jusqu’à COMPLETED, ou recevoir un webhook.
4. Afficher result.segments : texte, horodatages de début et de fin, étiquettes de locuteur.

La plus petite requête qui fonctionne (note vocale vers texte brut) :

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

D’où vient la clé API

Une personne crée le compte sur console.kolwrite.com/auth, achète des crédits et génère une clé sur la page des clés API. Un agent ne peut pas s’inscrire seul. Placez la clé dans une variable d’environnement (KOLWRITE_API_KEY) ou dans le coffre à secrets de votre plateforme, et appelez l’API uniquement depuis du code serveur ou une fonction serverless, jamais depuis le navigateur.

Combien ça coûte

Facturation à la seconde, sans minimum. Grille complète : /llms/pricing.md.

Références lisibles par machine

• llms.txt : quel appel et quel modèle pour quel usage.
• llms-full.txt : la référence complète dans un seul fichier Markdown.
• openapi.json : OpenAPI 3.1 pour les générateurs de code et les définitions d’outils.
• agent-instructions.md : le prompt, les identifiants de modèle et les pièges.
• Chaque page de ce site existe aussi en Markdown : ajoutez .md à son adresse.

Questions et réponses