OpenAI Realtime API

毫秒级与 OpenAI Realtime 模型对话 — 通过单个 WebSocket 会话实现双向音频和文本,由 Delphi/C++Builder 驱动。

TsgcWSAPI_OpenAI

OpenAI Realtime API 的 WebSocket 客户端 — 完整的会话生命周期、函数工具、音频帧流式传输和转录事件。

组件类

TsgcWSAPI_OpenAI

平台

Windows、macOS、Linux、iOS、Android

版本

标准版 / 专业版 / 企业版

拖入组件,设置 API 密钥,开始对话

与 TsgcWebSocketClient 配对,设置 OpenAI.ApiKey 和 OpenAI.Model,推送音频或文本并监听响应事件。

uses
  sgcWebSocket, sgcWebSocket_API_OpenAI;

var
  WSClient: TsgcWebSocketClient;
  OpenAI: TsgcWSAPI_OpenAI;
begin
  WSClient := TsgcWebSocketClient.Create(nil);

  OpenAI := TsgcWSAPI_OpenAI.Create(nil);
  OpenAI.Client := WSClient;
  OpenAI.OpenAI.ApiKey := 'sk-...';
  OpenAI.OpenAI.Model  := 'gpt-realtime';

  WSClient.Active := True;

  // send a text turn
  OpenAI.ConversationCreateMessageText('Hello', 'user');
  OpenAI.ResponseCreate;
end;
// uses: sgcWebSocket, sgcWebSocket_API_OpenAI
TsgcWebSocketClient *WSClient = new TsgcWebSocketClient(this);
TsgcWSAPI_OpenAI *OpenAI = new TsgcWSAPI_OpenAI(this);
OpenAI->Client = WSClient;
OpenAI->OpenAI->ApiKey = "sk-...";
OpenAI->OpenAI->Model  = "gpt-realtime";

WSClient->Active = true;
OpenAI->ConversationCreateMessageText("Hello", "user");
OpenAI->ResponseCreate();

功能详情

将 OpenAI Realtime WebSocket 网关封装为类型化 Delphi 组件,提供会话、对话和音频辅助功能。

会话生命周期

SessionUpdate 将模态、语音、指令、input_audio_format、output_audio_format 和 turn_detection 设置应用到活跃的 Realtime 会话。

对话项目

ConversationCreateMessageTextConversationCreateMessageAudio 推送用户/系统内容;ConversationItemDeleteConversationItemTruncate 重塑当前对话历史。

音频流式传输

InputAudioBufferAppend 推送 PCM 帧(base64 编码),InputAudioBufferCommit 结束用户轮次。输出音频以 response.audio.delta 事件的形式到达。

函数调用

SessionUpdate 中声明工具;参数以 response.function_call_arguments.delta 事件的形式到达,结果通过 ConversationCreateFunctionCallOutput 返回。

语音活动检测

服务端 VAD(turn_detection: {type: server_vad})自动检测语音结束 — 组件将每个阶段作为独立事件传递。

认证请求头

组件在 WebSocket 握手时注入 AuthorizationOpenAI-Beta: realtime=v1 请求头。在 Windows 上与 TsgcWebSocketClient_WinHTTP 配对使用,以获得 OS 管理的 TLS。

规范与参考

本组件所实现 API 的权威参考来源。

文档与演示

直接访问组件参考文档,获取即用型演示项目,并下载试用版。

在线帮助 — API_OpenAI 本组件的完整属性、方法和事件参考。
免费试用版 — sgcWebSockets 下载试用包,立即在 Delphi 应用程序中流式传输 Realtime 音频和文本。
技术文档(PDF) 功能概述、快速入门、Delphi 和 C++ Builder 代码示例及主要参考资源 — 仅适用于本组件。
用户手册(PDF) 涵盖库中每个组件的综合手册。

准备好流式传输 OpenAI Realtime 了吗?

下载免费试用版,为您的 Delphi 应用程序添加实时 AI 音频和文本功能。