AI 공동 진행자

방송 중 대화할 수 있는 AI 조수입니다. 채팅도 읽을 수 있습니다.

두 가지 사용 방법

음성 공동 진행자

다음 페이지에서 AI에게 말로 대화하세요: cohost.html. 음성으로 대답하며 요청하면 채팅 내용에 관해서도 이야기합니다.

설정하기

Dock 버튼

Dock에서 채팅 메시지를 오른쪽 클릭하세요. AI 아바타가 읽어 주거나 답변 또는 가벼운 놀림 초안을 작성하며, 초안은 먼저 승인해야 합니다.

설정하기

둘 다 OBS에 아바타와 말풍선을 표시합니다. 사용하는 기능은 AI 무대 오버레이, cohost-overlay.html.

8단계로 음성 공동 진행자 사용하기

사용하는 기능은 OpenAI Realtime이므로 OpenAI API 키가 필요합니다. 다른 선택지는 다음과 같습니다: 아래 항목.

  1. Social Stream 팝업에서 다음을 선택하세요: ChatGPT API, OpenAI 프로젝트 API 키를 붙여 넣고 다음을 클릭하세요: 선택한 챗봇 테스트.
  2. 다음을 여세요: cohost.html 링크를 팝업에서 가져오세요. 이 링크를 공개하지 마세요.
  3. 선택: OpenAI Realtime.
  4. 말할 때 사용할 마이크를 선택하세요. 다음 설정은 음성 응답(Audio Response) 를 선택한 상태로 두세요.
  5. 프레스 공동 진행자 시작.
  6. 유지: 실시간 채팅 위치: 문맥만(Context only). 언제든 ‘채팅에서 무슨 이야기를 해?’라고 물어보세요.
  7. OBS에서 공동 진행자 페이지나 앱의 오디오를 캡처하세요. AI 음성은 그곳에서만 재생됩니다.
  8. 추가: cohost-overlay.html?session=YOUR_SESSION_ID 를 OBS Browser Source로 추가하여 아바타와 말풍선을 표시하세요.
미디어 장치, AI 제공자 설정, 시스템 지침, 실시간 채팅 상태를 보여주는 cohost.html 제어 페이지
공동 진행자 페이지: 마이크, AI 제공업체, 지침, 실시간 채팅 상태.
OBS에서 별도 오디오 트랙을 쓰고 싶나요? 다음 항목에서 가상 오디오 케이블을 선택하세요: 공동 진행자 출력. 지원되는 환경에서 사용할 수 있습니다. 소리를 듣지 못하는 시청자도 따라올 수 있도록 말풍선도 표시하세요.
화면이나 카메라를 보여 줄까요? 선택 사항입니다. 영상의 시작 설정은 영상 없음. 다음을 선택하면 화면 공유 또는 카메라를 선택하면 말하거나 입력할 때마다 OpenAI에 사진 한 장을 보냅니다. 실시간 영상은 아닙니다. 비용과 지연이 늘어날 수 있습니다.
개인정보 보호: 마이크, 선택한 화면이나 카메라, 공유한 채팅 메시지가 OpenAI로 전송됩니다. 시청자는 채팅으로 공동 진행자의 도구를 실행할 수 없습니다. 공동 진행자 링크는 12시간 뒤 만료되고 자신의 세션에서만 작동하며, 페이지가 로드되면 주소 표시줄에서 제거됩니다.
OpenAI Realtime 자세히 보기
  • OpenAI API 계정에 요금이 청구됩니다. chatgpt.com과 별개이며 ChatGPT 웹사이트나 앱 대화에 참여하지 않습니다.
  • 일반 키는 Social Stream 안에 보관됩니다. 공동 진행자 페이지에는 유효 기간이 짧은 인증 정보만 전달됩니다.
  • 이 기능을 위해 Private Chat Bot 옵션을 켤 필요는 없습니다.
  • 답변 출력은 최대 512토큰으로 제한됩니다. 진단 는 총 토큰 사용량과 답변 시작 속도를 보여 줍니다.
  • 말하는 도중 끼어들면 재생을 멈추고 아직 재생하지 않은 오디오를 버립니다.
  • 기부, 멤버십, 관리자, 이벤트, 채널 정보를 포함해 최근 채팅 메시지 최대 20개를 최대 90초 유지한 뒤 잊습니다.
  • 연결이 끊기면 자동으로 다시 연결하고 OpenAI의 60분 제한 전에 새 세션을 시작합니다. 지침과 속도 설정은 유지되지만 음성 대화 내용은 잊습니다.

