合富宝开放平台应用接入教程

结论先行：合富宝开放平台让第三方 App / 软件 / 网站通过 OAuth 一键接入平台 AI 能力——终端用户自付模型费用，接入方零 AI 成本、零计费开发。 这一「用户付费」模式已被 OpenRouter（OAuth PKCE）与 OpenAI（Sign in with ChatGPT，2026-09 正式开放）双重验证，国内尚无直接竞品。对独立开发者与 AI 应用团队来说，这意味着不用再为「每个用户的 token 账单」买单，也不用写一行计费代码。开放平台专题页见 hefu.hk/developers。

一、开放平台解决什么问题：三种模式的账单对比

给应用加 AI 能力，历来有三种做法，账单归属完全不同：

模式	谁付模型费	接入方的负担	适合场景
开放平台（OAuth 用户付费）	终端用户	零 AI 成本、零计费开发	面向外部用户的 App / 工具 / 桌面软件
BYOK（用户自带 Key）	终端用户	需引导用户去别家注册、处理 Key 配置体验	已有高粘性用户群的产品
开发者预付（API Key）	接入方	预充值 + 承担全部用量成本 + 防滥用	自用型集成、内部工具

开放平台的差异化在于：用户授权时即明确扣费口径，模型费用走用户自己的合富宝余额；你既不用预充值，也不用处理任何一方的发票与对账。对用户而言，用的是一个聚合了 OpenAI GPT 系列、Claude 系列、DeepSeek、Kimi、Gemini 与国产大模型矩阵的账户（具体型号以模型目录实时清单为准），无需在你的应用里逐家配置。

二、三步接入：从创建应用到用户授权

第 1 步：注册开发者账号并创建应用

进入合富宝主站注册账号，在控制台创建应用，获得应用凭证。开放平台专题页（hefu.hk/developers）提供三档模型池与接入对比表，可按目标用户群选择。

第 2 步：集成 OAuth 授权

在你的应用中发起 OAuth 授权跳转，用户在合富宝授权页确认后回跳你的应用。授权页会明示扣费口径——用户清楚知道授权后模型费用将从自己余额扣除。网页应用走标准重定向流程；桌面客户端支持 loopback 回环回调，本地安装版同样能完成授权。

第 3 步：用 OpenAI 兼容接口调用

授权完成后，用拿到的用户令牌调用 OpenAI 兼容接口即可，Base URL 为 https://api.hefu.hk/v1，请求格式与 OpenAI SDK 一致——已有的 OpenAI 集成通常只需改 baseURL 与令牌。模型计费从授权用户的余额按官方挂牌价零加价扣除，你在中途不经手任何费用。

三、上线后：用量透明与用户控制权

• 按应用用量明细：用户可在自己的控制台查看每个应用分别消耗了多少额度，账单一目了然。
• 一键撤销授权：用户随时可撤销某个应用的授权，撤开后应用即无法继续调用——控制权在用户手里，这也是信任的来源。
• 全链路内容审核：接入通道覆盖平台的内容审核体系，应用的调用行为有边界。

四、不用写代码的路：场景办公工具

如果你的目标不是「让用户在你的 App 里用 AI」，而是自己直接干活，合富宝的场景办公工具打开网页即用（无需选模型、无需写提示词）：

场景工具	直链	适用典型场景
营销内容工坊 Marketing Studio	https://www.hefu.hk/tools/studio	社媒文案、广告创意、SEO 内容批量生成
跨境卖家助手 Seller Assistant	https://www.hefu.hk/tools/listing	Amazon Listing 撰写、关键词优化、竞品分析
HR 招聘助手 HR Assistant	https://www.hefu.hk/tools/hr	职位描述生成、简历筛选、面试问题建议
开发者工具箱 Dev Toolkit	https://www.hefu.hk/tools/devkit	代码生成、单元测试、SQL 优化、接口调试
视觉创意工坊 Creative Studio	https://www.hefu.hk/tools/creator	文生图、图片风格化、品牌视觉素材制作
客服 Widget Support Widget	https://www.hefu.hk/tools/widget	网页内嵌智能客服、工单自动回复

常见问题

开放平台模式下，谁为模型调用付费？

你的用户付费。用户通过 OAuth 授权把自己的合富宝账户接入你的应用，模型调用费用从用户自己的余额按用量扣除，接入方无需垫付任何 AI 成本，也无需开发计费系统。授权页会向用户明示扣费口径，用户可在控制台查看按应用的用量明细并随时一键撤销授权。

开放平台与直接用 API Key 有什么区别？

API Key 模式下你用自己的账户计费，适合自用型集成；开放平台（OAuth）模式下每个终端用户授权自己的账户付费，适合面向外部用户的 App、工具与桌面软件——你不用预充值、不用关心用户的用量账单。两者都走 OpenAI 兼容接口，可并存使用。

桌面客户端（非网页应用）能接入吗？

可以。开放平台支持 loopback 回环回调，本地安装的桌面应用同样能完成 OAuth 授权流程。

接入后用户可以在哪些模型之间选择？

覆盖 OpenAI GPT 系列、Claude 系列、DeepSeek、Kimi、Google Gemini 与国产大模型矩阵（通义/智谱/豆包/Grok/MiniMax 等），具体型号清单以模型目录页（https://www.hefu.hk/models）实时展示为准。

用户会担心授权安全吗？

授权页明示扣费口径；用户可在控制台随时查看按应用用量明细并一键撤销；平台对接入通道做全链路内容审核。把「用户数据与账单控制权」交给用户，正是这一模式与暗箱转售的根本区别。