FastGPT 模型配置字段对照表（v4.17.2）

本页把 FastGPT v4.17.2 官方「模型配置说明」里语言模型、索引模型、重排模型、语音合成模型、语音识别模型五类字段示例（合计 50 个字段），逐个对照同一版本源码 packages/global/core/ai/model/schema.ts 中的定义。

先看结论

类型	文档示例字段	源码在顶层	源码在 `config` 内	schema.ts 未定义	源码有、示例未列出
语言模型	19	5	11	3	15
索引模型	8	5	2	1	16
重排模型	8	7	0	1	8
语音合成模型	8	6	1	1	7
语音识别模型	7	6	0	1	7

在新版源码里，公共字段（模型 ID、别名、提供商、是否启用、请求地址、价格等）放在顶层，各类模型不同的能力与默认参数放在 config 对象里；文档示例仍把这些字段平铺在 metadata 一层。配置文件导入时是否兼容平铺写法，文档与 schema.ts 都没有写明，需按部署环境实测。

字段	文档说明	源码位置
`isCustom`	是否为自定义模型	schema.ts 未定义
`isActive`	是否启用	顶层
`provider`	模型提供商，主要用于分类展示，目前已经内置提供商包括：（v4.17.2 中为 packages/global/core/ai/model/provider.ts）, 可 pr 提供新的提供商，或直接填写 Other	顶层
`model`	模型ID(对应OneAPI中渠道的模型名)	顶层
`name`	模型别名	顶层
`maxContext`	最大上下文	`config` 内
`maxResponse`	最大回复	`config` 内
`quoteMaxToken`	最大引用内容	`config` 内
`maxTemperature`	最大温度	`config` 内
`charsPointsPrice`	n积分/1k token（商业版）	顶层
`censor`	是否开启敏感校验（商业版）	`config` 内
`vision`	是否支持图片输入	`config` 内
`toolChoice`	是否支持工具选择（分类，内容提取，工具调用会用到。）	`config` 内
`functionCall`	是否支持函数调用（分类，内容提取，工具调用会用到。会优先使用 toolChoice，如果为false，则使用 functionCall，如果仍为 false，则使用提示词模式）	`config` 内
`customCQPrompt`	自定义文本分类提示词（不支持工具和函数调用的模型	schema.ts 未定义
`customExtractPrompt`	自定义内容提取提示词	schema.ts 未定义
`defaultSystemChatPrompt`	对话默认携带的系统提示词	`config` 内
`defaultConfig`	请求API时，挟带一些默认配置（比如 GLM4 的 top_p）	`config` 内
`fieldMap`	字段映射（o1 模型需要把 maxtokens 映射为 maxcompletion_tokens）	`config` 内

源码定义了、文档示例未列出的字段（15 个）：

源码定义了、文档示例未列出的字段（16 个）：

源码定义了、文档示例未列出的字段（8 个）：

源码定义了、文档示例未列出的字段（7 个）：

源码定义了、文档示例未列出的字段（7 个）：

「文档说明」一列照录官方文档示例里的行尾注释，未改写。
「源码位置」按 schema.ts 判断：顶层字段来自 PriceTypeSchema 与各类模型共用的基础定义，config 内字段来自各类模型自己的配置定义。
「schema.ts 未定义」只说明这个文件里没有这个字段，不代表系统其他地方不读取它。
「是否必填」按 schema.ts 中有无 optional、nullish 或默认值判断。

字段清单取自 FastGPT v4.17.2 官方模型配置说明与同版本 schema.ts。通过页面表单配置模型时，页面会按模型类型显示对应选项；私有化部署若做过二次开发，以实际部署为准。

同主题内容