AI Prosumer
YUE

用 SHAREAI 建設

點對點教學:點樣連接應用程式到 ShareAI Builder

建立一個預約應用程式,連接客戶到 ShareAI,準備有用嘅 AI 議程,並控制佢哋嘅 AI 開支。

你將會建立嘅體驗

JamZY · 預約
真實嘅 JamZY 預約演示:選擇一個服務同時間,然後可選連接 ShareAI 生成準備。

揀一個預約。連接 ShareAI。帶住計劃到達。

你嘅實施

一個可以建立基礎嘅客戶連接。

三個具體交付成果:連接客戶、準備佢哋嘅預約,並令整合準備好驗證。

獲取實施參考
01客戶訪問

登錄同可續期會話

客戶揀選佢哋嘅 ShareAI 帳戶,批准你嘅應用程式,並返回到 JamZY。

OAuth + PKCE帳戶同意
你可以喺以下情況驗證:

成功登錄、刷新會話同斷開連接。

建立客戶連接
02預約 AI

一個有用嘅準備草稿

通過有計劃嘅 AI 請求,將預約目標轉化為議程同問題。

客戶資助嘅 AI模型訪問
你可以喺以下情況驗證:

生成草稿;儲存預約唔會進行 AI 呼叫。

建立準備流程
03條款 & 審查

一個可以驗證嘅設置

解釋可選嘅 AI 費用,並收集平台審查提交所需嘅檢查。

接受嘅合約平台檢查
你可以喺以下情況驗證:

每個包含嘅平台同請求範圍都有記錄檢查。

設置條款並驗證應用程式

帶到你嘅編輯器

同你嘅代理一齊建設。

複製完整指南,包括實施目標、所需輸入同接受檢查。保持代碼範例、表格同文檔鏈接一齊。

完整指南實施背景驗證檢查
更多格式
以 Markdown 查看 下載 Markdown

為你嘅項目準備好,按你需要嘅格式。

已更新

睇下你將會建立嘅內容

你將建立一個客戶可以理解嘅連接:佢哋嘅ShareAI帳戶、一個可選嘅AI準備草稿,以及一條清晰嘅路徑返去佢哋嘅約會。

你將會工作嘅地方 你完成嘅示例

將你嘅應用程式連接到ShareAI Builder,從註冊到測試集成準備審核。呢個操作指南使用JamZY,一個細型Node.js約會應用程式,展示每一步:註冊應用程式、配置佢嘅Web平台、連接客戶嘅ShareAI帳戶並發送授權嘅AI請求。將相同步驟應用到你自己嘅產品。

功能客戶同意嘅內容JamZY展示嘅內容
用ShareAI登入一個帳戶連接以及你嘅應用程式請求嘅身份信息。從已認證嘅用戶信息中獲得嘅私人客戶身份。
用ShareAI付款 · AI使用使用客戶選擇嘅個人或組織帳戶進行授權推斷。由該帳戶合資格嘅信用資金支持嘅約會準備草稿。
Builder 加價接受應用程式合同中嘅額外AI使用費。可選使用貨幣化,經批准及合同發佈後。
產品付款喺單獨嘅ShareAI結帳中呈現嘅特定購買。喺 付款操作指南中解釋嘅擴展。約會演示唔會實施結帳。

擁有一個ShareAI帳戶,使用個人或組織帳戶擁有應用程式嘅許可權、一個公共HTTPS回調、一個標誌,以及有效嘅隱私、條款及帳戶刪除頁面。要運行示例,請使用Node.js 22或更新版本以及應用程式嘅HTTPS地址。

JamZY · 約會參考應用程式 放大截圖 ↗
真實嘅 JamZY 預約演示:選擇一個服務同時間,然後可選連接 ShareAI 生成準備。
本地預約安排同客戶資助嘅 AI 準備係分開嘅操作。呢個演示唔會發送日曆邀請。
  1. 選擇預約類型同持續時間。
  2. 揀一個可用嘅演示時段。
  3. 連接 ShareAI 使用可選嘅 AI 助手。
  4. AI 只喺呢個明確操作之後運行;單單預約唔會調用 ShareAI。
使用你自己嘅應用程式詳細信息

截圖使用示例應用程式嘅詳細資料。ShareAI 喺呢個指南入面嘅地址係生產地址。生成準備會發出真實嘅AI請求並可能消耗點數;選擇或者保存示範預約唔會。驗證檢查由你自己成功嘅整合測試完成。

當你準備好繼續嘅時候

你可以區分帳戶登入、AI消耗、可選附加費同確認嘅產品購買。閱讀呢個指南唔需要付費請求。

加入 Builder 計劃

你會創建擁有你應用程式同其客戶關係嘅Builder身份。

