Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De audiobuffer vastleggen en wissen

Les 8 van 16 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. De audiobuffer beheren
  2. input_audio_buffer.commit
  3. input_audio_buffer.clear
  4. VAD-modus versus handmatige modus
  5. Belangrijkste punten

Bijgewerkt op 3 november 2026, gebaseerd op de xAI Voice API-referentie: input_audio_buffer.commit is alleen beschikbaar wanneer turn_detection.type gelijk is aan null; in de modus server_vad legt 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:

  1. Er wordt een nieuw conversatie-item gemaakt met de verzamelde audio
  2. Er wordt een input_audio_buffer.committed-gebeurtenis verzonden ter bevestiging
  3. Er wordt een conversation.item.added-gebeurtenis verzonden met het nieuwe item
  4. 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:

  1. Het detecteert het begin van spraak (speech_started)
  2. Het verzamelt de audio in de buffer
  3. Het detecteert het einde van de spraak (speech_stopped)
  4. Het legt de buffer automatisch vast
  5. 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:

  1. U verzendt audio met append
  2. U bepaalt wanneer de gebruiker klaar is
  3. U verzendt commit
  4. U verzendt response.create

Vergelijking

AspectVAD-modusHandmatige modus
SpraakdetectieAutomatischAan u
Buffer vastleggenAutomatischHandmatig (commit)
Reactie aanvragenAutomatischHandmatig (response.create)
ControleMinder controleVolledige controle
ComplexiteitEenvoudigComplexer
Use casesVrije conversatiePush-to-talk, IVR

Belangrijkste punten

  • input_audio_buffer.commit dient de audiobuffer in als een gebruikersbericht
  • input_audio_buffer.clear leegt 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.type ingesteld op null) moet u expliciet commit en vervolgens response.create verzenden; commit is alleen in deze modus beschikbaar
  • De handmatige modus is geschikt voor push-to-talk-interfaces en IVR-telefoniesystemen