当前可以直接用于你的应用接入,根路径展示品牌信息,API 请求继续走标准接口。
这一屏只保留真正会影响接入的关键信息,不再把首页做成一排难懂的接口地址。
给你一个直接的调用脑图,清楚看到请求进入网关后怎么走。
继续按照 OpenAI 标准接口发起请求,带上你的网关令牌。
统一做鉴权、限流、模型校验、并发控制和请求记录。
只选择已启用且风险等级不超过 critical 的上游。
返回标准结果;老客户端走 Chat Completions 时也会自动兼容转换。
这里直接读取 /health,把当前在线状态、模型数量和上游情况实时展示出来,方便你演示或排查。
加载中...
新项目优先走 Responses,旧项目可以直接继续用 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"}
]
}'
给同事或客户演示时,按这三步说最清楚,不需要临时再解释根路径和接口路径的区别。
你自己的客户端调用时,统一使用 Bearer token 访问网关。根路径首页不需要令牌,但模型和业务接口需要。
新项目走 /v1/responses,旧项目继续走 /v1/chat/completions。两种方式现在都已经打通。
调试时重点看 X-Gateway-Client、X-Gateway-Upstream 和 X-Request-ID,排查会快很多。
首页不只是展示地址,也把真正排查时会用到的几个判断点放出来。
/health 不需要令牌。
可以直接看服务是否在线、当前可路由模型数量。
适合做监控、探活和首页状态展示。
/v1/models 返回的是当前真正能路由的模型。
如果模型没出现在列表里,就不要直接拿去发请求。
是否参与路由,还会受到风险阈值影响。
这一部分是给第一次接触这个网关的人看的,少走一些无效排查。
因为根路径 / 现在是门户页,真正的接口还是标准 /v1/* 路径,不影响客户端调用。
因为它属于网关能力的一部分,不能对外裸露全部可用模型和路由信息。
先看 /health,再看 /v1/models 里有没有目标模型,最后检查请求头里的 Bearer token 是否正确。
只有在你现有客户端、脚本或旧项目已经依赖它时继续用。新接入优先使用 Responses。
如果别人反馈“网页能开,但接口不通”,就按这个顺序查,通常几分钟内就能定位到问题。
确认 /health 返回 status: ok,并且不是空模型列表。
检查请求头里是否带了正确的 Authorization: Bearer ...,尤其是脚本复制后有没有漏空格或多引号。
如果你传的是不在当前列表里的模型,网关会拒绝;不要假设上游支持就一定能用。
你要确认服务在线、模型能不能用、当前上游策略是什么,或者你要把接入命令直接发给同事时,就看这里。
你的客户端已经接好 Token 和请求体之后,业务流量继续走标准 /v1/* 路径,根路径只是门户页。