你將會工作嘅地方 控制台 → Builder Program

  1. 創建或者登入你嘅 ShareAI 帳戶。選擇個人或者組織帳戶去擁有 JamZY;喺整個設置過程中使用相同嘅帳戶。
  2. 打開 Builder Program 喺 ShareAI 控制台選擇符合你工作嘅Builder活動。對於呢個指南,選擇你擁有嘅應用程式嘅產品公司路徑。客戶工作係為客戶提供服務;整合係連接現有嘅應用程式。
  3. 選擇個人或者組織帳戶嚟擁有項目註冊資格,喺申請之前。組織可以喺驗證之前提交申請,但僅僅員工批准唔會激活訪問權限。喺Console嘅入門清單完成組織電郵同公司驗證。一個已批准嘅組織會保持「待驗證」狀態,直到兩個檢查都完成。Builder、Provider同Creator項目遵循呢個規則。
  4. 接受後,打開 Builder Program → Product。角色切換器識別你編輯嘅帳戶。
Builder Program · 註冊入口點 放大截圖 ↗
Builder Program 登陸頁介紹產品路徑並鏈接到 Console 嘅註冊。
從產品路徑開始,然後完成註冊擁有 JamZY 嘅帳戶。
  1. 繼續到 Console 註冊 Builder Program。
當你準備好繼續嘅時候

Builder Program 為指定擁有者開啟,並提供「新應用程式」。註冊決定、應用程式審查、公開資訊審查同埋 Monetization Gateway 批准係獨立步驟。

佢哋嘅知情選擇。

你會畀 JamZY 佢自己嘅應用程式記錄,咁佢嘅身份、訪問同商業條款可以保持一致。

你將會工作嘅地方 建設者計劃 → 產品 → 新應用

  1. 喺 Product 中,選擇 New app。輸入你嘅公共網站去填充初始詳細資料,或者選擇我會手動填寫。
  2. 上載 PNG 或 JPEG 標誌,輸入 JamZY 作為名稱,並用一句清晰嘅句子描述產品。檢查網站同Builder聯絡電郵。
  3. 繼續進入設置問題。保持答案真實:佢哋描述咗應用程式係點交付同支付嘅。
應用程式設置 · 詳細資料 放大截圖 ↗
喺繼續之前查看應用程式名稱、介紹、標誌同公共網站。聯繫方式係示例性嘅。
喺繼續之前查看應用程式名稱、介紹、標誌同公共網站。聯繫方式係示例性嘅。
  1. 為應用程式提供一個清晰嘅名稱。
  2. 繼續到入門問題。

用一個可到達嘅公共網站嚟做應用程式嘅檔案。私人或者只限本地嘅網站可能會驗證失敗,即使你嘅開發回調已經正確註冊。新應用程式會以草稿形式開始。你可以繼續編輯而唔需要將佢公開。佢嘅應用程式識別碼同 OAuth 客戶端 ID 或訂閱 ID 係唔同嘅。

當你準備好繼續嘅時候

JamZY 會喺產品下出現,係畀預期擁有者嘅。唔好為每個設備平台創建額外嘅應用程式。

描述你嘅應用程式係點交付嘅

你會獲得適合你應用程式運行位置同控制憑證嘅 OAuth 選項。

你將會工作嘅地方 新應用 → 應用程式設置

對於一個JamZY部署,你自己操作,選擇符合你提供嘅定價模式,例如SaaS、供應商託管嘅雲端應用程式、客戶支付佢哋自己嘅消耗,以及ShareAI用於AI請求。呢啲係示例答案,唔係每個產品嘅要求。

應用程式設置 · 部署 放大截圖 ↗
入門答案決定伺服器客戶端密碼是否可用。
入門答案決定伺服器客戶端密碼是否可用。
  1. 選擇你嘅應用程式實際運行嘅地方。
應用程式運行嘅位置OAuth選擇資格憑證存放嘅位置
你託管嘅後端網頁伺服器客戶端可能會使用客戶端密碼。PKCE仍然適用。密碼同令牌會留喺你嘅伺服器上。
瀏覽器應用程式 / SPA使用PKCE嘅公共網頁客戶端。無嵌入式客戶端密碼。使用適當嘅瀏覽器或後端會話設計。
自託管或混合分發根據入門政策使用PKCE嘅公共客戶端。唔好將共享供應商密碼分發到客戶安裝。
Windows、macOS、Linux、Android或iOS每個啟用平台都有一個公共客戶端。PKCE同平台適用嘅安全存儲;無捆綁密碼。

可下載嘅JamZY示例特意使用咗一個帶有PKCE嘅公共網頁客戶端,即使佢有一個小型後端。伺服器會將令牌保留喺瀏覽器存儲之外。供應商託管答案允許伺服器客戶端;佢唔會強制你選擇一個。

你可以喺應用程式信息 → 應用程式設置中重新訪問已保存嘅答案。部署更改可能會移除不兼容嘅客戶端密碼,並需要重新驗證。喺保存之前檢查影響。

當你準備好繼續嘅時候

已保存嘅部署描述咗你嘅真實架構。客戶端密碼選項遵循嗰個答案;禁用嘅選項係政策嘅解釋,而唔係缺少資格憑證。

需要詳細資料?客戶端註冊 ↗

清楚介紹你嘅應用程式

你會喺客戶決定連接之前提供佢哋需要嘅產品詳細信息同政策。

你將會工作嘅地方 應用程式信息

