OpenAI Audio Input And Output Multi Turn
Send audio input to gpt-audio and carry the conversation across turns with audio replies.
OpenAI schedules gpt-audio for shutdown on January 20, 2027. It remains available until that announced date. See the provider lifecycle notice and verify audio formats and streaming support when selecting a replacement.
The source enables history but omits a database. Before running your saved copy, add from agno.db.in_memory import InMemoryDb to its imports and db=InMemoryDb(), inside its Agent(...) constructor. Keep the existing history settings and reuse the same agent and session across turns. This retains history only for the lifetime of the process; use a persistent database to resume after a restart.
"""
Openai Audio Input And Output Multi Turn
========================================
Cookbook example for `openai/chat/audio_input_and_output_multi_turn.py`.
"""
from pathlib import Path
import requests
from agno.agent import Agent, RunOutput # noqa
from agno.media import Audio
from agno.models.openai import OpenAIChat
from agno.utils.audio import write_audio_to_file
# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------
# Fetch the audio file and convert it to a base64 encoded string
url = "https://openaiassets.blob.core.windows.net/$web/API/docs/audio/alloy.wav"
response = requests.get(url)
response.raise_for_status()
wav_data = response.content
# Provide the agent with the audio file and audio configuration and get result as text + audio
agent = Agent(
model=OpenAIChat(
id="gpt-audio",
modalities=["text", "audio"],
audio={"voice": "alloy", "format": "wav"},
),
# Set add_history_to_context=true to add the previous chat history to the context sent to the Model.
add_history_to_context=True,
# Number of historical responses to add to the messages.
num_history_runs=3,
)
run_output: RunOutput = agent.run(
input="What is in this audio?", audio=[Audio(content=wav_data, format="wav")]
)
filename = Path(__file__).parent.joinpath("tmp/conversation_response_1.wav")
filename.unlink(missing_ok=True)
filename.parent.mkdir(parents=True, exist_ok=True)
# Save the response audio to a file
if run_output.response_audio is not None:
write_audio_to_file(audio=run_output.response_audio.content, filename=str(filename))
run_output: RunOutput = agent.run("Tell me something more about the audio")
filename = Path(__file__).parent.joinpath("tmp/conversation_response_2.wav")
filename.unlink(missing_ok=True)
# Save the response audio to a file
if run_output.response_audio is not None:
write_audio_to_file(audio=run_output.response_audio.content, filename=str(filename))
run_output: RunOutput = agent.run("Now tell me a 5 second story")
filename = Path(__file__).parent.joinpath("tmp/conversation_response_3.wav")
filename.unlink(missing_ok=True)
# Save the response audio to a file
if run_output.response_audio is not None:
write_audio_to_file(audio=run_output.response_audio.content, filename=str(filename))
# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
passRun the Example
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activateInstall dependencies
uv pip install -U agno openai requestsExport your OpenAI API key
export OPENAI_API_KEY="your_openai_api_key_here"Run the example
Save the code above as audio_input_and_output_multi_turn.py, then run:
python audio_input_and_output_multi_turn.pyFull source: cookbook/90_models/openai/chat/audio_input_and_output_multi_turn.py