跳至主要内容
FASTGPT / 技术中心

从部署到 API，
直接找到可执行答案。

面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。

4316 篇内容11 个主题官方文档与公开 Issue
推荐入口
API官方文档3 分钟阅读

FastGPT对话接口API的调用方法与参数配置说明

可在应用详情的路径中获取AppId。鉴权使用APIKey，支持两种方式：调用 chat/completions 时在请求体传入 body.appId ，或通过 Authorization: Bearer apiKey - a…

阅读 API 指南 查看官方文档

按任务找到答案

共 4316 篇

故障排查GitHub Issue

解决FastGPT登录页ChineseRedirectUrl序列化报错问题

解决FastGPT登录页ChineseRedirectUrl序列化报错问题 现象 访问FastGPT的/login页面时出现Server Error，完整报错文本为：Error: Error serializing .ChineseRedirectUrl returned from getServerSid…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT登录卡住及MongoDB连接超时、类型转换错误

解决FastGPT登录卡住及MongoDB连接超时、类型转换错误 现象 点击FastGPT登录按钮后页面卡住，登录按钮持续处于转圈状态，相关API请求处于pending状态，一段时间后请求失败。系统日志中会出现mongo connect error报错，同时包含MongooseError: Operatio…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中m3e向量模型调用异常问题

解决FastGPT私有部署中m3e向量模型调用异常问题 现象 用户在Ubuntu22.04系统中私有部署FastGPT V4.9.11版本，使用Docker部署m3e向量模型，FastGPT页面出现向量模型调用异常。进入FastGPT容器内部使用curl命令测试m3e服务连通性，结果显示正常。 可能原因 结…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中M3E模型接入OneAPI的令牌无效问题

解决FastGPT私有部署中M3E模型接入OneAPI的令牌无效问题 现象 用户在FastGPT私有部署v4.9.0版本中，通过docker部署M3E模型并接入OneAPI后，测试该模型时始终提示无效令牌，语言模型的接入和使用可正常工作。 可能原因 结合该场景，可能的原因包括OneAPI平台内M3E模型的接…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT调用第三方m3e模型令牌无权报错问题

解决FastGPT调用第三方m3e模型令牌无权报错问题 现象 FastGPT私有部署版本v4.8.21，通过OneAPI对接独立部署的m3e模型。在FastGPT的索引模型设置中，配置模型ID为m3e、模型提供商为其他、别名设为m3e。点击测试按钮后，FastGPT返回报错：该令牌无权使用模型：m3e (r…

2 分钟阅读
故障排查GitHub Issue

解决Mac ARM64环境下FastGPT依赖isolated-vm编译失败的问题

解决Mac ARM64环境下FastGPT依赖isolated-vm编译失败的问题 现象 用户在部署或安装FastGPT时，依赖包isolated-vm@4.7.2的安装脚本执行失败。完整报错日志显示：首先prebuild-install提示找不到对应预编译二进制文件，内容为prebuild-install…

3 分钟阅读
故障排查GitHub Issue

解决Mac Mini M4部署FastGPT时PostgreSQL容器反复启动报错问题

解决Mac Mini M4部署FastGPT时PostgreSQL容器反复启动报错问题 现象 用户在MAC Mini M4设备上私有部署FastGPT时，PostgreSQL容器反复启动失败。启动日志包含以下报错信息： 可能原因 从报错信息推断，问题源于PostgreSQL初始化过程中的文件操作不被主机支持…

4 分钟阅读
故障排查GitHub Issue

解决MacOS环境下FastGPT Docker部署的数据库报错问题

解决MacOS环境下FastGPT Docker部署的数据库报错问题 现象 在MacMini M2 MacOS13.5.2环境中，使用官方Docker Compose文件部署FastGPT且未配置代理时，启动后出现两类问题：PostgreSQL容器反复报错chown: changing ownership…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT插件Markdown转换的属性解构报错问题

解决FastGPT插件Markdown转换的属性解构报错问题 现象 使用FastGPT的Markdown转换插件时，返回报错{ "error": "Cannot destructure property 'name' of '(e || n)' as it is undefined." }，操作过程附带了相…

2 分钟阅读
故障排查GitHub Issue

FastGPT中Markdown解析的HTML标签无法正常渲染的排错方法

FastGPT中Markdown解析的HTML标签无法正常渲染的排错方法 现象 在FastGPT v4.7.1私有部署版本的对话框中，用户尝试插入自定义HTML代码以嵌入外部网页，具体使用的iframe代码为<iframe height=850 width=90% src="http://mctool.wa…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传含可执行代码的MD文档导入失败的问题

解决FastGPT上传含可执行代码的MD文档导入失败的问题 现象 在FastGPT私有部署版本中，上传Markdown文档进行分段处理时，平台会执行文档内的JS代码，导致导入失败。具体存在两种测试场景：一是上传包含var name = "<img src=x onerror=alert(1)"; el.in…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.9.0版本Marker解析后图片异常与标签残留问题

解决FastGPT 4.9.0版本Marker解析后图片异常与标签残留问题 现象 部署FastGPT 4.9.0私有部署版本并配置Marker服务后，使用知识库增强解析功能时出现两个问题：一是图片无法正常展示，解析出的图片地址与正常格式不符；二是解析后的文档残留span标签。正常图片地址以/api/syst…

2 分钟阅读