내 채팅을 사용하는 방식

같은 설정으로 공동 진행자 페이지를 여세요: session 를 Social Stream과 같게 하면 실시간 채팅을 볼 수 있습니다. 다음에서 방식을 선택하세요: 실시간 채팅.

Live Chat 설정역할
맥락으로만 사용하고 요청 시 답변(기본값)최근 메시지를 기억하며 채팅에 관해 물어볼 때까지 조용히 있습니다.
질문과 멘션에 음성으로 답하기질문과 멘션에 자동으로 음성 응답합니다.
모든 메시지에 음성으로 답하기모든 메시지에 음성으로 답합니다.

어떤 방식도 YouTube, Twitch 또는 Kick 채팅에 답글을 게시하지 않습니다. 문맥만(Context only) 는 OpenAI Realtime에서만 채팅을 AI에 전달합니다. 다른 제공업체는 채팅을 확인하지만 AI에 전달하지는 않습니다.

OpenAI 없이 음성 사용

실행 환경내 말을 듣는 방식
SSN 데스크톱 앱내 컴퓨터에서 실행되는 Whisper입니다. 처음에 약 42MB를 다운로드하고 이후에는 오프라인으로 작동합니다.
Chrome(확장 프로그램 링크)Chrome 음성 인식입니다. 인터넷이 필요할 수 있습니다.
다른 브라우저음성은 작동하지 않을 수 있습니다. 텍스트 입력, 실시간 채팅, 카메라 또는 화면, AI 답변은 계속 사용할 수 있습니다.

내 말을 들을 수 있는지 확인하려면 다음을 여세요: 진단. 다음과 같이 표시되어야 합니다: 듣는 중(Desktop Whisper) 또는 듣는 중(OpenAI WebRTC). 말한 내용이 다음 항목에 표시되어야 합니다: 인식한 내용(Heard).

테스트용 무료 AI

  1. 열기 Chat Bots and AI services → Configure LLM Service Provider.
  2. 선택: SSN Hosted Trial LLM(실험적).
  3. 엔드포인트, 토큰, 모델을 비워 두세요.

체험 기간에는 무료이며 중단되거나 사용량이 제한될 수 있습니다. 장기적으로 사용하려면 자신의 토큰을 추가하거나 로컬 AI를 사용하세요.

5단계로 Dock 버튼 사용하기

  1. Dock 열기: dock.html?session=YOUR_SESSION_ID.
  2. 무대 오버레이를 OBS에 추가: cohost-overlay.html?session=YOUR_SESSION_ID. 다음을 추가합니다: &tts 를 음성 재생이 필요할 때 사용하세요.
  3. 팝업에서 AI 제공업체를 설정하세요. 빠르게 테스트하려면 SSN Hosted Trial LLM.
  4. 켜기: Chat Bots and AI services → Chat Bot - Private Interface → Enable private chat bot option.
  5. Dock 메시지를 마우스 오른쪽 버튼으로 클릭하고 다음을 선택하세요: 공동 진행자(Co-host).
Co-host 메뉴가 없나요? Dock에서 같은 세션의 무대 오버레이를 감지해야 나타납니다.
버튼역할필요한 항목
공동 진행자로 읽기아바타가 메시지를 읽습니다.무대 오버레이 연결이 필요합니다. AI는 필요하지 않습니다.
답변(Answer)승인할 수 있도록 짧은 답변 초안을 작성합니다.Private Chat Bot을 켜고 AI 제공업체도 설정해야 합니다.
가벼운 놀림(Light Roast)승인할 수 있도록 짧고 장난스러우며 가족 시청에 적합한 가벼운 놀림 초안을 작성합니다.Private Chat Bot을 켜고 AI 제공업체도 설정해야 합니다.
말하기승인한 초안을 오버레이로 보냅니다.초안입니다.
복사전송하지 않고 초안을 복사합니다.초안입니다.

