AI 解释 JSON
AI 解释 JSON 工具，粘贴一份复杂的接口报文或配置文件，由大模型生成结构清晰、带字段说明的 Markdown 文档。支持配置自定义 API Key（BYOK），所有请求直接从浏览器发送给模型提供商，不经过本站服务器，适合快速阅读第三方接口文档，或为自己的接口写文档。
在工作台中打开 本地处理 · 数据不上传
怎么使用
- 1
配置 API Key
点击「模型设置」，填入你的 OpenAI 或兼容平台的 API Key。你的 Key 只保存在浏览器本地，不会上传。
- 2
粘贴 JSON
将你需要解释的 JSON 文本粘贴到左侧的输入框中。工具会先验证其合法性。
- 3
开始生成文档
点击「开始生成文档」，AI 会自动分析 JSON 结构并在右侧生成 Markdown 格式的文档说明。
- 4
预览与复制
右侧提供实时 Markdown 渲染预览，可以复制 Markdown 源码用于内部 Wiki 或项目文档。
功能特点
自动生成文档
分析 JSON 的嵌套结构与字段类型，用 Markdown 表格等形式展现。
BYOK (自带密钥)
你只需提供自己的 API Key，模型请求直接从浏览器发起，敏感数据不经过本站。
所见即所得预览
内置 Markdown 渲染器，直接在页面上查看生成的排版效果。
与工作台打通
可以从格式化等其他页面跳转过来，使用体验保持一致。
常见错误与排查
- ! 如果 JSON 非常庞大，生成的文档可能会很长。建议提取代表性的部分 JSON 进行解释，效果更好。
- ! 如果使用的是兼容 OpenAI 的其他大模型提供商，请在设置中选择“Custom (OpenAI 兼容)”并填写完整的接口地址（形如 https://.../v1/chat/completions）。
- ! AI 的解释基于推断，可能无法 100% 猜中业务含义，建议生成后进行人工 review 和微调。
常见问题
API Key 会被你们的服务器保存吗？
不会。BYOK（自带密钥）模式下，API Key 只保存在你浏览器的 LocalStorage 中，所有 AI 请求直接由浏览器向模型提供商（如 OpenAI）发起，本站没有后端。
生成的文档可以直接用在哪些地方？
生成的是标准的 Markdown 源码，你可以直接复制到 GitHub/GitLab README、飞书文档、Notion 或任何支持 Markdown 的知识库中。