喺儀表板之後打開應用程式信息。逐步完成專用部分:詳細信息、應用程式設置、展示、品牌、畫廊同審查。為產品提供有用嘅描述、準確嘅網站同清晰嘅客戶工作流程截圖。

應用程式信息 放大截圖 ↗
為你嘅應用程序命名,介紹同公共 HTTPS 網站。
為你嘅應用程序命名,介紹同公共 HTTPS 網站。
  1. 喺各自嘅部分開發詳細信息、設置、展示同品牌。

使用你自己嘅應用程式身份。ShareAI品牌應該用喺集成按鈕同解釋材料上;佢唔應該取代你嘅產品標誌。保持隱私、條款同刪除鏈接喺無需登錄嘅情況下可訪問。

當浮動保存操作出現時保存更改。公共信息提案有自己嘅審查;編輯已批准嘅提案唔會靜默替換現場公共展示。

當你準備好繼續嘅時候

訪客可以理解JamZY嘅作用、由邊個操作,以及點樣請求刪除。公共詳細信息同回調配置指向同一個產品。

選擇客戶可以授權嘅內容

你會請求你嘅預約體驗實際使用嘅訪問權限,並清楚說明其計費用途。

你將會工作嘅地方 應用程式 → 使用案例

喺使用案例中,啟用用 ShareAI 登錄連接帳戶,並用 Pay with ShareAI 支援你想支持嘅客戶資助流程。只喺你嘅產品會喺AI使用上賺取額外費用嘅情況下,申請 Monetization Gateway 訪問。跟隨Console顯示嘅批准狀態。

使用案例 放大截圖 ↗
Log-in with ShareAI、Pay with ShareAI同埋Monetization Gateway有獨立嘅配置同埋審批狀態。
Log-in with ShareAI、Pay with ShareAI同埋Monetization Gateway有獨立嘅配置同埋審批狀態。
  1. 配置登入功能,用ShareAI。
  2. 啟用客戶資助嘅使用。
範圍點解你會請求佢
openid使用其客戶範圍身份連接帳戶。
profile / email只有當你嘅產品需要時,先請求個人資料或電郵聲明。
inference當應用程式配置允許時,調用支持嘅AI推理端點。
monetization_gateway使用客戶接受嘅AI計費協議進行附加費推理。
payments創建同檢查客戶付款請求。每次購買仍然需要確認。

JamZY請求 openid profile inference monetization_gateway。佢唔會請求 payments 並且唔會通過結帳銷售產品。喺Console中啟用功能唔會將其授予現有訪問令牌:客戶必須授權範圍同條款。

當你準備好繼續嘅時候

功能、配置範圍同授權請求一致。避免請求你嘅應用程式從未使用或無法驗證嘅可選訪問。

設置你嘅Web集成

你會為基於瀏覽器嘅JamZY體驗創建一個Web客戶端,並使用正確嘅身份驗證方法。

你將會工作嘅地方 OAuth設置 → Web

  1. 打開OAuth設置。喺平台網格中選擇Web。你可以為每個平台配置一個客戶端:Web、Windows、macOS、Linux、Android同iOS。
  2. 對於呢個示例,選擇瀏覽器應用程式 / SPA,公共PKCE客戶端。只有當你嘅部署政策允許並且你嘅後端可以保護秘密時,Server網頁應用程式先係合適嘅。
  3. 複製你自己嘅Web客戶端ID。喺你整合佢期間,保持平台喺測試狀態。千祈唔好從截圖中複製ID,或者將共享演示嘅註冊用於唔同嘅產品。
OAuth設置 · 平台網格 放大截圖 ↗
每個平台一個註冊客戶端。未配置平台保持可選。
每個平台一個註冊客戶端。未配置平台保持可選。
  1. 打開單一 Web 集成。
  2. 只有當你嘅產品支持時,添加 Android。
Web · 概覽 放大截圖 ↗
公共 Web 客戶端使用 PKCE,並無客戶端密鑰。客戶端 ID 係已隱藏。
公共 Web 客戶端使用 PKCE,並無客戶端密鑰。客戶端 ID 係已隱藏。
  1. 複製你自己嘅 Web 客戶端 ID。
  2. 公共客戶端唔會收到密鑰。

唔同平台有唔同嘅憑據同回調規則。佢哋唔係獨立產品:訂閱同客戶管理係為應用程式聚合嘅。應用程式測試者喺平台之間共享,最多五個位置,包括待處理邀請;擁有者唔會佔用測試者位置。

當你準備好繼續嘅時候

僅存在一個Web平台。你未配置嘅原生平台唔會阻止你嘅啟動。

需要詳細資料?平台註冊 ↗

帶客戶返去你嘅應用程式

你會喺授權之後將客戶返回你嘅應用程式,使用你擁有嘅準確回調地址。

你將會工作嘅地方 網頁 → 配置

喺網頁 → 配置入面,註冊你嘅應用程式處理嘅準確HTTPS回調地址。呢個指南使用 https://jamzy.example/oauth/callback 作為例子。將 jamzy.example 替換成你部署JamZY副本嘅HTTPS域名,並喺你嘅應用程式配置入面使用相同嘅回調地址。