AI 초안은 다음을 클릭하기 전까지 읽어 주지 않습니다: 말하기. 승인은 방송 화면에 나오지 않는 Dock에서 이루어집니다.

오른쪽 클릭 메뉴는 아직 키보드를 지원하지 않습니다. 키보드 사용자는 다음 페이지에서 입력하거나 말할 수 있습니다: cohost.html 를 대신 사용하세요.

속도, 품질, 비용(OpenAI)

설정더 빠르고 저렴하게더 똑똑하지만 더 느리게
모델Mini최고 품질(비용 증가)
추론 강도Minimal 또는 LowHigh 또는 Extra high(비용 증가)
대화 전환 속도Fast는 말이 끝난 뒤 약 2초 기다립니다. 잠깐 멈추면 끼어들 수 있습니다.Balanced는 약 4초, Patient는 약 8초입니다.

추론 설정 변경은 연결된 상태에서도 적용됩니다. 진단 는 답변 시작까지 걸리는 시간을 보여 줍니다. 네트워크와 OpenAI 부하에 따라 달라질 수 있습니다.

방송 제어 맡기기

공동 진행자는 Spotify 재생, OBS 장면 전환, 채팅 메시지 강조를 할 수 있습니다. 기본값은 모두 꺼짐입니다. OpenAI Realtime은 세 기능을 모두 지원하며 SSN Configured LLM은 Spotify만 지원합니다. 다른 제공업체는 아직 지원하지 않습니다.

  1. Social Stream 팝업에서 필요한 도구만 켜세요.
  2. OBS에서 전환을 허용할 정확한 장면 이름을 쉼표로 구분해 입력하세요. 다음 설정은 actions.html 를 OBS에 연결하거나 Full Permissions가 있는 OBS Browser Source를 사용하세요.
  3. 켜짐 cohost.html를 선택하고 다음을 엽니다: 공동 진행자의 방송 제어 에서 같은 도구를 켜세요.
  4. ‘BRB로 전환해’, ‘마지막 메시지를 강조해’, ‘강조 채팅을 지워’처럼 말로 요청하세요.
도구는 본인만 실행할 수 있습니다. 시청자는 사용할 수 없습니다. 요청마다 도구 하나를 실행하며 목록에 있는 장면만 선택합니다. 메시지를 강조하려면 Dock이 열려 있어야 합니다. ‘완료’라는 답변은 요청이 전송되었다는 뜻이며 OBS나 오버레이에서 처리가 끝났다는 뜻은 아닙니다.

문제 해결

