Neocortex Logo

Web SDK

어떤 웹사이트에든 넣는 AI 캐릭터

npm 패키지 하나를 설치하고, 서버에 작은 프록시를 추가한 뒤, 말하는 캐릭터를 어떤 페이지에든 올리세요. API 키는 절대 브라우저에 노출되지 않습니다.

  • 무료 플랜
  • 신용카드 필요 없음
  • Unity, Unreal, Godot, Web SDK, Web API 지원
손을 흔들며 인사하는 Neocortex AI 캐릭터 Cora
  • 5

    가지 연동 방식

    Unity, Unreal, Godot, Web SDK, Web API

  • 20+

    개 언어 지원

    캐릭터마다 설정

  • 10초

    면 음성 복제 완료

    텍스트로 새 음성 디자인도 가능

  • €0

    로 시작

    무료 플랜, 에디터 테스트 무료

업계 선도 기업들이 함께합니다

CDG Booster ProgramTehnopol AI AcceleratorNvidia Inception ProgramMicrosoft Partner | Microsoft for StartupsAWS Partner | AWS StartupsCloudflare Startup ProgramFal AI Startup ProgramElevenLabs Grants
CDG Booster ProgramTehnopol AI AcceleratorNvidia Inception ProgramMicrosoft Partner | Microsoft for StartupsAWS Partner | AWS StartupsCloudflare Startup ProgramFal AI Startup ProgramElevenLabs Grants

시작하기

Web SDK에서 말하는 캐릭터를 만나기까지

  1. 1

    패키지 설치

    프로젝트에 SDK를 추가하세요:

    npm install @neocortex-link/web
  2. 2

    프록시 추가

    서버에 createNeocortexHandler를 마운트하세요. API 키를 서버에 보관하고, 누가 대화하는지 확인하며, 접근할 수 있는 캐릭터를 제한합니다.

  3. 3

    캐릭터 배치

    어떤 페이지에든 채팅 요소를 배치하세요:

    <neocortex-chat endpoint="/api/neocortex" character-id="..." voice></neocortex-chat>

요구 사항

  • 서버: Node 20+, Next.js, Cloudflare Workers, Bun 또는 Deno
  • 모든 최신 브라우저
  • 무료 Neocortex 계정과 API 키
Web SDK 문서 읽기

제공 기능

Web SDK 개발자를 위해 만들었습니다

01

키는 서버에

내장 프록시가 키를 보관하고, 여러분의 로그인 시스템으로 사용자를 확인하며, 허용하지 않은 요청은 모두 거부합니다.

02

바로 쓰는 컴포넌트

채팅, 그룹 채팅, 퀴즈, 마이크, 상태 요소가 React, Vue, Svelte, 일반 HTML에서 작동합니다.

03

스트리밍 음성

응답이 도착하자마자 순식간에 말을 시작합니다.

04

음성 입력

음성 감지나 푸시 투 토크를 지원하는 마이크로 말하면, 캐릭터 쪽에서 텍스트로 변환합니다.

05

액션과 감정

캐릭터가 취하는 액션에 핸들러를 등록하고, 감정에 반응하세요.

06

테마 적용

CSS 커스텀 속성으로 모든 요소의 스타일을 바꿀 수 있으며, 라이트와 다크 모드를 지원합니다.

07

사용자에 묶인 대화

세션 ID는 서명된 토큰으로 브라우저에 전달되므로, ID를 추측해 다른 사람의 대화를 읽거나 이어 갈 수 없습니다.

08

실제 응답만 음성으로

프록시는 캐릭터가 해당 사용자에게 실제로 한 대사만 음성으로 변환하므로, 캐릭터의 목소리로 임의의 문장을 말하게 할 수 없습니다.

09

사용자별 요청 한도

사용자마다 요청 한도가 있고 대화당 진행 중인 턴은 하나뿐이며, Redis나 KV용 리미터를 끼워 쓸 수 있습니다.

작동 방식

일일이 붙잡고 있는 프롬프트가 아니라, 직접 디자인하는 캐릭터

  • 성격, 감정, 지식, 세계를 프롬프트로 다시 쓰는 대신 노드로 연결합니다.
  • 인텐트와 액션이 플레이어의 말을 게임 속 동작으로 바꿉니다.
  • 엔진에 넣기 전에 모든 캐릭터를 브라우저에서 무료로 테스트하세요.
neocortex.link/dashboard/characters
Neocortex 비주얼 캐릭터 에디터: 감정, 성격, 지식, 언어, 음성 노드가 세계 속 에이전트에 연결되어 있고, 인텐트가 게임 내 액션에 연결된 모습

고객들의 이야기

Neocortex로 개발하는 크리에이터들의 이야기를 확인해 보세요.

여러 스마트 NPC 솔루션을 써 본 뒤, 가상 교육 플랫폼에 쓸, 대화 상태를 유지하는 AI를 찾다가 Neocortex를 알게 되었습니다. Neocortex는 단연 돋보였고 저희의 핵심 기준을 모두 충족했습니다.

Vallikat Peethamber
대표이사

Neocortex 덕분에 VR 플랫폼에 확장 가능한 솔루션을 도입하고, 훈련을 훨씬 더 몰입감 있게 만드는 시나리오를 구성할 수 있었습니다. AI 에이전트를 명확한 범위 안에 두는 것은 어려운 일인데, Neocortex는 이를 아주 잘 해내고 커스터마이징도 쉽습니다.

Ottó Farkas
IT 전문가 / 프로젝트 매니저

수업에서 Neocortex와 액션 기반 메커니즘은 학생들이 대화형 에이전트를 소프트웨어와 하드웨어 기반 인터랙션 디자인 작업에 바로 연결할 수 있는 방법을 제공합니다.