網頁 · 配置 放大截圖 ↗
註冊你部署應用程式處理嘅回調。
註冊你部署應用程式處理嘅回調。
  1. 註冊你部署應用程式處理嘅回調。

提供同意畫面名稱、條款、隱私同刪除資訊。只啟用你需要嘅範圍,然後保存。方案、主機、路徑同適用嘅查詢詳情必須同授權請求同埋代碼交換匹配。唔好使用通配符或者URL片段。

平台創建/輪換密鑰要實現嘅回調
網頁你應用程式上嘅準確HTTPS地址。
Android一個同應用程式ID匹配嘅反域名應用程式方案,或者一個經驗證嘅帶有包名同SHA-256簽名指紋嘅HTTPS應用程式鏈接。
iOS一個匹配嘅應用程式方案,或者一個經驗證嘅帶有Bundle ID同Apple App ID前綴嘅HTTPS通用鏈接。
Windows / macOS / Linux一個允許嘅準確HTTPS回調、一個匹配嘅反域名應用程式方案,或者一個支持嘅127.0.0.1 / [::1]上嘅回環重定向。回環端口可以變化。

已安裝嘅應用程式喺系統瀏覽器中授權,並通過已註冊嘅回調返回。對於聲稱嘅HTTPS應用程式鏈接,發佈所需嘅關聯文件,並喺Console中運行關聯驗證。喺表單中睇落合理嘅回調唔係證明你已安裝嘅應用程式收到咗佢。

當你準備好繼續嘅時候

通過授權流程打開回調會返回到你嘅應用程式。一個隨機代碼或者唔匹配嘅狀態會被拒絕。

運行你自己嘅JamZY應用程式

你將會有約會介面同佢嘅ShareAI連接,喺你自己嘅應用程式標識符下運行。

你將會工作嘅地方 你嘅應用程式 → 環境配置

JamZY係一個帶有可選AI準備助手嘅約會應用程式。佢嘅排程器係一個僅限瀏覽器嘅演示:冇日曆提供者、電郵發送或者約會付款。ShareAI授權同AI API集成使用真實配置嘅上游。

下載 JamZY參考源代碼。佢包含Node服務器、瀏覽器UI、測試同一個設置README;冇證書、密鑰、依賴項或者會話。喺運行佢哋之前檢查文件。將Node進程放喺一個保留公共來源嘅HTTPS反向代理後面。

# .env — replace both identifiers with YOUR registered application.
JAMZY_PUBLIC_ORIGIN=https://jamzy.example
SHAREAI_CLIENT_ID=YOUR_WEB_CLIENT_ID
SHAREAI_APP_ID=YOUR_APPLICATION_UUID
SHAREAI_AUTH_ORIGIN=https://auth.shareai.now
SHAREAI_API_BASE_URL=https://api.shareai.now/api/v1
SHAREAI_SCOPES="openid profile inference monetization_gateway"
PORT=3443
BIND_HOST=127.0.0.1
# Node 22+, behind your HTTPS reverse proxy
node --env-file=.env server.mjs

# Mocked upstream tests; these do not spend credits
node --test test/server.test.mjs
保持環境一致

喺 控制台.shareai.now創建你嘅應用程式。使用佢嘅生產客戶端ID同 https://auth.shareai.now 同埋 https://api.shareai.now/api/v1。呢個 jamzy.example 地址係你應用程式嘅佔位符,唔係託管演示。通過HTTPS提供你自己嘅應用程式,咁佢嘅安全會話Cookie先可以正常運作。

JamZY亦提供一個API密鑰連接作為比較。呢個操作指南使用wallet/OAuth按鈕。API密鑰唔會建立客戶嘅JamZY OAuth協議,亦唔可以取代客戶授權流程。

當你準備好繼續嘅時候

應用程式通過HTTPS加載。佢嘅公共來源、已註冊回調同客戶端ID同你嘅註冊匹配。頁面源代碼或者localStorage中唔會出現任何令牌或者密鑰。

連接你嘅第一個客戶

你會讓客戶揀佢哋嘅ShareAI帳戶,並批准你嘅應用程式需要嘅訪問權限。

你將會工作嘅地方 JamZY → 用你嘅ShareAI錢包付款

喺JamZY中,揀用你嘅ShareAI錢包付款。應用程式會打開ShareAI授權頁面。客戶登錄,揀一個個人或者組織帳戶,檢查應用程式同請求嘅訪問權限,並接受適用嘅訂閱條款。

  1. JamZY → 認證建立一個隨機嘅 state 同埋一個 PKCE 驗證碼;喺授權請求中發送其 S256 挑戰。
  2. 客戶 → 認證揀支付帳戶並檢視訪問同埋收費條款。取消必須令 JamZY 保持未連接狀態。
  3. 認證 → 回調接收一個短期有效、一次性嘅代碼同埋 state。根據相同嘅 session 驗證 state。
  4. 後端 → 令牌用原始驗證碼同埋相同嘅重定向 URI 交換該代碼。公開客戶端唔會發送客戶端密鑰。
  5. 後端 → 用戶信息使用訪問令牌讀取已認證嘅身份,然後建立 JamZY 自己嘅安全 session。
