OpenAI Realtime API Voice Agent

\n\n

\n\n \n \n",[],[154,173],[154],{"_102":182,"_95":183,"_155":184,"_157":-5,"_158":136,"_159":160,"_161":162,"_104":185,"_99":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":186,"_98":221},"3fec50c2-8508-11f0-a1fe-0224a6c84d84","routes","0198f725-9761-70a8-bb33-ed541bc4dfaa",["D",1756493092620],[187,196,204,212],{"_102":188,"_95":189,"_155":190,"_157":184,"_158":136,"_159":160,"_161":162,"_104":191,"_99":32,"_164":192,"_166":193,"_167":22,"_168":-5,"_169":194,"_98":195},"3fec471c-8508-11f0-a1fe-0224a6c84d84","observer.ts","0198f725-9761-70a8-bb33-dd018e79b788",["D",1756493092620],"script","import { Hono } from \"npm:hono\";\nimport WebSocket from \"npm:ws\";\nimport { makeHeaders } from \"./utils.ts\";\n\nconst observer = new Hono();\n\n// POST /observer/:callId : self-connect to establish a web socket\nobserver.post(\"/:callId\", async (c) => {\n const callId = c.req.param(\"callId\");\n const url = `wss://api.openai.com/v1/realtime?call_id=${callId}`;\n const ws = new WebSocket(url, { headers: makeHeaders() });\n ws.on(\"open\", () => {\n console.log(\"✅ websocket connected\");\n setTimeout(() => ws.send(JSON.stringify({ type: \"response.create\" })), 250);\n });\n ws.on(\"message\", (data /*, isBinary */) => {\n const message = JSON.parse(data);\n if (message.type !== \"response.audio_transcript.delta\") {\n console.log(message);\n }\n });\n ws.on(\"error\", (err: Error) => {\n console.error(`🔴 websocket failed: ${err.message}`);\n });\n\n // Respond immediately; WS continues in background\n return c.newResponse(null);\n});\n\nexport default observer;",[],[183,189],{"_102":197,"_95":198,"_155":199,"_157":184,"_158":136,"_159":160,"_161":162,"_104":200,"_99":32,"_164":192,"_166":201,"_167":22,"_168":-5,"_169":202,"_98":203},"3fec4a78-8508-11f0-a1fe-0224a6c84d84","rtc.ts","0198f725-9761-70a8-bb33-e3cb8a4465f9",["D",1756493092620],"import { Hono } from \"npm:hono\";\nimport { makeHeaders, makeSession } from \"./utils.ts\";\n\nconst rtc = new Hono();\n\n// POST /rtc : create a new call\nrtc.post(\"/\", async (c) => {\n // Create the call.\n const url = \"https://api.openai.com/v1/realtime/calls\";\n const headers = makeHeaders();\n const fd = new FormData();\n fd.set(\"sdp\", await c.req.text());\n fd.set(\"session\", JSON.stringify(makeSession()));\n const opts = { method: \"POST\", headers, body: fd };\n const resp = await fetch(url, opts);\n if (!resp.ok) {\n const errText = await resp.text().catch(() => \"\");\n console.error(`🔴 start call failed: ${resp.status} ${errText}`);\n return c.text(\"Internal error\", 500);\n }\n\n const contentType = resp.headers.get(\"Content-Type\");\n const location = resp.headers.get(\"Location\");\n const callId = location?.split(\"/\").pop();\n console.log(\"✅ call created:\", callId);\n\n // Kick off observer in the background (fire-and-forget).\n const selfUrl = new URL(c.req.url);\n fetch(`${selfUrl.origin}/observer/${callId}`, { method: \"POST\" });\n\n return c.newResponse(resp.body, {\n headers: { \"Content-Type\": contentType },\n });\n});\n\nexport default rtc;",[],[183,198],{"_102":205,"_95":206,"_155":207,"_157":184,"_158":136,"_159":160,"_161":162,"_104":208,"_99":32,"_164":192,"_166":209,"_167":22,"_168":-5,"_169":210,"_98":211},"3fec4c3a-8508-11f0-a1fe-0224a6c84d84","sip.ts","0198f725-9761-70a8-bb33-e72059582aa8",["D",1756493092620],"import { Hono } from \"npm:hono\";\nimport { Webhook } from \"npm:svix\";\nimport { makeHeaders, makeSession } from \"./utils.ts\";\n\nconst sip = new Hono();\n\n// POST /sip : webhook endpoint\nsip.post(\"/\", async (c) => {\n // Verify the webhook.\n const OPENAI_SIGNING_SECRET = Deno.env.get(\"OPENAI_SIGNING_SECRET\");\n if (!OPENAI_SIGNING_SECRET) {\n console.error(\"🔴 webhook secret not configured\");\n return c.text(\"Internal error\", 500);\n }\n const webhook = new Webhook(OPENAI_SIGNING_SECRET);\n const bodyStr = await c.req.text();\n let callId: string | undefined;\n try {\n const headers = Object.fromEntries(c.req.raw.headers.entries());\n const payload: any = webhook.verify(bodyStr, headers);\n callId = payload.data.call_id;\n console.log(\"✅ verified webhook:\", callId);\n } catch (error) {\n console.error(`🔴 verify failed: ${error}`);\n return c.text(\"Invalid signature\", 401);\n }\n\n // Accept the call.\n const url = `https://api.openai.com/v1/realtime/calls/${callId}/accept`;\n const headers = makeHeaders(\"application/json\");\n const body = JSON.stringify(makeSession());\n const opts = { method: \"POST\", headers, body };\n const resp = await fetch(url, opts);\n if (!resp.ok) {\n const errText = await resp.text().catch(() => \"\");\n console.error(`🔴 accept failed: ${errText}`);\n return c.text(\"Internal error\", 500);\n }\n console.log(\"✅ call accepted:\", callId);\n\n // Kick off observer in the background (fire-and-forget).\n const selfUrl = new URL(c.req.url);\n fetch(`${selfUrl.origin}/observer/${callId}`, { method: \"POST\" })\n .catch((e) => console.error(\"observer trigger failed:\", e));\n\n return c.newResponse(null);\n});\n\nexport default sip;",[],[183,206],{"_102":213,"_95":214,"_155":215,"_157":184,"_158":136,"_159":216,"_161":162,"_104":217,"_99":160,"_164":192,"_166":218,"_167":22,"_168":-5,"_169":219,"_98":220},"d63b3674-8508-11f0-a900-0224a6c84d84","utils.ts","0198f725-9761-70a8-bb33-ea8763655db6",2,["D",1756493344882],"const MODEL = \"gpt-realtime\";\nconst INSTRUCTIONS = `\nWrite the instructions prompt, for an English - Kannada teacher. \nYou'll start with simple instructions that are used in day-to-day life, say it in English, then in Kannada, and then you'll explain the words used. \nThen you'll ask a question in Kannada to the user, based on what they just learned. \nIf their response is correct, move on to the next phrase. \nIf response is incorrect, tell them what's wrong. \nThen continue quizzing in an alternate version of the question, until they get it right. \nBefore you begin the conversation, create a set of phrases (about 30 or so), by asking the user their current proficiency and assessing them. \nWe want conversational Kannada - someone who's new to the state should be able to navigate daily life easily with this. \nWhen speaking to the user, use a mix of Kannada and English. Mix up phrases from both language in a way a bilingual person would naturally do.`;\nconst VOICE = \"marin\";\n\nconst OPENAI_API_KEY = Deno.env.get(\"OPENAI_API_KEY\");\nif (!OPENAI_API_KEY) {\n throw new Error(\"🔴 OpenAI API key not configured\");\n}\n\nexport function makeHeaders(contentType?: string) {\n const obj: Record = {\n Authorization: `Bearer ${OPENAI_API_KEY}`,\n };\n if (contentType) obj[\"Content-Type\"] = contentType;\n return obj;\n}\n\nexport function makeSession() {\n return {\n type: \"realtime\",\n model: MODEL,\n instructions: INSTRUCTIONS,\n audio: {\n input: { noise_reduction: { type: \"near_field\" } },\n output: { voice: VOICE },\n },\n };\n}",[],[183,214],[183],{"_102":223,"_95":224,"_155":225,"_157":-5,"_158":136,"_159":160,"_161":162,"_104":226,"_99":32,"_164":176,"_166":227,"_167":22,"_168":-5,"_169":228,"_98":229},"3fec5234-8508-11f0-a1fe-0224a6c84d84","README.md","0198f725-9761-70a8-bb33-f127a4ca8732",["D",1756493092620],"# hello-realtime\n\nHello Realtime is a complete OpenAI Realtime application that supports both WebRTC and SIP users.\nYou can access the app via WebRTC at https://hello-realtime.val.run, or via SIP by calling 425-800-0042.\n\nThis demo shows off the new SIP API, the new all-in-one WebRTC API, and the new server-side websocket interface.\n\nIf you remix the app, you'll just need to pop in your own OPENAI_API_KEY (from platform.openai.com), and also the OPENAI_SIGNING_SECRET if you want to use the SIP interface.",[],[224],{"_102":231,"_95":232,"_155":233,"_157":-5,"_158":136,"_159":160,"_161":162,"_104":234,"_99":32,"_164":235,"_166":236,"_167":22,"_168":-5,"_169":237,"_98":238},"3fec53ce-8508-11f0-a1fe-0224a6c84d84","main.tsx","0198f725-9761-70a8-bb33-f679a7d74b15",["D",1756493092620],"http","import { Hono } from \"npm:hono\";\nimport {\n readFile,\n serveFile,\n} from \"https://esm.town/v/std/utils@85-main/index.ts\";\n// import mcp from \"./routes/mcp.ts\";\nimport rtc from \"./routes/rtc.ts\";\nimport sip from \"./routes/sip.ts\";\nimport observer from \"./routes/observer.ts\";\n\nconst app = new Hono();\napp.route(\"/rtc\", rtc);\napp.route(\"/sip\", sip);\napp.route(\"/observer\", observer);\n// app.route(\"/mcp\", mcp);\n\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\nexport default app.fetch;",[],[232],"files",[152,171,181,187,196,204,212,222,230],"counts",{"_243":32,"_244":160,"_245":32,"_246":216},"pulls","branches","forks","envVars","contents",[249,252,255,258],{"_102":153,"_95":154,"_155":156,"_157":-5,"_158":136,"_159":160,"_161":162,"_104":250,"_99":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_98":251},["D",1756493092620],[154],{"_102":182,"_95":183,"_155":184,"_157":-5,"_158":136,"_159":160,"_161":162,"_104":253,"_99":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_98":254},["D",1756493092620],[183],{"_102":223,"_95":224,"_155":225,"_157":-5,"_158":136,"_159":160,"_161":162,"_104":256,"_99":32,"_164":176,"_166":227,"_167":22,"_168":-5,"_98":257},["D",1756493092620],[224],{"_102":231,"_95":232,"_155":233,"_157":-5,"_158":136,"_159":160,"_161":162,"_104":259,"_99":32,"_164":235,"_166":236,"_167":22,"_168":-5,"_98":260},["D",1756493092620],[232],"upstreamProject",{"_102":144,"_95":263,"_110":264,"_111":-5,"_108":109,"_23":265},"hello-realtime","Sample app for the OpenAI Realtime API",{"_93":266,"_128":267},"jubertioai","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/61901958-12bd-49a3-43e9-2f67f1617200/square512","upstreamBranch",{"_102":139,"_104":270,"_271":272,"_95":43,"_137":144,"_99":273,"_138":274,"_140":275,"_276":277,"_106":-5,"_149":22,"_108":109,"_148":266,"_16":146,"_147":263},["D",1755188493466],"updatedAt",["D",1757729497613],297,"e004ac78-4230-11f0-834a-76b3cceeab13",47,"lockfileKey","1757729506929-esm.town_v_jubertioai_hello-realtime@297-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.environment-variables",{"_93":94,"_95":96,"_100":284,"_246":289},{"_102":103,"_95":96,"_104":285,"_106":-5,"_107":22,"_108":109,"_110":-5,"_111":-5,"_14":112,"_113":-5,"_114":22,"_115":-5,"_116":32,"_16":117,"_118":119,"_120":119,"_121":122,"_123":122,"_124":122,"_125":119,"_126":119,"_23":286,"_130":287,"_133":288,"_149":22},["D",1756493092620],{"_93":94,"_128":129},{"_93":94,"_132":129},{"_99":135,"_95":43,"_102":136,"_137":103,"_138":139,"_140":141,"_142":109,"_143":144,"_145":146,"_147":96,"_148":94},[290,296],{"_291":292,"_104":293,"_271":294,"_110":72,"_295":22},"key","OPENAI_API_KEY",["D",1756493092620],["D",1756493482636],"isEmpty",{"_291":297,"_104":298,"_271":-5,"_110":72,"_295":162},"OPENAI_SIGNING_SECRET",["D",1756493092620],"actionData","errors"]

Learn Kannada through conversations

Key	Description
OPENAI_API_KEY
OPENAI_SIGNING_SECRET

Environment variables