AI 제공업체로 돌아가기

OpenAI 호환 API 설정 튜토리얼

개요

Sokuji는 OpenAI Realtime API 호환 엔드포인트를 지원하여 타사 또는 자체 호스팅 서비스를 사용한 실시간 음성 번역이 가능합니다. 이를 통해 대체 제공업체를 선택하거나 자체 추론 서버를 운영할 수 있는 유연성을 제공합니다.

중요: Realtime API 호환성 필요

제공업체는 표준 Chat Completions API뿐만 아니라 OpenAI의 Realtime API WebSocket 프로토콜을 지원해야 합니다. Realtime API를 구현한 엔드포인트만 Sokuji에서 작동합니다.

1호환 제공업체 선택

OpenAI Realtime API WebSocket 프로토콜을 지원하는 서비스를 선택하세요. 중요: 현재 Realtime API를 지원하는 제공업체는 매우 적습니다. 대부분의 OpenAI 호환 서비스는 Chat Completions API만 지원하며 Sokuji에서는 사용할 수 없습니다. 진행하기 전에 제공업체가 Realtime API를 명시적으로 지원하는지 반드시 확인하세요.

2API 엔드포인트와 키 받기

선택한 제공업체에서 API 엔드포인트 URL과 API 키를 받으세요. 엔드포인트 URL은 일반적으로 https://your-provider.com 형식이며, 자체 호스팅 서비스의 경우 http://localhost:8080 형식입니다.

3Sokuji에서 OpenAI 호환 API 선택

Sokuji를 열고 설정 패널로 이동하세요. 제공업체 드롭다운에서 "OpenAI Compatible API"를 AI 제공업체로 선택하세요.

4구성 정보 입력

사용자 정의 API 엔드포인트 URL을 "API Endpoint" 필드에 붙여넣으세요. "API Key" 필드에 API 키를 입력하세요. 제공업체에서 API 키가 필요하지 않은 경우(예: 로컬 서비스) 비워두거나 자리 표시자 값을 입력할 수 있습니다.

5모델 및 음성 선택

제공업체가 지원하는 모델 및 음성 설정을 선택하세요. 사용 가능한 옵션은 특정 제공업체에 따라 다릅니다. 일반적인 모델에는 gpt-4o-realtime-preview 또는 제공업체 고유의 모델 이름이 있습니다.

6연결 테스트

모든 것이 제대로 작동하는지 확인하기 위해 번역 세션을 시작하세요. 세션 시작 버튼을 클릭하고 마이크에 대고 말한 후 연결이 성공적으로 설정되고 오디오가 번역되는지 확인하세요.

추가 정보

OpenAI 호환 API란?

OpenAI 호환 API는 Sokuji가 OpenAI Realtime API 프로토콜을 구현하는 모든 서비스에 연결할 수 있게 하는 범용 제공업체 옵션입니다:

  • 사용자 정의 기본 URL로 모든 OpenAI 호환 엔드포인트 사용
  • 클라우드 호스팅 및 자체 호스팅 서비스 모두 지원
  • 다양한 백엔드 제공업체 간 유연한 전환
  • 프라이빗 배포, 비용 최적화 또는 지역 규정 준수에 유용

제공업체 호환성에 대해

대부분의 OpenAI 호환 서비스는 Chat Completions API만 지원합니다. Realtime API(WebSocket 기반, 오디오 스트리밍 지원)는 다른 프로토콜이며 이를 지원하는 제공업체는 매우 적습니다:

  • Azure OpenAI Service: Microsoft Azure에서 호스팅되는 OpenAI 모델의 Realtime API 지원
  • 제공업체 문서에서 Realtime API 지원을 명시적으로 확인하세요
  • OpenRouter, Together AI 등의 서비스는 일반적으로 Realtime API를 지원하지 않습니다
  • 일부 프록시 서비스(예: CometAPI)는 Realtime API 호환성을 제공할 수 있습니다 — 사용 전 확인하세요
  • 자체 호스팅 솔루션은 전체 Realtime API WebSocket 프로토콜을 구현해야 합니다

구성 팁

  • 엔드포인트 URL에 후행 슬래시를 포함하지 마세요 (예: https://api.example.com/ 대신 https://api.example.com 사용)
  • 로컬 서비스의 경우 http://localhost:<port>을 엔드포인트로 사용
  • 일부 제공업체는 특정 헤더 또는 인증 방법이 필요할 수 있음
  • 프록시 서비스를 사용하는 경우 WebSocket 연결이 올바르게 전달되는지 확인

문제 해결

일반적인 문제

연결 거부됨: 엔드포인트 URL이 올바른지, 서비스가 실행 중인지 확인하세요. 로컬 서비스의 경우 서버가 시작되었고 예상 포트에서 수신 대기하고 있는지 확인하세요.

인증 오류: API 키를 다시 확인하세요. 일부 제공업체는 특정 키 형식이 필요합니다. 계정에 Realtime API 접근 권한이 있는지 확인하세요.

모델을 찾을 수 없음: 모델 이름이 OpenAI의 기본 모델과 다를 수 있습니다. 사용 가능한 모델 이름은 제공업체 문서를 확인하세요.

WebSocket 연결 실패: 제공업체가 Realtime API용 WebSocket 연결을 지원하는지 확인하세요. HTTP 전용 표준 엔드포인트(Chat Completions)는 작동하지 않습니다.

제공업체 호환성 확인

  1. 제공업체가 OpenAI Realtime API 프로토콜을 명시적으로 지원하는지 확인
  2. WebSocket 연결이 지원되는지 확인 (REST API만이 아닌)
  3. 제공업체가 오디오 입출력 스트리밍을 지원하는지 확인
  4. 가능하면 WebSocket 클라이언트로 엔드포인트 URL을 직접 테스트
  5. 제공업체 문서에서 특정 구성 요구 사항 확인

더 많은 도움이 필요하신가요? 프로토콜 세부 사항은 OpenAI Realtime API 문서를 참조하거나 GitHub 저장소에서 커뮤니티 지원을 받으세요.

OpenAI Realtime API Docs