網頁 · 生產端點 放大截圖 ↗
使用呢啲生產 ShareAI 地址同 console.shareai.now 嘅客戶端 ID。
使用呢啲生產 ShareAI 地址同 console.shareai.now 嘅客戶端 ID。
  1. 喺 auth.shareai.now/oauth/authorize 進行授權。
  2. 喺 auth.shareai.now/oauth/token 交換代碼同刷新令牌。
const verifier = randomBytes(32).toString('base64url');
const state = randomBytes(32).toString('base64url');
const challenge = createHash('sha256').update(verifier).digest('base64url');
const authorize = new URL('https://auth.shareai.now/oauth/authorize');
authorize.search = new URLSearchParams({
  client_id: clientId, response_type: 'code', redirect_uri: callback,
  scope: 'openid profile inference monetization_gateway', state,
  code_challenge: challenge, code_challenge_method: 'S256',
}).toString();
// Save state + verifier in the server session BEFORE redirecting.
// The downloadable server implements state expiry and one-time consumption.

根據已認證嘅、客戶端範圍嘅 sub 同其發行者/客戶端上下文鍵入本地客戶記錄。個人同組織授權可以揀唔同嘅支付帳戶。客戶 ID 唔係全球用戶 ID、電郵地址或者內部組織數據庫 ID。唔好通過匹配顯示名稱合併跨平台嘅身份。

當你準備好繼續嘅時候

取消、state 不匹配、代碼重放同授權過期會安全失敗。正常流程會返回一個已認證嘅帳戶而唔會暴露其令牌。

安全咁保持客戶連接

當令牌過期時,你會保持已授權請求正常運作,同時提供客戶可靠嘅方式去斷開連接。

你將會工作嘅地方 你嘅應用程序 → Session 同令牌處理

憑證目的點樣處理
授權代碼從授權頁面進行一次性交接。使用匹配嘅驗證碼同回調進行一次交換。佢唔係 API 令牌。
訪問令牌喺接受嘅授權同範圍內授權 API 調用。作為 Authorization: Bearer …發送。尊重過期時間同端點授權錯誤。
刷新令牌喺授權仍然有效期間,無需再次登錄即可獲取替換訪問令牌。安全存儲。序列化刷新操作並原子性替換旋轉憑證。
ID 令牌客戶端嘅 OpenID Connect 身份聲明。如果你使用佢,驗證簽名、發行者、受眾、過期時間同 nonce(如適用)。唔好將佢用作推斷嘅 Bearer 令牌。
客戶端密鑰驗證一個被允許嘅機密服務器客戶端。存喺服務器上。佢同所有令牌都唔同,並且永遠唔會喺公開客戶端中捆綁。
# Public client refresh; run on a trusted terminal with scoped test credentials.
curl --fail-with-body 'https://auth.shareai.now/oauth/token' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=refresh_token' \
  --data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
  --data-urlencode "refresh_token=$SHAREAI_REFRESH_TOKEN"

使用返回嘅 expires_in 而唔係發明一個有效期。如果刷新返回一個替換嘅刷新令牌,將其同新嘅訪問令牌作為一個更新持久化。每個 session 允許一次刷新進行,以便並發請求唔會重複使用旋轉嘅令牌。無效或者撤銷嘅刷新授權需要重新連接;唔好無限循環。

刷新唔可以添加範圍或者默認接受新嘅 Monetization Gateway 合約。需要再次通過授權流程獲取新嘅權限或者條款。JamZY只喺伺服器記憶體中存儲憑證,最多一小時嘅演示會話,認證用戶信息,而唔係信任未經驗證嘅ID令牌,並使用安全、HttpOnly、SameSite嘅cookie。生產服務需要自己耐用嘅受保護會話設計。

喺斷開連接時,撤銷刷新/訪問憑證(如果適用),並清除應用程序會話。單純清除瀏覽器cookie唔會撤銷ShareAI授權或者取消已付費訂閱。避免記錄代碼、token、秘密或者個人提示內容。

當你準備好繼續嘅時候

到期會觸發一次受控刷新;新token會取代舊token。斷開連接會清除應用程序會話,並報告任何撤銷失敗。

準備第一次AI約會

你會將一個預約目標轉化為一個議程同有用嘅問題,並且有一個明確嘅客戶資助 AI 請求。

你將會工作嘅地方 可用模型 → JamZY → 做好準備

喺應用程式中打開可用模型。揀選你嘅產品會提供嘅模型同供應商,並儲存配置。如果目錄無法加載,喺繼續之前解決上游可用性錯誤;反覆更改 OAuth 客戶端唔會修復呢個問題。

可用模型 放大截圖 ↗
選擇你嘅客戶可以使用嘅模型同供應商。喺繼續之前解決任何目錄錯誤。
選擇你嘅客戶可以使用嘅模型同供應商。喺繼續之前解決任何目錄錯誤。
  1. 模型目錄屬於呢個應用程式。

