# Transcription audio pour agents IA et vibe coders

> Collez un prompt dans votre agent de code et il ajoutera la transcription à votre app : l’API KolWrite, ce sont deux appels HTTP, une clé dans une variable d’environnement et une facturation à la seconde dès 0,48 US$ l’heure d’audio.

Dernière mise à jour: 2026-10-08 · HTML: https://console.kolwrite.com/fr/use-cases/ai-agents

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

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

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

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

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

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

## D’où vient la clé API

Une personne crée le compte sur [console.kolwrite.com/auth](https://console.kolwrite.com/auth?lang=fr), 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

| Tâche | Modèle | Coût |
| --- | --- | --- |
| 10 notes vocales d’une minute | `oracle_mini` | 0,16 US$ |
| Une réunion d’une heure avec locuteurs | `oracle` | 1,44 US$ |
| 100 heures d’audio clair | `base` | 48,00 US$ |

Facturation à la seconde, sans minimum. Grille complète : [/llms/pricing.md](https://console.kolwrite.com/llms/pricing.md).

## Références lisibles par machine

- [llms.txt](https://console.kolwrite.com/llms.txt) : quel appel et quel modèle pour quel usage.
- [llms-full.txt](https://console.kolwrite.com/llms-full.txt) : la référence complète dans un seul fichier Markdown.
- [openapi.json](https://console.kolwrite.com/openapi.json) : OpenAPI 3.1 pour les générateurs de code et les définitions d’outils.
- [agent-instructions.md](https://console.kolwrite.com/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

### Un agent IA peut-il créer un compte ou une clé API KolWrite ?

Non. Une personne s’inscrit et crée la clé ; l’agent la lit dans une variable d’environnement.

### Quel modèle un agent doit-il choisir par défaut ?

`oracle` pour l’audio de production, `base` pour le coût le plus bas sur un audio clair, `oracle_mini` quand il faut aussi traduire à moindre coût. Envoyez toujours `model` : la valeur par défaut est l’ancien modèle `core`.

### Puis-je appeler l’API depuis une app front-end créée avec Lovable, Bolt ou v0 ?

Pas avec la clé dans le navigateur. Utilisez les fonctions serveur ou edge de la plateforme pour appeler KolWrite et garder la clé secrète.

## Pages associées

- [Développeurs et équipes produit](https://console.kolwrite.com/fr/use-cases/developers)
- [Médias, podcasts et sous-titres](https://console.kolwrite.com/fr/use-cases/media)
- [Centres d’appels et ventes](https://console.kolwrite.com/fr/use-cases/call-centers)
- [Langues prises en charge](https://console.kolwrite.com/fr/languages/)

---
Obtenir une clé API: https://console.kolwrite.com/auth?lang=fr · Documentation de l’API: https://console.kolwrite.com/fr/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt