在线调试工具使用说明

在具体接口页点击 在线调试 →，即可打开调试弹窗。弹窗使用该页的请求方法、地址和参数示例；你可以修改地址和输入，再由浏览器发送请求。

1. 选择接口并填写令牌

打开需要测试的接口，例如 Chat 非流式补全，点击在线调试按钮。
检查请求地址。国内调用优先使用 https://api.apizt.com，保留接口路径，例如 https://api.apizt.com/v1/chat/completions。请求方法由接口页确定，显示在弹窗顶部。
在API Key / 系统访问令牌中输入自己的令牌本身。工具自动发送 Authorization: Bearer 令牌，不要再输入 Bearer 前缀。

令牌可在 apizt 控制台创建；先选包含目标型号的分组。创建分组令牌 · 当前价格与型号。

区域	填写方式
请求头	按接口页要求填写附加头；可添加、删除或取消勾选。Authorization 由令牌输入框生成。Claude 原生接口保留 anthropic-version；系统管理接口可能要求 new-api-user。
路径参数	地址中的 {id}、{task_id} 等占位符需要填入真实任务 ID。工具替换占位符并进行 URL 编码。
Query 参数	按名称和值添加并勾选有效参数。必填值为空会报错；选填空值不加入请求。使用本页要求的参数名，不把 Query 放入 JSON 请求体。
GET / HEAD	只发送地址、路径、Query 和请求头，不发送请求体。查询任务时先填写创建接口返回的任务 ID。

JSON 接口：在“请求 JSON”中修改 model、用户输入和必要参数。必须是合法 JSON，使用双引号，不带注释或末尾多余逗号；发送前工具会校验格式。不同协议的字段不能混用，见协议对照。

multipart 接口：在“表单文本字段”中填 model、prompt 等文本参数，在“上传文件”中选择本地文件。带“必填”的文件必须选择；image[] 等数组文件字段可多选。添加文件字段时，字段名须与接口文档一致。

上传文件时由浏览器生成 multipart 的 Content-Type 和 boundary，不要手工填写。可从音频转录或 GPT Image 2.5 图片编辑接口练习表单与文件选择。

点击发送请求。请求进行时会显示“请求中…”；收到响应后显示 HTTP 状态，结果区展示正文或错误体。检查状态和返回字段，确认结果属于当前请求。

返回处理	界面行为
JSON / 文本	自动格式化合法 JSON，其他文本按原文显示。非 2xx 的错误响应显示正文，便于排错。
SSE 流式	响应 Content-Type 为 text/event-stream 时，逐条显示 event 和 data；读取结束后显示“流式结束”。不会把多个事件当成一个 JSON 对象。
停止请求	请求中点击“停止请求”会中断浏览器请求并显示“已停止”。关闭弹窗、按 Esc 或点击弹窗外也会结束当前浏览器请求。
媒体文件	返回音频、图片、视频或附件字节时，显示文件名、大小和“下载文件”链接。默认文件名可能为 result.bin，请根据实际格式保存。
下载为文件	在“返回处理”中选此项，可原样保存非 SSE 的成功响应体；SSE 仍按流式事件展示。接口只返回 JSON 地址时，应继续按对应文档查询或下载媒体。

现象	先检查
请填写路径 / Query / 请选择文件	补齐界面标出的必填输入；这些检查发生在请求发出之前。
JSON 格式错误	检查双引号、括号与逗号；先恢复该接口页的最小请求，再逐项添加参数。
401 / 403	检查令牌、有效期、模型限制、分组权限；系统接口还需核对系统访问令牌及用户 ID。
404	核对完整路径与真实任务 ID，避免重复 /v1 或把 Chat 路径用于 Responses、Claude 原生、Gemini 原生。
400	读取错误体，核对型号和参数；例如 GPT-6.1 Sol 的 Chat 不带 tools，也不接受 reasoning_effort:none/minimal。
429	读取限速或额度提示，检查余额、令牌限额和并发限制后再重试。
5xx	保留时间、型号、HTTP 状态和已脱敏错误体，用于检查分组或上游状态。

当前工具直接在文档页弹窗中，由浏览器向请求地址发送 HTTP 请求。无需安装调试插件，也没有旧截图中的云端 Agent 或环境变量面板。

调试脚本不把 API Key 写入 localStorage、sessionStorage 或 Cookie。每次打开弹窗，令牌输入框为空；发送时会以 Authorization: Bearer 请求头传给请求地址对应的服务器。关闭后再次打开需重新输入。

在“API Key / 系统访问令牌”中只粘贴令牌本身，不带 Bearer、引号或空格。确认使用 apizt 令牌、令牌有效，且分组包含目标型号；系统管理接口另按页面要求填写系统访问令牌和 new-api-user。

先确认国内请求地址使用 https://api.apizt.com，并保留正确接口路径。检查浏览器网络面板中的请求地址、网络状态和跨域错误；若尚未拿到 HTTP 状态，可用“发出请求”中的 curl 在本机复现，区分浏览器跨域与网络连接问题。

“停止请求”中断当前浏览器发送或读取，关闭弹窗也会中断当前请求。服务端任务是否取消需查看对应 API 的任务状态；已经产生的用量以控制台记录为准。

自动处理会下载实际返回的媒体字节；如果接口返回 JSON 中的 URL 或 Base64，界面会显示 JSON，需要按该接口文档继续取文件。“下载为文件”原样保存非 SSE 的成功响应体，不会把 JSON 地址自动转换成媒体文件。