JamZY 只喺連接後加載佢嘅目錄。揀選一個允許嘅文字模型,輸入一個簡短嘅預約目標,然後有意識咁揀選生成準備。所選賬戶需要符合資格嘅信用額同任何所需嘅已接受 AI 計費條款。揀選日期、檢視預約同儲存佢唔會發送推理請求。

curl --fail-with-body 'https://api.shareai.now/api/v1/chat/completions' \
  -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"model":"YOUR_ENABLED_MODEL_SLUG","messages":[{"role":"user","content":"Create a short agenda and three questions for a 15-minute appointment about planning a booking app."}],"stream":false,"max_tokens":192}'

喺 JamZY 中跟隨預約流程。

  1. 喺日程中,揀選一個服務:15 分鐘簡介、30 分鐘項目規劃或者 60 分鐘深入對話。
  2. 揀選一日同一個可用時間。時間使用瀏覽器顯示嘅時區。可用性係示例性嘅,儲存嘅預約只影響呢個瀏覽器。
  3. 喺做好準備中,輸入一個無個人資料嘅示例目標。揀選一個模型,然後揀選生成準備。JamZY 將所選服務同你嘅目標發送到 ShareAI,安全地渲染返回嘅文字,並保持預約不變。
  4. 自行檢視議程。揀選檢視預約,檢查佢嘅服務、日期、時間同持續時間,然後確認演示預約。呢個操作唔會調用 AI 或進行付款。
  5. 打開我的預約以查看儲存嘅演示記錄。重新加載以確認佢持續存在,或者移除佢以再次釋放該時段。只有服務、日期、時間同一個隨機本地參考會被儲存;AI 草稿、目標、令牌同密鑰唔會同預約一齊儲存。
喺保存呢個僅限瀏覽器嘅演示預約之前查看服務、日期、時間同持續時間。 放大截圖 ↗
喺保存呢個僅限瀏覽器嘅演示預約之前查看服務、日期、時間同持續時間。
喺保存呢個僅限瀏覽器嘅演示預約之前查看服務、日期、時間同持續時間。
  1. 喺確認之前查看完整選擇。
  2. 呢個操作保存一個演示記錄;佢唔會調用 AI 或收取付款。
我嘅預約顯示本地演示記錄。移除記錄會令其示例時段再次可用。 放大截圖 ↗
我嘅預約顯示本地演示記錄。移除記錄會令其示例時段再次可用。
我嘅預約顯示本地演示記錄。移除記錄會令其示例時段再次可用。
  1. 記錄喺呢個瀏覽器持續存在,冇個人詳細信息或 AI 註釋。
  2. 移除演示預約並釋放其時段。

一個真正嘅排程產品需要一個伺服器端預約存儲、可用性檢查、時區處理、取消政策同日曆或通知集成。呢啲係同 ShareAI 授權分開嘅。保持 AI 輸出作為建議;通過你自己嘅應用程式規則驗證任何未來嘅預約操作。

使用由允許嘅目錄返回嘅模型 slug。處理實際嘅回應合約:JamZY 支援 ShareAI 嘅原生 message.content 封裝同 OpenAI-style choices[0].message.content。HTTP 200 帶有不完整或者嵌套錯誤回應唔係成功嘅回覆。

喺支出限額或者信用不足嘅回應情況下,顯示有用嘅解釋同提供嘅客戶結算連結。保留所選賬戶。唔好繞過其限額、靜默切換付款人或者喺循環中重試已收費操作。

當你準備好繼續嘅時候

生成準備會返回可用嘅議程同問題。請求係歸因於授權嘅客戶同應用程序,連同所選模型同接受嘅條款。AI 草稿唔可以預約或者更改預約。

設置你嘅可選AI收益

你會喺訂閱提案中解釋你額外嘅 AI 收費,並發布客戶可以接受嘅條款。

你將會工作嘅地方 應用程序 → 訂閱

如果未經適用嘅管理政策批准,通過應用程式嘅使用案例申請 Monetization Gateway 訪問。完成問卷並跟進其狀態。批准後可以進行配置;客戶許可及付款同意仍然係獨立嘅。

訂閱 · 概覽 放大截圖 ↗
新嘅應用程式開始時冇發佈合約。喺發佈條款之前添加一個提供。
新嘅應用程式開始時冇發佈合約。喺發佈條款之前添加一個提供。
  1. 喺自己嘅編輯器入面創建一個提供。
  1. 開放訂閱。添加一個優惠,畀佢一個清晰嘅名稱,並描述客戶需要支付嘅 Builder 加價。生成嘅訂閱ID係只讀嘅,並且範圍限於呢個應用程式;當你嘅集成需要時複製佢。
  2. 喺其專屬編輯器中編輯每個訂閱。使用估算檢查所選模型同使用假設嘅網絡成本同你嘅收益。估算係預覽,唔係保證價格或者接受條款。
  3. 一齊審查草稿,然後喺滿足其要求時發布合約版本。發布嘅版本描述新客戶可以接受嘅內容。
  4. 使用概覽同合約分發睇下有幾多賬戶仍然喺每個接受版本上。客戶會保留接受嘅條款,直到佢哋明確接受替代條款;發布新版本唔會靜默遷移佢哋。保持默認過渡,保留接受嘅合約。如果你有意選擇「需要重新同意先可以進一步應用程序操作」,現有訪問可能會被中斷,直到客戶批准新條款。

