Base URL请求入口
决定请求发送到哪里,不要与网站首页地址混淆。
网关指南
看懂网关如何连接支持自定义接口的应用与模型服务。
多模型 API 网关位于支持自定义 API 的应用和模型服务之间。填写 Base URL、API Key 和模型名称后,应用即可通过该入口调用对应模型。
网关接入改变的是请求入口、密钥和用量管理方式。模型能力、上下文长度和工具支持,仍取决于实际调用的模型与接口兼容程度。
网关服务使用 API Key 鉴权,按模型名称路由请求并把响应返回应用。接入时主要确认下面三项。
Base URL决定请求发送到哪里,不要与网站首页地址混淆。
API Key用于识别账户和权限,不应放进公开页面、仓库或截图。
Model决定本次调用使用哪个模型,应以模型广场当前提供的名称为准。
模型官网直连使用厂商账户和官方接口;KHaiXAPI 提供统一的 API 地址。当前可用模型、分组和参考价格可在模型广场查看,API Key、用量记录与最终扣费则在控制台管理和核对。
模型与接口:可用能力取决于所选模型和接口支持情况;请求通过加密连接传输,密钥与数据按平台安全规则处理。
| 比较项 | 模型官网直连 | 多模型 API 网关 |
|---|---|---|
| 接口入口 | 使用模型厂商提供的官方地址 | 使用网关服务提供的统一地址 |
| 模型范围 | 通常以单一厂商模型为主 | 可能通过一个账户使用多个品牌 |
| 调用价格 | 按模型厂商官方公开价格结算 | 在模型广场查看参考价格,在控制台核对最终扣费 |
| 模型质量 | 使用厂商提供的完整模型 | 以所选模型和接口支持情况为准 |
| 密钥与用量 | 在对应厂商后台管理 | 在网关服务控制台统一查看 |
| 兼容性 | 以官方接口规范为准 | 取决于网关服务的协议兼容情况 |
能否接入取决于应用是否允许填写 API 地址、密钥和模型名称。只支持内置服务的应用通常无法使用外部网关接口。
适合需要切换模型、处理长文本或管理多套配置的用户。
包括命令行工具、编辑器插件和支持自定义接口的代码应用。
用于文档问答、内部知识检索、客服回复和内容整理。
用于工作流、表格处理、批量任务和业务系统中的模型调用。
除倍率外,还应检查接口兼容、用量记录、数据处理边界和客服支持。
模型调用通常根据输入和输出 Token 等实际用量计费。不同模型的单价、计费单位、倍率和可用状态可能不同,可先在模型广场查看当前模型与参考价格,再以控制台中的实际调用记录核对最终扣费。
初次使用时可以先发送少量测试请求,再到控制台核对模型名称、输入输出 Token、最终扣费和请求状态。为不同应用创建独立 API Key,也更容易区分用量和定位异常。
关于 Token、输入输出单价和倍率口径,可继续阅读计费指南。
使用网关服务时,请求内容需要经过网关接口才能发送给模型服务。正常请求正文不会写入 KHaiXAPI 的业务存储或业务备份。平台会在请求链路中即时处理正文,并保留调用与计费所需的记录;诊断、安全、你主动提交的客服材料和法律要求等特殊情形见隐私政策。
上述说明不意味着可以忽略输入内容的敏感性。无论使用官网直连还是网关服务,都应避免提交密码、私钥、访问令牌和不必要的个人敏感信息,并了解最终模型服务提供方的相关政策。
通过网关调用与官网直连使用相同的官方模型,模型质量完全相同。
可以。只要应用支持自定义 Base URL、API Key 和模型名称,按要求完成配置即可接入多模型 API 网关。
不会。只要使用的模型不变,更换 Base URL 不会改变应用功能,模型质量也不会改变。
请求会经过 KHaiXAPI,再发送到对应的模型服务。正常请求正文不会写入 KHaiXAPI 的业务存储或业务备份;请求链路中的即时处理、必要的调用与计费记录,以及异常诊断、安全、你主动提交的客服材料或法律要求等情形,按隐私政策处理。模型服务的数据处理规则以其政策为准。