OpenAI 兼容接口调试台
OPENAI COMPATIBLE PLAYGROUND在线调试填地址与 Key,直接发一次对话请求,看原始响应、HTTP 状态、错误码原文、流式增量与 token 用量;也可以拉取模型列表确认模型 ID 写没写错。
请求参数
地址填到 /v1 即可,页面会自动补 /chat/completions。
高级参数
返回内容
流式时这里会实时追加增量。
原始响应
SSE 原文或 JSON 原文,排查错误码就看这里。
怎么调试
- 填地址与 KeyAPI 地址填到 /v1 即可(页面会补全),Key 用临时 Key 更安全;模型 ID 可以直接填,或先点「拉取模型列表」。
- 写消息填 System 指令与用户消息,需要时在「高级参数」里改 temperature、max_tokens,或切到非流式。
- 发送请求点「发送请求」后:流式会在「返回内容」里逐字追加,右侧指标给出 HTTP 状态、首字延迟、总耗时与 token 用量。
- 看原始报文出错时看「原始响应」里的上游报错原文;点「复制等效 cURL」可以在自己机器上复现同一次请求。
接口调试常见问题
为什么需要经过本站代理,不能浏览器直连上游吗?
多数上游接口没有开放浏览器跨域(CORS),直连会被浏览器拦下,所以这一页做一次透明转发:按你填的地址发一次请求并把响应原样带回,不缓存、不改写内容。
我的 API Key 会被保存吗?
不会写日志、数据库与报告,Key 只在你这次请求产生的那条转发连接里出现。建议使用临时 Key;如果站点本身不可信,请先到可信度检测确认后再用主 Key。
返回 401 / 404 / 429 分别说明什么?
401:Key 无效、被吊销或没带上(少写 Bearer 前缀);404:Base URL 或模型 ID 写错,常见是把 /v1 漏了或地址多拼了一段路径;429:触发限流或额度用尽,多与并发、分组限速有关。原始响应里通常有更具体的原因。
流式输出里看不到内容?
先看「原始响应」:如果里面是 data: 开头的分片说明流是通的,可能是上游把内容放在 reasoning_content 或非标准字段里;如果返回的是普通 JSON,说明该上游忽略了 stream 参数。换成非流式再看一次可以确认。
为什么 usage 显示「上游未返回」?
部分中转站不会在响应里回传 usage 字段(尤其流式场景)。这不代表请求失败,只是无法从这里读到 token 用量;可以在上游后台的用量页核对。
能用它测 Claude / Gemini 官方接口吗?
本页发的是 OpenAI 的 /chat/completions 格式,因此适用于任何「OpenAI 兼容」接口,包括 Anthropic 与 Google 提供的兼容层地址。原生 /v1/messages 等私有格式不在本页范围内。
相关工具
请求经本站代理转发到你填的上游接口,只用于本次调试;Key 不写入日志、数据库与报告。