只係例子:一個 20% Builder 標記喺 €1.00 合資格嘅網絡成本上加咗 €0.20。喺標準定價下,ShareAI 嘅 5% 費用只適用於嗰個 €0.20 標記,喺任何可計費嘅事件攝取之前。使用實時估算器同已接受嘅合約嚟進行實際計算。呢個流程入面嘅訂閱優惠係一份 AI 計費協議;單單連接賬戶唔會扣除固定嘅經常性價格。

訂閱 · 提案編輯器 放大截圖 ↗
一個示例草稿提供。其生成嘅訂閱 ID 係只讀嘅,並且範圍限於呢個應用程式。
一個示例草稿提供。其生成嘅訂閱 ID 係只讀嘅,並且範圍限於呢個應用程式。
  1. 使用面向客戶嘅提供名稱。
  2. 為呢個提供設置 AI surcharge。

ShareAI 同意畫面係接受條款嘅權威依據。JamZY 嘅公開客戶端無法從用戶資訊推斷接受嘅收費計劃,所以佢嘅連接面板唔會聲稱有活動訂閱或者創造一個約會嘅價格。

當你準備好繼續嘅時候

呢個提供解釋咗費用;合同可以由客戶接受。你會明白邊啲客戶仲係用舊條款同埋原因。

證明包含嘅平台係有效嘅

你會收集提交應用程式審核所需嘅真實端點同埋範圍檢查。

你將會工作嘅地方 OAuth 設定 → 測試者同驗證

開啟 OAuth 設定 → 測試者,邀請最多五個應用程式範圍內嘅測試者。待處理邀請會佔用一個名額,但唔會授予訪問權限;接收者必須接受。擁有者訪問權限同邀請測試者訪問權限同公開生產訪問權限係唔同嘅。

應用程式測試者 放大截圖 ↗
一個測試者名單服務所有平台。待處理邀請計入五個名額限制。
一個測試者名單服務所有平台。待處理邀請計入五個名額限制。
  1. 五個名額由整個應用程序共享。
  2. 喺呢度邀請測試者,然後等佢哋接受。
網頁 · 驗證 放大截圖 ↗
新集成會顯示待檢查,直到記錄到真正成功嘅調用。呢份參考草稿未通過審查。
新集成會顯示待檢查,直到記錄到真正成功嘅調用。呢份參考草稿未通過審查。
  1. Console 記錄實際端點成功。
  2. 每個請求嘅範圍都必須被使用。

對於你打算發佈嘅每個平台,開啟驗證。完成所需端點同埋每個配置範圍嘅真實成功調用。檢查發現同簽名密鑰;測試授權/回調、代碼交換、刷新、已驗證嘅用戶資訊同撤銷。機密客戶端亦必須測試適用嘅內省。原生聲稱嘅 HTTPS 鏈接需要關聯驗證。

配置文件/電子郵件範圍需要其實際返回嘅聲明;使用需要電子郵件嘅個人測試帳戶。inference 同 monetization_gateway 範圍需要完成授權嘅AI請求。付款需要成功嘅範圍付款API調用。通用成功嘅HTTP響應、瀏覽器截圖或者手動檢查表唔可以代替Console記錄嘅檢查。

對於一個未完成嘅平台,你有三個選擇:完成並驗證佢,將佢排除喺發佈之外,咁佢會保持為擁有者/測試者專用,或者移除佢。唔好包括未執行回調或者範圍嘅平台。配置更改可能會使檢查失效,所以喺你最終更改之後刷新記錄嘅狀態。

當你準備好繼續嘅時候

每個包括嘅平台顯示所需嘅配置、端點同範圍檢查為完成。指南嘅個人清單只係一個閱讀輔助工具。

提交你嘅應用程式並跟進佢嘅客戶

你會知道乜嘢準備好接受審核,發佈點樣運作同埋之後喺邊度跟進客戶訪問。

你將會工作嘅地方 應用程式 → 儀表板

  1. 返回儀表板並解決每個未完成嘅操作。審核提交必須保持不可用,直到應用程式同所有包括嘅平台符合佢哋嘅要求為止。
  2. 提交應用程式俾ShareAI審核。喺Dashboard同Activity & Decisions追蹤決定同任何要求嘅更改。公開展示同Monetization Gateway嘅請求可以有獨立嘅決定。.
  3. 獲批之後,用可用嘅發佈控制發佈應用程式。確認包含嘅平台已經準備好進入生產環境;排除嘅平台會保持喺測試階段。
  4. 開啟 Customers 處理應用程式層級帳戶,同 Subscriptions 處理已接受合約嘅分發。Analytics 幫助你追蹤歸因嘅 AI 使用量同收益。客戶識別碼會喺適當嘅客戶/授權上下文中保持私密。
Dashboard · 發佈準備狀態 放大截圖 ↗
當應用程式同包含嘅平台有未完成嘅要求時,審查會保持阻止。
當應用程式同包含嘅平台有未完成嘅要求時,審查會保持阻止。
  1. 喺提交審查之前解決所需嘅操作。
