[{"data":1,"prerenderedAt":903},["ShallowReactive",2],{"navigation":3,"\u002Fapi-reference\u002Frealtime-api":224,"\u002Fapi-reference\u002Frealtime-api-surround":898},[4,24,60,88,120,152,196],{"title":5,"path":6,"stem":7,"children":8,"icon":23},"Start","\u002Fstart","1.start\u002F1.index",[9,11,15,19],{"title":10,"path":6,"stem":7},"Overview",{"title":12,"path":13,"stem":14},"Quickstart","\u002Fstart\u002Fquickstart","1.start\u002F2.quickstart",{"title":16,"path":17,"stem":18},"Authentication","\u002Fstart\u002Fauthentication","1.start\u002F3.authentication",{"title":20,"path":21,"stem":22},"Choose an API","\u002Fstart\u002Fchoose-an-api","1.start\u002F5.choose-an-api","i-lucide-rocket",{"title":25,"path":26,"stem":27,"children":28,"icon":59},"Realtime","\u002Frealtime","2.realtime\u002F1.index",[29,31,35,39,43,47,51,55],{"title":30,"path":26,"stem":27},"Realtime Overview",{"title":32,"path":33,"stem":34},"Realtime Quickstart","\u002Frealtime\u002Fquickstart","2.realtime\u002F2.quickstart",{"title":36,"path":37,"stem":38},"Connection Lifecycle","\u002Frealtime\u002Fconnection-lifecycle","2.realtime\u002F3.connection-lifecycle",{"title":40,"path":41,"stem":42},"Audio Input","\u002Frealtime\u002Faudio-input","2.realtime\u002F4.audio-input",{"title":44,"path":45,"stem":46},"Transcript Lifecycle","\u002Frealtime\u002Ftranscript-lifecycle","2.realtime\u002F5.transcript-lifecycle",{"title":48,"path":49,"stem":50},"Realtime Translation","\u002Frealtime\u002Frealtime-translation","2.realtime\u002F6.realtime-translation",{"title":52,"path":53,"stem":54},"Session Configuration","\u002Frealtime\u002Fsession-configuration","2.realtime\u002F7.session-configuration",{"title":56,"path":57,"stem":58},"Handling Interruptions & Silence","\u002Frealtime\u002Finterruptions-silence","2.realtime\u002F8.interruptions-silence","i-lucide-radio",{"title":61,"path":62,"stem":63,"children":64,"icon":87},"Recorded","\u002Frecorded","3.recorded\u002F1.index",[65,67,71,75,79,83],{"title":66,"path":62,"stem":63},"Recorded Overview",{"title":68,"path":69,"stem":70},"Transcribe Audio","\u002Frecorded\u002Ftranscribe-audio","3.recorded\u002F2.transcribe-audio",{"title":72,"path":73,"stem":74},"Timestamps & Speakers","\u002Frecorded\u002Ftimestamps-speakers","3.recorded\u002F3.timestamps-speakers",{"title":76,"path":77,"stem":78},"Subtitles","\u002Frecorded\u002Fsubtitles","3.recorded\u002F4.subtitles",{"title":80,"path":81,"stem":82},"Recorded Translation","\u002Frecorded\u002Ftranslation","3.recorded\u002F5.translation",{"title":84,"path":85,"stem":86},"Structured Results","\u002Frecorded\u002Fstructured-results","3.recorded\u002F6.structured-results","i-lucide-file-audio",{"title":89,"path":90,"stem":91,"children":92,"icon":119},"Concepts","\u002Fconcepts","4.concepts\u002F1.index",[93,95,99,103,107,111,115],{"title":94,"path":90,"stem":91},"Voice Context Layer",{"title":96,"path":97,"stem":98},"Stable vs. Partial Text","\u002Fconcepts\u002Fstable-vs-partial-text","4.concepts\u002F2.stable-vs-partial-text",{"title":100,"path":101,"stem":102},"StableStream","\u002Fconcepts\u002Fstablestream","4.concepts\u002F3.stablestream",{"title":104,"path":105,"stem":106},"Context-Aware Processing","\u002Fconcepts\u002Fcontext-aware-processing","4.concepts\u002F4.context-aware-processing",{"title":108,"path":109,"stem":110},"Understanding Latency","\u002Fconcepts\u002Flatency","4.concepts\u002F5.latency",{"title":112,"path":113,"stem":114},"Live Translation","\u002Fconcepts\u002Flive-translation","4.concepts\u002F6.live-translation",{"title":116,"path":117,"stem":118},"Trinity Engine","\u002Fconcepts\u002Ftrinity-engine","4.concepts\u002F7.trinity-engine","i-lucide-brain",{"title":121,"path":122,"stem":123,"children":124,"icon":151},"Guides","\u002Fguides","5.guides\u002F1.index",[125,127,131,135,139,143,147],{"title":126,"path":122,"stem":123},"Browser Live Captions",{"title":128,"path":129,"stem":130},"Server-side Streaming","\u002Fguides\u002Fserver-side-streaming","5.guides\u002F2.server-side-streaming",{"title":132,"path":133,"stem":134},"Build a Stable Caption UI","\u002Fguides\u002Fstable-caption-ui","5.guides\u002F3.stable-caption-ui",{"title":136,"path":137,"stem":138},"Build Live Translation","\u002Fguides\u002Flive-translation","5.guides\u002F4.live-translation",{"title":140,"path":141,"stem":142},"Save a Transcript","\u002Fguides\u002Fsave-transcript","5.guides\u002F5.save-transcript",{"title":144,"path":145,"stem":146},"Reconnect a Live Session","\u002Fguides\u002Freconnection","5.guides\u002F6.reconnection",{"title":148,"path":149,"stem":150},"Client-VAD speech segments","\u002Fguides\u002Fclient-vad-segments","5.guides\u002F7.client-vad-segments","i-lucide-book-open",{"title":153,"path":154,"stem":155,"children":156,"icon":195},"Reference","\u002Fapi-reference","6.api-reference\u002F1.index",[157,159,163,167,171,175,179,183,187,191],{"title":158,"path":154,"stem":155},"API Reference Overview",{"title":160,"path":161,"stem":162},"Admin API","\u002Fapi-reference\u002Fadmin","6.api-reference\u002F10.admin",{"title":164,"path":165,"stem":166},"Realtime API","\u002Fapi-reference\u002Frealtime-api","6.api-reference\u002F2.realtime-api",{"title":168,"path":169,"stem":170},"Client Messages","\u002Fapi-reference\u002Fclient-messages","6.api-reference\u002F3.client-messages",{"title":172,"path":173,"stem":174},"Server Events","\u002Fapi-reference\u002Fserver-events","6.api-reference\u002F4.server-events",{"title":176,"path":177,"stem":178},"Segment Transcription API","\u002Fapi-reference\u002Fsegment-transcription","6.api-reference\u002F5.segment-transcription",{"title":180,"path":181,"stem":182},"Batch Transcription Jobs","\u002Fapi-reference\u002Fbatch-jobs","6.api-reference\u002F6.batch-jobs",{"title":184,"path":185,"stem":186},"Languages & Models","\u002Fapi-reference\u002Flanguages","6.api-reference\u002F7.languages",{"title":188,"path":189,"stem":190},"Errors","\u002Fapi-reference\u002Ferrors","6.api-reference\u002F8.errors",{"title":192,"path":193,"stem":194},"Rate Limits","\u002Fapi-reference\u002Frate-limits","6.api-reference\u002F9.rate-limits","i-lucide-code",{"title":197,"path":198,"stem":199,"children":200,"icon":223},"Production","\u002Fproduction","7.production\u002F1.index",[201,203,207,211,215,219],{"title":202,"path":198,"stem":199},"Production Checklist",{"title":204,"path":205,"stem":206},"Reconnection & Retries","\u002Fproduction\u002Freconnection-retries","7.production\u002F2.reconnection-retries",{"title":208,"path":209,"stem":210},"Latency Best Practices","\u002Fproduction\u002Flatency-best-practices","7.production\u002F3.latency-best-practices",{"title":212,"path":213,"stem":214},"Security & Privacy","\u002Fproduction\u002Fsecurity-privacy","7.production\u002F4.security-privacy",{"title":216,"path":217,"stem":218},"Data Retention","\u002Fproduction\u002Fdata-retention","7.production\u002F5.data-retention",{"title":220,"path":221,"stem":222},"Changelog","\u002Fproduction\u002Fchangelog","7.production\u002F6.changelog","i-lucide-server",{"id":225,"title":164,"body":226,"description":890,"draft":891,"extension":892,"links":893,"meta":894,"navigation":895,"path":165,"seo":896,"status":893,"stem":166,"__hash__":897},"docs\u002F6.api-reference\u002F2.realtime-api.md",{"type":227,"value":228,"toc":878},"minimark",[229,234,238,242,253,256,259,320,331,335,340,370,374,381,677,681,684,702,706,848,852,874],[230,231,233],"h2",{"id":232},"what-it-does","What it does",[235,236,237],"p",{},"Real-time streaming speech transcription. Open a WebSocket, send PCM16LE audio frames, receive transcription events.",[230,239,241],{"id":240},"endpoint","Endpoint",[243,244,249],"pre",{"className":245,"code":247,"language":248},[246],"language-text","WSS \u002Fv1\u002Faudio\u002Ftranscriptions\u002Fstream\n","text",[250,251,247],"code",{"__ignoreMap":252},"",[230,254,16],{"id":255},"authentication",[235,257,258],{},"Three authentication methods:",[260,261,262,278],"table",{},[263,264,265],"thead",{},[266,267,268,272,275],"tr",{},[269,270,271],"th",{},"Method",[269,273,274],{},"Usage",[269,276,277],{},"Use case",[279,280,281,295,308],"tbody",{},[266,282,283,287,292],{},[284,285,286],"td",{},"Bearer header",[284,288,289],{},[250,290,291],{},"Authorization: Bearer sk-...",[284,293,294],{},"Server-side clients",[266,296,297,300,305],{},[284,298,299],{},"Query token",[284,301,302],{},[250,303,304],{},"?access_token=rt_...",[284,306,307],{},"Browser (session token)",[266,309,310,313,318],{},[284,311,312],{},"Query token (alias)",[284,314,315],{},[250,316,317],{},"?token=rt_...",[284,319,307],{},[235,321,322,323,326,327,330],{},"Session tokens are obtained via ",[250,324,325],{},"POST \u002Fv1\u002Faudio\u002Ftranscriptions\u002Fsession-token"," and are valid for 60 seconds. See ",[328,329,16],"a",{"href":17},".",[230,332,334],{"id":333},"connection","Connection",[336,337,339],"h3",{"id":338},"upgrade-conditions","Upgrade conditions",[341,342,343,350,356,367],"ul",{},[344,345,346,347],"li",{},"Request must be a WebSocket upgrade, otherwise ",[250,348,349],{},"426 websocket_required",[344,351,352,353],{},"Gateway must be enabled, otherwise ",[250,354,355],{},"503 gateway_disabled",[344,357,358,359,362,363,366],{},"Upstream circuit breaker must be closed, otherwise ",[250,360,361],{},"503 upstream_unavailable"," with ",[250,364,365],{},"Retry-After"," header",[344,368,369],{},"Connection quota must pass (concurrent connections + handshake rate)",[336,371,373],{"id":372},"on-success","On success",[235,375,376,377,380],{},"Receives a ",[250,378,379],{},"session.created"," event:",[243,382,386],{"className":383,"code":384,"language":385,"meta":252,"style":252},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"type\": \"session.created\",\n  \"request_id\": \"...\",\n  \"session_id\": \"sess_...\",\n  \"audio\": { \"format\": \"pcm_s16le\", \"sample_rate\": 16000, \"channels\": 1 },\n  \"turn_detection\": { \"type\": \"server_vad\" },\n  \"plan\": \"free\",\n  \"limits\": {\n    \"max_concurrent_utterances\": 2,\n    \"max_session_seconds\": 900,\n    \"idle_timeout_seconds\": 60,\n    \"remaining_audio_seconds\": 3600\n  }\n}\n","json",[250,387,388,397,424,445,466,531,562,583,598,616,633,650,665,671],{"__ignoreMap":252},[389,390,393],"span",{"class":391,"line":392},"line",1,[389,394,396],{"class":395},"sMK4o","{\n",[389,398,400,403,407,410,413,416,419,421],{"class":391,"line":399},2,[389,401,402],{"class":395},"  \"",[389,404,406],{"class":405},"spNyl","type",[389,408,409],{"class":395},"\"",[389,411,412],{"class":395},":",[389,414,415],{"class":395}," \"",[389,417,379],{"class":418},"sfazB",[389,420,409],{"class":395},[389,422,423],{"class":395},",\n",[389,425,427,429,432,434,436,438,441,443],{"class":391,"line":426},3,[389,428,402],{"class":395},[389,430,431],{"class":405},"request_id",[389,433,409],{"class":395},[389,435,412],{"class":395},[389,437,415],{"class":395},[389,439,440],{"class":418},"...",[389,442,409],{"class":395},[389,444,423],{"class":395},[389,446,448,450,453,455,457,459,462,464],{"class":391,"line":447},4,[389,449,402],{"class":395},[389,451,452],{"class":405},"session_id",[389,454,409],{"class":395},[389,456,412],{"class":395},[389,458,415],{"class":395},[389,460,461],{"class":418},"sess_...",[389,463,409],{"class":395},[389,465,423],{"class":395},[389,467,469,471,474,476,478,481,483,487,489,491,493,496,498,501,503,506,508,510,514,516,518,521,523,525,528],{"class":391,"line":468},5,[389,470,402],{"class":395},[389,472,473],{"class":405},"audio",[389,475,409],{"class":395},[389,477,412],{"class":395},[389,479,480],{"class":395}," {",[389,482,415],{"class":395},[389,484,486],{"class":485},"sBMFI","format",[389,488,409],{"class":395},[389,490,412],{"class":395},[389,492,415],{"class":395},[389,494,495],{"class":418},"pcm_s16le",[389,497,409],{"class":395},[389,499,500],{"class":395},",",[389,502,415],{"class":395},[389,504,505],{"class":485},"sample_rate",[389,507,409],{"class":395},[389,509,412],{"class":395},[389,511,513],{"class":512},"sbssI"," 16000",[389,515,500],{"class":395},[389,517,415],{"class":395},[389,519,520],{"class":485},"channels",[389,522,409],{"class":395},[389,524,412],{"class":395},[389,526,527],{"class":512}," 1",[389,529,530],{"class":395}," },\n",[389,532,534,536,539,541,543,545,547,549,551,553,555,558,560],{"class":391,"line":533},6,[389,535,402],{"class":395},[389,537,538],{"class":405},"turn_detection",[389,540,409],{"class":395},[389,542,412],{"class":395},[389,544,480],{"class":395},[389,546,415],{"class":395},[389,548,406],{"class":485},[389,550,409],{"class":395},[389,552,412],{"class":395},[389,554,415],{"class":395},[389,556,557],{"class":418},"server_vad",[389,559,409],{"class":395},[389,561,530],{"class":395},[389,563,565,567,570,572,574,576,579,581],{"class":391,"line":564},7,[389,566,402],{"class":395},[389,568,569],{"class":405},"plan",[389,571,409],{"class":395},[389,573,412],{"class":395},[389,575,415],{"class":395},[389,577,578],{"class":418},"free",[389,580,409],{"class":395},[389,582,423],{"class":395},[389,584,586,588,591,593,595],{"class":391,"line":585},8,[389,587,402],{"class":395},[389,589,590],{"class":405},"limits",[389,592,409],{"class":395},[389,594,412],{"class":395},[389,596,597],{"class":395}," {\n",[389,599,601,604,607,609,611,614],{"class":391,"line":600},9,[389,602,603],{"class":395},"    \"",[389,605,606],{"class":485},"max_concurrent_utterances",[389,608,409],{"class":395},[389,610,412],{"class":395},[389,612,613],{"class":512}," 2",[389,615,423],{"class":395},[389,617,619,621,624,626,628,631],{"class":391,"line":618},10,[389,620,603],{"class":395},[389,622,623],{"class":485},"max_session_seconds",[389,625,409],{"class":395},[389,627,412],{"class":395},[389,629,630],{"class":512}," 900",[389,632,423],{"class":395},[389,634,636,638,641,643,645,648],{"class":391,"line":635},11,[389,637,603],{"class":395},[389,639,640],{"class":485},"idle_timeout_seconds",[389,642,409],{"class":395},[389,644,412],{"class":395},[389,646,647],{"class":512}," 60",[389,649,423],{"class":395},[389,651,653,655,658,660,662],{"class":391,"line":652},12,[389,654,603],{"class":395},[389,656,657],{"class":485},"remaining_audio_seconds",[389,659,409],{"class":395},[389,661,412],{"class":395},[389,663,664],{"class":512}," 3600\n",[389,666,668],{"class":391,"line":667},13,[389,669,670],{"class":395},"  }\n",[389,672,674],{"class":391,"line":673},14,[389,675,676],{"class":395},"}\n",[230,678,680],{"id":679},"message-format","Message format",[235,682,683],{},"All messages are JSON text frames or binary PCM audio frames.",[341,685,686,696],{},[344,687,688,692,693,695],{},[689,690,691],"strong",{},"Text frames",": JSON objects, must contain a ",[250,694,406],{}," field",[344,697,698,701],{},[689,699,700],{},"Binary frames",": raw PCM audio data (ArrayBuffer)",[230,703,705],{"id":704},"websocket-close-codes","WebSocket close codes",[260,707,708,722],{},[263,709,710],{},[266,711,712,716,719],{},[269,713,715],{"align":714},"right","Code",[269,717,718],{},"Close reason",[269,720,721],{},"Meaning",[279,723,724,735,748,760,772,785,798,811,823,835],{},[266,725,726,729,732],{},[284,727,728],{"align":714},"1000",[284,730,731],{},"—",[284,733,734],{},"Normal close",[266,736,737,740,745],{},[284,738,739],{"align":714},"1008",[284,741,742],{},[250,743,744],{},"session_audio_limit",[284,746,747],{},"Realtime session audio budget exceeded",[266,749,750,752,757],{},[284,751,739],{"align":714},[284,753,754],{},[250,755,756],{},"audio_quota_exhausted",[284,758,759],{},"Billing-window audio budget exhausted",[266,761,762,764,769],{},[284,763,739],{"align":714},[284,765,766],{},[250,767,768],{},"session_duration_limit",[284,770,771],{},"Session wall-clock duration exceeded",[266,773,774,777,782],{},[284,775,776],{"align":714},"1009",[284,778,779],{},[250,780,781],{},"audio_frame_too_large",[284,783,784],{},"Audio frame exceeds 1 MiB",[266,786,787,790,795],{},[284,788,789],{"align":714},"1011",[284,791,792],{},[250,793,794],{},"client_error",[284,796,797],{},"Client socket error or unexpected gateway error",[266,799,800,803,808],{},[284,801,802],{"align":714},"1013",[284,804,805],{},[250,806,807],{},"upstream_unavailable",[284,809,810],{},"Realtime upstream unavailable (circuit breaker open)",[266,812,813,815,820],{},[284,814,802],{"align":714},[284,816,817],{},[250,818,819],{},"upstream_backpressure",[284,821,822],{},"Upstream is not draining fast enough",[266,824,825,827,832],{},[284,826,802],{"align":714},[284,828,829],{},[250,830,831],{},"client_backpressure",[284,833,834],{},"Client is not reading events fast enough",[266,836,837,840,845],{},[284,838,839],{"align":714},"4408",[284,841,842],{},[250,843,844],{},"idle_timeout",[284,846,847],{},"No audio received within idle timeout window",[230,849,851],{"id":850},"related","Related",[341,853,854,859,864,869],{},[344,855,856,858],{},[328,857,168],{"href":169}," — all client-sent messages",[344,860,861,863],{},[328,862,172],{"href":173}," — all server-pushed events",[344,865,866,868],{},[328,867,32],{"href":33}," — complete example",[344,870,871,873],{},[328,872,16],{"href":17}," — auth details",[875,876,877],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":252,"searchDepth":392,"depth":399,"links":879},[880,881,882,883,887,888,889],{"id":232,"depth":399,"text":233},{"id":240,"depth":399,"text":241},{"id":255,"depth":399,"text":16},{"id":333,"depth":399,"text":334,"children":884},[885,886],{"id":338,"depth":426,"text":339},{"id":372,"depth":426,"text":373},{"id":679,"depth":399,"text":680},{"id":704,"depth":399,"text":705},{"id":850,"depth":399,"text":851},"WebSocket endpoint for streaming transcription.",false,"md",null,{},true,{"title":164,"description":890},"GGdvJOn23HAhDZdgodjITr8qYW1h4GtiugfrKz8ZWhQ",[899,901],{"title":160,"path":161,"stem":162,"description":900,"children":-1},"Internal key management and plan catalog endpoints.",{"title":168,"path":169,"stem":170,"description":902,"children":-1},"All client → Lanson messages sent over WebSocket.",1789433612440]