사용자는 두 번 가입하지 않습니다
이미 HarperHarbor 계정이 있는 사람은 한 번의 탭으로 당신의 앱에 로그인합니다. 잔액도 함께.
Open API v1 · Beta
당신이 만드는 모든 컴패니언 제품에서, 계정 하나와 지갑 하나
사용자는 로그인도 충전도 한 번만. 앱은 결제·인증·모델 배선을 건드리지 않고 기능에 집중합니다. 컴패니언, 버추얼 빙, 인터랙티브 스토리 제품을 위해.
#100001
사용자 한 명
지갑8,253 pts
−12 pts−8 pts
당chat.play
당신의 앱
다chat.play
다른 앱
청구서 한 장
| 09:41 | 당신의 앱 · chat.play | -12 |
| 09:38 | 다른 앱 · chat.play | -8 |
| 09:12 | 당신의 앱 · chat.play | -21 |
잔액8,253 pts
먼저 우리 제품을 돌리기 위해 만들었고, 이제 공개합니다.
당신이 연동하는 것은 우리의 대화 스테이지와 커뮤니티를 움직이는 바로 그 계정, 지갑, 모델 레인입니다. 별도의 "파트너" 버전은 없습니다.
당신의 제품에서 줄어드는 일
돈을 건드리지 않습니다
충전, 환불, 분쟁, 영수증은 플랫폼의 몫. 앱은 잔액을 읽고 호출만 합니다.
모델 교체에 배포가 필요 없습니다
모든 모델은 이름 있는 레인 뒤에 있고 자동으로 페일오버됩니다. 업스트림이 저하되면 트래픽이 이동하고 사용자에게 알립니다.
안에 있는 것
모든 컴패니언 제품에 필요하지만 두 번 만들 필요는 없는 여섯 가지.
아이덴티티와 지갑
계정 하나, 선불 잔액 하나, 앱 간 공유. 앱은 사용자의 그룹이지 소유자가 아닙니다.
페르소나 런타임
카드 플레이, 인사말, 작가 표시 규칙, 기억을 단일 제품의 채팅 화면이 아닌 서비스로 제공합니다.
모델 레인
각 모델 뒤에 여러 업스트림. 공개하는 것은 안정적인 코드명뿐. 라우팅, 상태 탐지, 페일오버는 우리가 운영합니다.
경계
고정 역할, 서버에서 강제되는 앱 범위 쿼리, 업스트림 이름 비공개, 모든 관리 작업 감사.
계량
모든 호출은 사용자·앱·서비스·레인을 가진 이벤트. 일별 집계는 지갑과 대사되며 차이는 0이어야 합니다.
오픈 API와 MCP
고정된 v1 계약. 사람에게는 OAuth 2.1, AI 클라이언트에게는 읽기 전용 MCP 도구. 같은 서비스 계층, 같은 규칙.
콘솔은 이미 돌아가고 있습니다
처리할 일을 먼저, 숫자는 그다음. 레인 상태, 한도 압박, 대사 결과가 한 화면에. 지금 보이는 것이 당신의 팀이 쓰게 될 바로 그 콘솔입니다.
개발자를 위해
한 번 등록하고, 코드를 교환하고, 호출하세요. 계약은 v1로 고정되어 어떤 언어에서도 동작합니다.
AI 클라이언트는 같은 토큰으로 MCP를 통해 사용량과 레인 상태도 읽을 수 있습니다.
퀵스타트 열기# 1. exchange the authorization code (PKCE)
curl -X POST https://api.harperharbor.com/oauth/token \
-d grant_type=authorization_code -d code=$CODE \
-d client_id=$CLIENT_ID -d redirect_uri=$REDIRECT_URI \
-d code_verifier=$VERIFIER -d resource=https://api.harperharbor.com/open/v1
# 2. who is signed in
curl https://api.harperharbor.com/open/v1/me \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "language: en"사용한 만큼. 월정액 없음.
사용자는 포인트를 선결제하고 앱은 무료로 연동합니다. 모델·레인별 단가는 누군가 포인트를 쓰기 전에 공개됩니다.
사용자는 포인트를 선결제
포인트는 만료되지 않습니다. 어느 앱이 호출하든 사용자의 유일한 지갑에서 차감됩니다.
앱은 비용 없음
좌석 요금도, 수익 배분도, 최소 약정도 없습니다. 유일한 제한은 플랫폼을 보호하는 일일 한도입니다.
단가는 공개
모델·레인별 가격은 콘솔과 제품 안에서 사용하는 순간 표시됩니다.
명확한 경계
- 01
앱은 자신의 사용자만 봅니다
잔액도, 다른 앱의 활동도 보이지 않습니다. 범위는 UI가 아니라 쿼리에서 강제됩니다.
- 02
모든 관리 작업은 감사됩니다
누가, 언제, 무엇을, 어떤 경로로(콘솔, API, SSO, cron). 180일 보관.
- 03
사용자는 떠날 수 있습니다
사용자는 한 번의 클릭으로 어떤 앱의 승인이든 취소할 수 있고, 그 토큰은 즉시 무효화됩니다.
자주 묻는 질문
캐릭터 채팅 API인가요?
카드 플레이는 첫 서비스지만, 제품은 그 아래 계층입니다: 공유 아이덴티티, 하나의 지갑, 모델 레인, 계량, 경계. 어떤 컴패니언 경험도 그 위에 올릴 수 있습니다.
내 사용자에게 직접 과금하고 싶다면?
그렇다면 아직은 맞지 않습니다. HarperHarbor의 앱은 과금도 정산도 하지 않습니다. 그것이 "돈을 건드리지 않는" 대가입니다. 정산은 로드맵에 있지만 약속은 아닙니다.
어떤 모델을 운영하나요?
우리는 벤더 이름이 아니라 레인을 공개합니다. 레인은 실시간 상태와 가격을 가진 안정적인 코드명이며, 뒤에서 여러 업스트림을 오갈 수 있습니다.