應用程式視圖將連接嘅帳戶聚合喺一齊,但唔會顯示內部組織數據庫 ID。
應用程式視圖將連接嘅帳戶聚合喺一齊,但唔會顯示內部組織數據庫 ID。
  1. 客戶管理係為應用程式聚合嘅。

喺發佈後用合資格嘅客戶再試一次完整流程:連接、檢查帳戶同同意、生成一個簡短嘅約會準備草稿、安全刷新、處理一個付款失敗,然後斷開連接。驗證實時用戶體驗,而唔係假設成功保存就證明佢可行。

當某啲嘢唔正常運作

Callback 不匹配: 精確比較已註冊嘅 URL 同兩個請求值。 未授權嘅測試員: 確認邀請接受同已揀選嘅帳戶。 缺少範圍或者合約: 只請求已啟用嘅訪問,並重新連接以接受。 無模型: 檢查可用模型同供應商限制。 刷新失敗: 清除失敗嘅本地會話並重新連接。 審查被阻止: 檢查平台檢查,而唔係創建另一個 OAuth 客戶端。

當你準備好繼續嘅時候

呢個應用程式適用於目標客戶,記錄嘅檢查支持其發佈狀態,客戶可以控制或者撤銷授權。

組織驗證同計劃訪問

選擇個人或者組織帳戶嚟擁有項目註冊資格,喺申請之前。組織可以喺驗證之前提交申請,但僅僅員工批准唔會激活訪問權限。喺Console嘅入門清單完成組織電郵同公司驗證。一個已批准嘅組織會保持「待驗證」狀態,直到兩個檢查都完成。Builder、Provider同Creator項目遵循呢個規則。

查看 Monetization Gateway 價格 · 探索 ShareAI for Startups · 範圍同權限

權限同接受條款

你嘅公開《條款及細則》、《私隱政策》同刪除指引必須同應用程式一致,並且喺無需登入嘅情況下保持可訪問。ShareAI計劃接受、Monetization Gateway批准、客戶嘅OAuth權限同已接受嘅收費合同係獨立嘅決定。刷新唔可以新增權限或者接受新嘅商業條款。

舊版嘅 surcharge 範圍仍然被接受用於現有集成。新例子使用 monetization_gateway。保持現有嘅線路字段,例如 surcharge_bps 同 surcharge_percentage 唔變。

查看 Monetization Gateway 價格 · 探索 ShareAI for Startups · 範圍同權限

閘道費用同 Startup 支持

標準收費 5% 喺 Builder 加價。對於 €2.00 AI 網絡成本同 10% 加價,客戶支付 €2.20。ShareAI 收到 €0.01 喺 €0.20 加價;Builder 喺事件攝取之前有 €0.19。

每個曆月(UTC)嘅第一個 1,000 已結算嘅生產 Monetization Gateway 請求係免費嘅,呢啲請求係共享喺 Builder 帳戶內。額外請求每 1,000 收費 €0.04,適用折扣之前。一個已結算嘅請求會創建一個事件。

Pay with ShareAI 自身使用,inference-專用訪問,普通賬戶 API 鑰匙同 Staging 或測試流量唔會產生 Monetization Gateway 事件接收。

ShareAI for Startups 提供一個共享嘅每月津貼,用於已批准應用嘅實際 ShareAI 費用。目前嘅 Launch、Growth 同 Momentum 層列出每月嘅 €1,000、€5,000 同 €10,000。同一個預算涵蓋 ShareAI 嘅百分比費用,係 Builder 加價同可計費事件引入一齊計算。呢個唔係一個總加價津貼、單獨嘅免費事件配額或者免費嘅 AI inference。賬戶嘅首 1,000 個免費事件唔會消耗呢個津貼。

剩餘嘅事件引入費用會從請求嘅新 Builder 收益中支付,然後係可用嘅 Builder AI 收益同無限制嘅 AI 信用額度中扣除。客戶 AI 收費同產品 payments 會保持分開。

ShareAI 可以批准應用特定嘅費用或者費用支持,係固定時期內或者直到更改為止。請喺 Console 中檢視應用當前嘅定價同特別計劃,了解其批准條款、有效性同已消耗嘅津貼。層級更改或者定價覆蓋唔會重置應用每月嘅使用量。

Launch 保持 ShareAI 登錄為可選。Growth 同 Momentum 要求必須使用;Momentum 仲要求應用頁腳顯示官方嘅 ShareAI for Startups 標誌。ShareAI 每周檢查標誌。確認試圖繞過要求嘅行為可能導致降級、從 Startup Program 移除或者根據接受嘅計劃條款退出 Marketplace。

企業費率由 ShareAI 團隊為 Builder 帳戶配置,並喺達成個性化協議後生效。分配嘅百分比同事件費率適用於未來請求。

查看 Monetization Gateway 價格 · 探索 ShareAI for Startups · 範圍同權限

問下關於呢頁嘅問題

選擇一個助手嚟探索呢頁。你亦可以複製呢頁,然後貼喺你嘅對話入面。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI