跳转到主要内容

APIONE 当前接入方式

本系列教程采用 APIONE API Key。先在 密钥管理 创建密钥,再根据客户端所选协议配置认证。APIONE 文档目前可确认的接入能力不包含通用第三方 OAuth PKCE 授权服务,因此不提供未经确认的授权 URL、客户端 ID 或扩展安装命令。 按客户端要求使用一种认证头:Bearer、x-api-key 或 x-goog-api-key,避免重复发送互相冲突的密钥。

OAuth PKCE 的工作方式

支持 PKCE 的服务通常会让客户端生成一次性校验参数,在浏览器中展示登录与授权页面,再用授权码换取访问令牌。访问令牌到期后能否刷新,取决于服务端是否提供刷新令牌以及对应权限。 这个流程需要服务商和客户端共同支持。其他平台的 OAuth 扩展、授权域名、scope 和 Token 存储逻辑不能直接替换品牌名后用于 APIONE。

如果客户端只提供 OAuth 登录

检查它是否同时支持 Custom endpoint / API Key;支持时按对应教程配置。如果客户端只开放指定服务商的 OAuth 登录,不能把 APIONE 密钥填到该登录流程中,应选择支持自定义端点的客户端。 常用入口:OpenCode、Pi Coding Agent、Hermes Agent、OpenClaw。

将来启用 OAuth 前需要确认

应以 APIONE 官方公布的 issuer、授权与令牌端点、client_id、回调地址、scope、PKCE 方法和撤销机制为准。桌面回环回调还需确认浏览器与客户端的网络位置。 API Key 与 OAuth Token 都是凭据,不应写入提示词、公开仓库或截图。当前密钥可在 APIONE 控制台独立管理;撤销其他服务商的 OAuth 授权不会撤销 APIONE 密钥。
返回集成目录 · 模型选择 · 错误排查