De audiobuffer vastleggen en wissen
Op deze pagina
Bijgewerkt op 3 november 2026, gebaseerd op de xAI Voice API-referentie:
input_audio_buffer.commitis alleen beschikbaar wanneerturn_detection.typegelijk is aannull; in de modusserver_vadlegt de server de audio zelf vast. Bron: Voice API.
De audiobuffer beheren
Wanneer u audio verstuurt met input_audio_buffer.append, worden de gegevens verzameld in een buffer op de server. Twee bewerkingen sturen deze buffer aan: commit om de inhoud als gebruikersbericht in te dienen, en clear om deze te legen zonder verwerking.
input_audio_buffer.commit
Deze gebeurtenis legt de huidige inhoud van de audiobuffer vast als een gebruikersbericht. Dit is verplicht in de handmatige modus (push-to-talk) en automatisch in de VAD-modus:
{
"type": "input_audio_buffer.commit"
}
Wanneer de server een commit ontvangt, gebeurt het volgende:
- Er wordt een nieuw conversatie-item gemaakt met de verzamelde audio
- Er wordt een
input_audio_buffer.committed-gebeurtenis verzonden ter bevestiging - Er wordt een
conversation.item.added-gebeurtenis verzonden met het nieuwe item - De transcriptie van de audio start (indien ingeschakeld)
Het antwoord van de server
{
"type": "input_audio_buffer.committed",
"item_id": "item_audio_001"
}
Met de item_id kunt u later in de conversatie naar dit bericht verwijzen.
Wanneer u handmatig moet vastleggen (commit)
- Push-to-talk: de gebruiker houdt een knop ingedrukt om te spreken en laat los om te verzenden
- Handmatige segmentatie: u splitst de audiostream op de client in logische segmenten
- Telefonie-integratie: u ontvangt audioblokken van een PBX en legt deze vast aan het einde van elke beurt
// Push-to-talk voorbeeld
talkButton.addEventListener("mousedown", () => {
isRecording = true;
startCapture();
});
talkButton.addEventListener("mouseup", () => {
isRecording = false;
stopCapture();
// Buffer vastleggen
ws.send(JSON.stringify({
type: "input_audio_buffer.commit"
}));
// Een reactie aanvragen
ws.send(JSON.stringify({
type: "response.create"
}));
});
input_audio_buffer.clear
Deze gebeurtenis leegt de audiobuffer zonder een bericht in de conversatie aan te maken:
{
"type": "input_audio_buffer.clear"
}
De server bevestigt dit met:
{
"type": "input_audio_buffer.cleared"
}
Wanneer u moet wissen (clear)
- Annulering: de gebruiker drukt op een “Annuleren”-knop tijdens het spreken
- Onderbreking: de gebruiker begint te spreken, maar een andere gebeurtenis onderbreekt de beurt
- Reset: na een fout of time-out wist u de buffer voordat u opnieuw begint
- Achtergrondgeluid: het systeem detecteert dat de buffer alleen ruis bevat, geen spraak
cancelButton.addEventListener("click", () => {
stopCapture();
ws.send(JSON.stringify({
type: "input_audio_buffer.clear"
}));
showMessage("Opname geannuleerd");
});
VAD-modus versus handmatige modus
In de VAD-modus (server_vad) beheert de server de volledige cyclus automatisch:
- Het detecteert het begin van spraak (
speech_started) - Het verzamelt de audio in de buffer
- Het detecteert het einde van de spraak (
speech_stopped) - Het legt de buffer automatisch vast
- Het start automatisch met het genereren van het antwoord
In de handmatige modus (turn_detection.type ingesteld op null) beheert u elke stap zelf; dit is de enige modus waarin input_audio_buffer.commit beschikbaar is:
- U verzendt audio met
append - U bepaalt wanneer de gebruiker klaar is
- U verzendt
commit - U verzendt
response.create
Vergelijking
| Aspect | VAD-modus | Handmatige modus |
|---|---|---|
| Spraakdetectie | Automatisch | Aan u |
| Buffer vastleggen | Automatisch | Handmatig (commit) |
| Reactie aanvragen | Automatisch | Handmatig (response.create) |
| Controle | Minder controle | Volledige controle |
| Complexiteit | Eenvoudig | Complexer |
| Use cases | Vrije conversatie | Push-to-talk, IVR |
Belangrijkste punten
input_audio_buffer.commitdient de audiobuffer in als een gebruikersberichtinput_audio_buffer.clearleegt de buffer zonder verwerking- In de VAD-modus vindt het vastleggen automatisch plaats wanneer het einde van de spraak wordt gedetecteerd
- In de handmatige modus (
turn_detection.typeingesteld opnull) moet u explicietcommiten vervolgensresponse.createverzenden;commitis alleen in deze modus beschikbaar - De handmatige modus is geschikt voor push-to-talk-interfaces en IVR-telefoniesystemen