문제시도할 방법
Dock에 Co-host 메뉴가 없음같은 세션에 무대 오버레이가 열려 있지 않습니다. Primary chat bot overlay 스위치는 이 기능과 관계없습니다.
Answer 또는 Light Roast가 비활성화됨Private Chat Bot 옵션을 켜고 Social Stream이 실행 중인지 확인하세요.
Answer, Light Roast 또는 SSN Configured LLM 시간이 초과됨Social Stream이 켜져 있고 세션이 일치하며 Private Chat Bot이 켜져 있고 AI 제공업체에 연결할 수 있는지 확인하세요.
공동 진행자 페이지에 채팅이 보이지 않음동일한 값을 사용하세요: session 를 팝업과 같게 하세요. Live Chat은 Off 이외의 값으로 설정하세요.
채팅을 알고 있지만 말하지 않음Context only에서는 정상입니다. 채팅 내용을 물어보거나 다른 모드를 선택하세요.
OBS에 아무것도 표시되지 않음클릭: 오버레이 테스트 를 공동 진행자 페이지에서 열고 해당 항목이 표시되는지 확인하세요.
텍스트는 표시되지만 음성이 없음(OpenAI)확인: 음성 응답(Audio Response), 브라우저 오디오 권한, OBS의 공동 진행자 페이지 오디오 캡처를 확인하세요. 이 경우에는 &tts 는 사용하지 마세요.
두 음성이 동시에 나옴제거 &forcetts 를 오버레이 링크에서 제거하세요.
인식한 내용(Heard) 항목이 비어 있음(데스크톱)마이크가 음소거되어 있지 않은지 확인하고 첫 다운로드가 끝날 때까지 기다리세요.
인식한 내용(Heard) 항목이 비어 있음(Chrome)마이크를 허용하고 컴퓨터의 기본 마이크, 인터넷 연결, Chrome 음성 인식 사용 가능 여부를 확인하세요.
답변이 느림Mini, Low 추론, Fast 대화 전환을 사용해 보세요. Diagnostics의 Latency 항목을 비교하세요.
OpenAI 연결이 계속 끊김다시 시도하는 동안 계속 실행해 두세요. 실패 원인은 Diagnostics에 표시됩니다.
방송 제어 도구가 보이지 않음팝업과 Co-host Stream Controls 양쪽에서 켜세요. OBS에는 장면 이름이 최소 하나 필요합니다.
무료 체험 AI가 답하지 않음꺼져 있거나 사용량 제한에 걸렸을 수 있습니다. 자신의 토큰, Ollama 또는 Custom API를 사용하세요.
로컬 Gemma가 다운로드되지 않음자신이 보관한 Gemma 파일을 사용하도록 파일 호스트를 지정하세요.
여러 오버레이가 열려 있음오버레이 라벨이 Dock의 대상과 일치하는지 확인하세요. 기본값은 cohost-overlay.
음소거 및 볼륨 버튼
  • 마이크 음소거 는 공동 진행자에게 음성을 보내는 것을 중지합니다.
  • 공동 진행자 음성 음소거, 볼륨 슬라이더, 출력 선택기, 다음 항목을 확인하세요: 말하기 중지 설정으로 듣는 소리를 조절합니다.
  • 공유 시스템 오디오 음소거 는 별도 설정이며 화면을 사용할 수 있는 제공업체에서만 표시됩니다.

다음 설정을 링크 끝에 추가하세요: cohost-overlay.html 링크.

원하는 작업…링크에 추가
내 Social Stream에 연결(필수)?session=YOUR_SESSION_ID
오버레이가 말하게 하기(Dock 방식)&tts 또는 &speak=1
공동 진행자 페이지가 말하는 중에도 오버레이 음성 강제 재생(음성이 하나 더 나옴)&forcetts
오버레이 라벨 설정&label=cohost-overlay
표시 이름 바꾸기&name=NinjaBot
내 아바타 사용&avatar=https://…
위치 이동&position=bottom-right
크기 바꾸기&scale=1.2
연결 상태 표시&status

공동 진행자 페이지가 이미 음성을 재생 중이면 두 번 들리지 않도록 오버레이의 자체 음성을 생략합니다. &forcetts 는 해당 기능을 끕니다.

페이지 간 통신 방식(개발자용)

메시지 형식과 설계 참고 사항

Dock과 오버레이는 일반 Social Stream 세션 브리지를 사용합니다. 메시지는 다음 형식으로 전송됩니다: overlayNinja 페이로드로 전송되며 라벨로 대상이 지정됩니다.

공동 진행자로 읽기: 에서는 Dock이 선택한 메시지를 다음으로 바로 보냅니다: cohost-overlay.html.

답변 / 가벼운 놀림(Answer / Light Roast): 에서는 Dock이 백그라운드의 비공개 챗봇에 요청하고 초안을 표시한 뒤 Speak를 클릭해야 오버레이로 보냅니다.

{
  "action": "cohostOverlay",
  "target": "cohost-overlay",
  "meta": {
    "command": "say",
    "text": "The line the avatar should say",
    "speak": true,
    "emotion": "happy"
  }
}
  • Dock 텍스트 방식에서 오버레이는 이미지와 선택적인 TTS 음성을 담당합니다. OpenAI 음성은 다음을 캡처하세요: cohost.html 의 오디오를 별도로 캡처하세요. 오버레이는 해당 WebRTC 오디오를 다시 재생하지 않습니다.
  • 추가 명령 정보는 다음에 넣습니다: meta. 그러면 오버레이와 자동화에서 일정한 데이터 형식을 사용할 수 있습니다.