Open API v1 · Beta

你的每一個陪伴型產品,共用同一個帳號與同一個錢包

用戶只登入一次、只儲值一次。你的應用只做功能,不碰計費、身分與模型接線。為陪伴、虛擬人與互動敘事產品而生。

一位用戶、兩個應用、一份帳單。整個模式就這麼一張圖。2026-09
#100001
一位用戶
錢包8,253 pts
−12 pts−8 pts
你的應用
用 HarperHarbor 登入
chat.play
另一個應用
用 HarperHarbor 登入
chat.play
一份帳單
09:41你的應用 · chat.play-12
09:38另一個應用 · chat.play-8
09:12你的應用 · chat.play-21
餘額8,253 pts

我們先拿它跑自己的產品,現在把它開放出來。

你接入的,就是驅動我們自己的對話舞台與社群酒館的那套帳號、錢包與模型線路。沒有另一個「合作夥伴」版本。

你的產品會少做哪些事

01

用戶不用重複註冊

已經有 HarperHarbor 帳號的人,一鍵就能登入你的應用,餘額也一起帶過來。

02

你不用碰錢

儲值、退款、爭議與收據是平台的事。你的應用只讀餘額、發請求。

03

換模型不用上線

每個模型都藏在有名字的線路後面,自動備援。上游降級時流量自動切走,並告知用戶。

底下是什麼

每個陪伴型產品都需要、卻不該重做第二次的六件事。

身分與錢包

一個帳號、一份預付餘額,跨應用共用。應用是用戶的分組,永遠不是擁有者。

人格運行時

卡片遊玩、開場白、作者顯示規則與記憶,以服務的形式提供,而不是某一個產品的聊天畫面。

模型線路

每個模型背後有多家上游,對外只公佈穩定的代號。路由、健康探測與備援由我們負責。

邊界

固定角色、伺服器端強制的應用範圍查詢、上游名稱永不外露、每筆管理操作都有審計。

計量

每次呼叫都是一筆帶用戶、應用、服務、線路的事件。每日彙總與錢包對帳,差額必須為零。

開放 API 與 MCP

凍結的 v1 契約,人用 OAuth 2.1,AI 客戶端用只讀 MCP 工具——同一套服務層、同一套規則。

控制台已經在跑

先看要處理的事,再看數字:線路健康、配額壓力、對帳結果在同一個畫面。你看到的,就是你的團隊將來用的那一個控制台。

平台總覽 · 公開版使用示意資料
平台總覽 · 公開版使用示意資料

給開發者

登記一次、換一個授權碼、發一個請求。契約在 v1 凍結,任何語言都接得上。

AI 客戶端也能用同一個 token,透過 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"

按用量付費,沒有月費。

用戶預付點數,應用免費接入。每個模型與線路的價格在任何人花掉一點之前就已公開。

用戶預付點數

點數不過期。每次呼叫都從用戶唯一的錢包扣,不管是哪個應用發起的。

應用不付錢

沒有席位費、沒有分成、沒有最低消費。唯一的限制是保護平台的每日配額。

價格公開

每個模型與線路的單價在控制台與產品內使用當下都看得到。

看定價怎麼運作 →

邊界清楚

  1. 01

    應用只看得到自己的用戶

    看不到餘額,看不到其他應用的行為。範圍在查詢層強制,不是靠介面遮。

  2. 02

    每筆管理操作都有審計

    誰、何時、做了什麼、透過哪個管道——控制台、API、SSO 或排程。保留 180 天。

  3. 03

    用戶可以離開

    用戶一鍵就能解除任何應用的授權,該應用的 token 立即失效。

常見問題

這是角色聊天 API 嗎?

卡片遊玩是第一個服務,但產品是底下那一層:共用身分、唯一錢包、模型線路、計量與邊界。任何陪伴型體驗都能放在上面。

我想自己向用戶收費怎麼辦?

那目前還不適合你。HarperHarbor 上的應用不收費也不結算,這是「永遠不碰錢」的交換條件。結算在路線圖上,但不是承諾。

你們跑哪些模型?

我們公佈線路,不公佈供應商名稱。線路是一個穩定代號,帶即時健康狀態與價格;背後可能有多家上游,流量會在它們之間移動。

把產品做出來,接線交給我們。

一期由平台團隊協助接入。告訴我們你在做什麼。

申請接入