故障排查GitHub Issue
解决FastGPT中API上传CSV模板无法按问答格式拆分的问题
解决FastGPT中API上传CSV模板无法按问答格式拆分的问题 现象 使用相同的CSV模板文件，通过后台UI上传可按指定的问答格式准确完成拆分。通过API上传同一文件时，即使调用时指定了问答拆分的格式参数，仍无法按要求完成拆分，拆分结果不符合预期。 可能原因 1. 官方开放的文件上传API仅适配UI上传的…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4316 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4316 篇
故障排查GitHub Issue
FastGPT聊天界面发送内容后出现接口异常的排查与解决
FastGPT聊天界面发送内容后出现接口异常的排查与解决 现象 部署FastGPT后，在聊天界面输入文字发送，无返回结果，卡顿后显示接口异常。 可能原因 首先排除OpenAI API密钥相关问题，其次可能与docker-compose.yml中的代理配置有关，或接口调用相关日志异常（需按实际环境确认）。 排…
故障排查GitHub Issue
解决FastGPT API调用文件上传时找不到指定文件的问题
解决FastGPT API调用文件上传时找不到指定文件的问题 现象 本地部署FastGPT+ds后，在FastGPT提供的页面中可正常实现docx文件分析。尝试通过API调用文件上传功能，按教程使用{"type": "fileurl", "name": "1.docx", "url": "http://12…
故障排查GitHub Issue
FastGPT API文件库对接外部知识库的排查与解决方案
FastGPT API文件库对接外部知识库的排查与解决方案 现象 使用FastGPT API文件库的场景中，存在对接外部知识库以获取其中文档的需求，无法明确支持的对接对象，且无法直接完成对接操作。该场景使用v4.8.21私有部署版本，且已确认所使用的密钥可正常工作。 可能原因 FastGPT API文件库仅…
故障排查GitHub Issue
解决FastGPT API文件库无法兼容S3协议存储的问题
解决FastGPT API文件库无法兼容S3协议存储的问题 现象 FastGPT的API文件库功能在使用时，无法直接适配S3协议的分布式存储系统，无法通过填写S3存储桶相关参数直接遍历存储桶内的所有对象，无法满足对应使用需求。 可能原因 官方未对S3协议存储进行封装，且S3协议本身存在不统一的情况，当前未内…
故障排查GitHub Issue
解决FastGPT外接API转发时未传递函数调用参数的问题
解决FastGPT外接API转发时未传递函数调用参数的问题 现象 使用FastGPT外接API接口转发请求时，转发的请求中未携带functions或tools参数，无法调用函数调用功能。该问题在对接ChatGLM等模型时均会出现，且已将模型配置中的toolChoice参数设置为true。 可能原因 Fast…
故障排查GitHub Issue
解决FastGPT中Api响应出现Image not found报错
解决FastGPT中Api响应出现Image not found报错 现象 FastGPT 4.8.19版本中，调用/api/v1/chat/completions接口时，出现报错日志：[Warn] 2025-01-27 16:53:41 Request finish /api/v1/chat/comple…
故障排查GitHub Issue
FastGPT API调用场景下图片上传功能异常排查与修复指南
FastGPT API调用场景下图片上传功能异常排查与修复指南 现象 通过OpenAPI调用FastGPT对话接口时，无法上传图片。FastGPT页面端已支持图片上传功能，但API调用场景下该能力未生效，无法满足扩展更多使用场景的需求。 可能原因 当前使用的FastGPT版本未包含API调用图片上传的修复补…
故障排查GitHub Issue
FastGPT 4.9.13 API 导入图片过期：4.9.14 升级建议与验证
FastGPT 4.9.13 API 导入图片过期：4.9.14 升级建议与验证 适用场景与历史记录 原报告来自 4.9.13 私有部署：API 导入文档的图片带一小时过期字段，而界面上传的同类图片表现不同。 原始讨论提交于 2025-06-27，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围…
故障排查GitHub Issue
FastGPT API知识库与直接调用接口的差异及定时同步配置方法
FastGPT API知识库与直接调用接口的差异及定时同步配置方法 现象 用户在使用FastGPT时，发现平台同时提供两种知识库接入方式。一种是直接调用FastGPT的知识库接口，将第三方文件系统的内容写入FastGPT知识库；另一种是API知识库方式。用户认为后者会额外增加第三方系统的开发接口工作量，且实…
故障排查GitHub Issue
解决FastGPT API调用中通过参数指定目标应用的需求
解决FastGPT API调用中通过参数指定目标应用的需求 现象 使用apikey区分应用时，model参数无效，无法通过通用apikey配合model参数（传入appId）调用不同FastGPT应用。 可能原因 当前FastGPT的API调用逻辑中，apikey与单个应用绑定，model参数仅用于指定调用…
故障排查GitHub Issue
解决FastGPT API调用返回结果包含换行符的问题
解决FastGPT API调用返回结果包含换行符的问题 现象 API调用返回的JSON结果中包含\n换行符，示例返回内容如下： 可能原因 需按实际环境确认，可能与API返回内容的格式处理逻辑相关。 排查步骤 1. 提取API调用的完整原始返回结果，确认\n换行符的具体存在位置与出现频率。 2. 核对发起AP…