TX
TokenX88 Gateway 手机可看 · 网关首页 · OpenAI 接入总览
Gateway Portal

TokenX88 Gateway

为你自己的应用提供官方 OpenAI 路由、鉴权与风险隔离。

已就绪
检测中

当前可以直接用于你的应用接入,根路径展示品牌信息,API 请求继续走标准接口。

https://api.tokenx88.cn 风险阈值 critical 客户端 1 默认 60 RPM / 并发 3
当前策略

高风险第三方上游默认隔离在评估区,只有符合阈值的已启用上游才会参与真实路由。

运行总览

这一屏只保留真正会影响接入的关键信息,不再把首页做成一排难懂的接口地址。

基础地址 https://api.tokenx88.cn
可路由模型 1 个
已启用上游 1 个
兼容接口 /v1/chat/completions
模型列表
gpt-5.4
参与路由的上游
tokenx24-review-only

请求流向

给你一个直接的调用脑图,清楚看到请求进入网关后怎么走。

1
你的应用

继续按照 OpenAI 标准接口发起请求,带上你的网关令牌。

2
TokenX88 Gateway

统一做鉴权、限流、模型校验、并发控制和请求记录。

3
路由策略

只选择已启用且风险等级不超过 critical 的上游。

4
上游返回

返回标准结果;老客户端走 Chat Completions 时也会自动兼容转换。

实时看板

这里直接读取 /health,把当前在线状态、模型数量和上游情况实时展示出来,方便你演示或排查。

当前状态
已就绪
页面加载后会自动更新为实时结果。
可路由模型
1
从健康检查数据实时读取。
已启用上游
1
只统计符合当前风险阈值的上游。
最近刷新
等待中
和服务器返回的 UTC 时间保持一致。
实时列表
健康检查中的模型 gpt-5.4
健康检查中的上游 tokenx24-review-only
风险阈值 critical

接口选择

新项目优先走 Responses,旧项目可以直接继续用 Chat Completions,不需要改业务层结构。

Responses API

标准接入入口,适合新项目和后续长期维护。

https://api.tokenx88.cn/v1/responses 推荐新接入
打开接口地址
Chat Completions 兼容入口

当前网关同时兼容 Responses API 和 Chat Completions。老客户端可以直接走 /v1/chat/completions,网关会在内部转换到 /v1/responses。

https://api.tokenx88.cn/v1/chat/completions 兼容旧客户端
打开兼容地址

示例命令

直接切换命令卡片,复制就能测试。先检查健康状态,再查模型,最后发业务请求。

命令面板

先确认服务在线
curl https://api.tokenx88.cn/health
带令牌查看当前可用模型
curl https://api.tokenx88.cn/v1/models \
  -H "Authorization: Bearer your-gateway-token"
推荐的新接入方式
curl https://api.tokenx88.cn/v1/responses \
  -H "Authorization: Bearer your-gateway-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Give me a three-step deployment checklist."
  }'
老客户端兼容方式
curl https://api.tokenx88.cn/v1/chat/completions \
  -H "Authorization: Bearer your-gateway-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "Hello"}
    ]
  }'

接入步骤

给同事或客户演示时,按这三步说最清楚,不需要临时再解释根路径和接口路径的区别。

1
准备网关令牌

你自己的客户端调用时,统一使用 Bearer token 访问网关。根路径首页不需要令牌,但模型和业务接口需要。

2
选一个接口入口

新项目走 /v1/responses,旧项目继续走 /v1/chat/completions。两种方式现在都已经打通。

3
观察返回头与结果

调试时重点看 X-Gateway-ClientX-Gateway-UpstreamX-Request-ID,排查会快很多。

返回说明

首页不只是展示地址,也把真正排查时会用到的几个判断点放出来。

健康检查
/health 不需要令牌。 可以直接看服务是否在线、当前可路由模型数量。 适合做监控、探活和首页状态展示。
模型与路由
/v1/models 返回的是当前真正能路由的模型。 如果模型没出现在列表里,就不要直接拿去发请求。 是否参与路由,还会受到风险阈值影响。
兼容行为
老客户端走 Chat Completions 也能返回标准结构。 新客户端建议直接走 Responses,后续维护更简单。 同一网关可以同时服务两类调用方。

常见问题

这一部分是给第一次接触这个网关的人看的,少走一些无效排查。

为什么打开域名看到的是网页,不是接口返回?

因为根路径 / 现在是门户页,真正的接口还是标准 /v1/* 路径,不影响客户端调用。

为什么模型列表需要令牌?

因为它属于网关能力的一部分,不能对外裸露全部可用模型和路由信息。

调用失败时先看什么?

先看 /health,再看 /v1/models 里有没有目标模型,最后检查请求头里的 Bearer token 是否正确。

什么时候该用 Chat Completions?

只有在你现有客户端、脚本或旧项目已经依赖它时继续用。新接入优先使用 Responses。

排查顺序

如果别人反馈“网页能开,但接口不通”,就按这个顺序查,通常几分钟内就能定位到问题。

1
先看健康检查

确认 /health 返回 status: ok,并且不是空模型列表。

2
再看授权

检查请求头里是否带了正确的 Authorization: Bearer ...,尤其是脚本复制后有没有漏空格或多引号。

3
最后看目标模型

如果你传的是不在当前列表里的模型,网关会拒绝;不要假设上游支持就一定能用。

什么时候看这个首页

你要确认服务在线、模型能不能用、当前上游策略是什么,或者你要把接入命令直接发给同事时,就看这里。

什么时候直接走 API

你的客户端已经接好 Token 和请求体之后,业务流量继续走标准 /v1/* 路径,根路径只是门户页。