快速开始
按下面四步即可完成一套客户站的接入。每一步的状态都可以在账户中心和授权查询页核对。
01注册账户创建服务账户并登录。
02购买权益购买授权和模型网关额度。
03登记域名登记安装实例并完成域名绑定。
04接入调用使用站点 Key 调用固定 API。
架构边界
授权站是客户和运营人员的服务入口；统一模型网关是内网数据面，负责模型路由、健康检查、计费和任务状态。客户站只接触固定接口，不直接连接上游供应商。
生产环境请把网关放在授权站共享内网，配置
LICENSE_PORTAL_URL。不要把网关管理端口映射到公网，也不要把上游 API Key 写入前端代码。客户站保存什么站点标识、授权公钥和中央服务令牌。令牌应放在服务端环境变量中。
中央服务保存什么供应商密钥、模型路由、价格策略、资源账本和操作审计。
域名授权流程
- 在账户中心登记安装实例，填写实际访问域名。
- 购买对应源码授权套餐后，将许可证绑定到该实例。
- 客户站安装发行方公钥，在启动和关键操作时验证签名与域名。
- 续期、撤销或更换域名由授权服务完成，历史订单和审计记录保留。
公开查询只返回版本、有效期和功能摘要，不会展示账户、签名私钥或源码下载地址。可使用域名授权查询核对结果。
固定 API
所有请求使用站点令牌，并建议为每次写入请求提供唯一的幂等键。
POST /v1/gateway/jobs
Authorization: Bearer wxg_xxx
Idempotency-Key: job-20260826-001
Content-Type: application/json
{"modelId":"gpt-image-2","job":{"prompt":"a red kite"}}
Authorization: Bearer wxg_xxx
Idempotency-Key: job-20260826-001
Content-Type: application/json
{"modelId":"gpt-image-2","job":{"prompt":"a red kite"}}
模型目录
GET /v1/models
Authorization: Bearer wxg_xxx
Authorization: Bearer wxg_xxx
具体模型 ID、能力和价格以账户中心实时目录为准；停用或维护中的模型不会继续接受新任务。
线上版本与源码交付
版本中心分别展示当前线上功能版本和已经发布的源码交付版本。线上功能更新不会自动开放同版本源码下载；完整源码按有效授权及已发布交付记录提供。尚未发布的源码包不提供下载。
查看运行与交付版本运营接入清单
- 在授权后台录入上游渠道并执行连通检测、余额查询。
- 导入模型目录，配置名称、图标、排序、候选渠道和启停状态。
- 为每个安装实例创建站点 Key，配置配额、倍率和单模型售价。
- 在客户站配置
WANXIANG_GATEWAY_URL与WANXIANG_GATEWAY_TOKEN，然后执行健康检查。
常见排查
返回 401检查站点令牌是否放在服务端请求头，确认令牌没有过期或被撤销。
返回 403检查域名授权、网关权益和实例状态，必要时在授权查询页核对有效期。
任务长时间处理中先查看服务状态和网关任务日志，不要重复提交相同任务；重试应沿用原幂等键。
模型不可用查看模型目录和渠道健康状态，维护中的渠道会由网关自动切换或返回明确错误。