OpenAI Realtime API

밀리초 단위로 OpenAI Realtime 모델과 대화해 보세요 — 단일 WebSocket 세션을 통한 양방향 오디오와 텍스트를 Delphi/C++Builder에서 구동해요.

TsgcWSAPI_OpenAI

OpenAI Realtime API를 위한 WebSocket 클라이언트예요 — 전체 세션 라이프사이클, 함수 도구, 오디오 프레임 스트리밍, 전사 이벤트를 지원해요.

컴포넌트 클래스

TsgcWSAPI_OpenAI

프로토콜

OpenAI Realtime API

플랫폼

Windows, macOS, Linux, iOS, Android

에디션

Standard / Professional / Enterprise

컴포넌트를 추가하고, 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는 활성 Realtime 세션에 모달리티, 음성, 지시, input_audio_format, output_audio_format, turn_detection 설정을 적용해요.

대화 항목

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에서 OS가 관리하는 TLS를 위해 TsgcWebSocketClient_WinHTTP와 연결하세요.

사양 및 참조 문서

이 컴포넌트가 구현하는 API의 공식 참조 출처예요.

문서 및 데모

컴포넌트 참조 문서로 바로 이동하고, 바로 실행 가능한 데모 프로젝트를 받고, 체험판을 다운로드해 보세요.

온라인 도움말 — API_OpenAI 이 컴포넌트의 전체 속성, 메서드, 이벤트 참조 문서.
무료 체험판 — sgcWebSockets 체험판 패키지를 다운로드하고, Delphi 애플리케이션에 Realtime 오디오와 텍스트 스트리밍을 시작해 보세요.
기술 문서 (PDF) 기능, 빠른 시작, Delphi 및 C++ Builder 코드 샘플 및 1차 출처 참고 — 이 컴포넌트 전용.
사용자 설명서 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 설명서.

OpenAI Realtime을 스트리밍할 준비가 됐나요?

무료 체험판을 다운로드하고, Delphi 애플리케이션에 라이브 AI 오디오와 텍스트를 추가해 보세요.