Hongming Li
강사 / 교수자

졸업 프로젝트를 진행하다가 Neocortex를 알게 되었는데, 연동이 쉽고 접근성이 좋아 제 애플리케이션에 스마트 NPC를 매끄럽게 구현할 수 있었습니다. 강력히 추천합니다!

Angela Pellillo
백엔드 개발자

Neocortex는 LLM 기반 NPC를 실제 Unity3D 프로토타입에 담아내는 첫걸음이었습니다. 개발 속도가 빨라졌고, 제 TikTok 계정은 한 달 만에 팔로워 0명에서 4000명으로 늘었습니다!

Brandan Chen
어소시에이트 게임 프로듀서

여러 스마트 NPC 솔루션을 써 본 뒤, 가상 교육 플랫폼에 쓸, 대화 상태를 유지하는 AI를 찾다가 Neocortex를 알게 되었습니다. Neocortex는 단연 돋보였고 저희의 핵심 기준을 모두 충족했습니다.

Vallikat Peethamber
대표이사

Neocortex 덕분에 VR 플랫폼에 확장 가능한 솔루션을 도입하고, 훈련을 훨씬 더 몰입감 있게 만드는 시나리오를 구성할 수 있었습니다. AI 에이전트를 명확한 범위 안에 두는 것은 어려운 일인데, Neocortex는 이를 아주 잘 해내고 커스터마이징도 쉽습니다.

Ottó Farkas
IT 전문가 / 프로젝트 매니저

수업에서 Neocortex와 액션 기반 메커니즘은 학생들이 대화형 에이전트를 소프트웨어와 하드웨어 기반 인터랙션 디자인 작업에 바로 연결할 수 있는 방법을 제공합니다.

Hongming Li
강사 / 교수자

졸업 프로젝트를 진행하다가 Neocortex를 알게 되었는데, 연동이 쉽고 접근성이 좋아 제 애플리케이션에 스마트 NPC를 매끄럽게 구현할 수 있었습니다. 강력히 추천합니다!

Angela Pellillo
백엔드 개발자

Neocortex는 LLM 기반 NPC를 실제 Unity3D 프로토타입에 담아내는 첫걸음이었습니다. 개발 속도가 빨라졌고, 제 TikTok 계정은 한 달 만에 팔로워 0명에서 4000명으로 늘었습니다!

Brandan Chen
어소시에이트 게임 프로듀서

아이디어에서 플레이 가능한 캐릭터까지, 주말 한 번이면 충분합니다

게임 잼 팀들은 Neocortex로 말하고 행동하는 AI 캐릭터를 주말 한 번 만에 플레이 가능한 게임에 넣습니다.

게임 잼 사례 읽기

FAQ

Web SDK용 Neocortex: 자주 묻는 질문

Neocortex Web SDK는 무료인가요?

SDK는 Apache-2.0 오픈소스입니다. 대화에는 Neocortex 플랜의 크레딧이 쓰이며, 무료 플랜도 있습니다.

왜 서버가 필요한가요?

Neocortex API 키는 비밀 정보입니다. SDK의 프록시가 서버에서 실행되므로, 누구나 키를 읽고 써 버릴 수 있는 브라우저에 키가 닿지 않습니다.

React나 Vue에서도 작동하나요?

네. UI는 표준 Web Components로 만들어져 React, Vue, Svelte, Angular, 일반 HTML에서 작동합니다.

UI를 직접 만들 수 있나요?

네. 브라우저 클라이언트가 SmartAgent, GroupDirector, QuizAgent 클래스를 제공하며, 모든 대사, 감정, 액션에 대한 이벤트를 받을 수 있습니다.

Cloudflare Workers 같은 서버리스 호스트에서도 Web SDK가 작동하나요?

네. 핸들러는 표준 Request를 받아 Response를 돌려주는 함수이고 서명은 상태를 저장하지 않으므로, 공유 저장소가 필요 없습니다. 여러 인스턴스에 걸친 전역 요청 한도가 필요하면 KV나 Durable Objects 기반의 RateLimiter를 넘기세요.

웹사이트에 퀴즈를 넣을 수 있나요?

네. 캐릭터 ID와 문제 세트 ID를 지정해 <neocortex-quiz> 요소를 페이지에 넣기만 하면, 내 캐릭터가 문제, 선택지, 힌트, 진행 상황, 리더보드를 모두 갖춘 퀴즈를 진행합니다. 직접 만든 UI에서는 QuizAgent 클래스로 똑같이 구현할 수 있습니다. 퀴즈는 Team 플랜에서 사용할 수 있습니다.

사용자 계정이 없는 사이트에서도 쓸 수 있나요?

네. 서버가 설정하는 서명된 httpOnly 쿠키로 방문자마다 고정 ID를 부여하세요. 요청 한도와 크레딧 상한이 이 ID를 기준으로 적용되기 때문입니다. 저장소의 퀵스타트 예제가 바로 이렇게 동작합니다.

응답이 브라우저에 닿기 전에 검토할 수 있나요?

네. 프록시의 filterText 옵션으로 서버에서 모든 응답을 수정하거나 검토할 수 있습니다.

Three.js나 PlayCanvas 게임에서도 쓸 수 있나요?

네. 컴포넌트는 Three.js와 PlayCanvas 페이지에서 작동하며, 음성 플레이어가 getLevel()을 제공하므로 음성에 맞춰 입을 움직일 수 있습니다.

도구를 비교 중이신가요?

Web SDK 팀이 보는 Neocortex 비교

사이트에 캐릭터를 올려 보세요

무료 플랜, 신용카드 필요 없음. 브라우저에서 캐릭터를 만들고 몇 분 만에 대화해 보세요.