模型生成参数与别名
用 modelConfigs.customAliases 定义可继承配置,明确 SDK 参数与实际模型的关系。
高级模型配置位于 settings.json 的 modelConfigs 中。它将请求使用的名称与实际 API 模型及生成参数分开,适合固定实验条件或复用某组参数。
配置值几乎直接传给模型提供方,本地验证有限。参数能写入 JSON 不代表所选模型支持该组合;不兼容通常表现为 API 运行错误。
自定义别名
customAliases 是用户定义的预设映射。每个别名通过 modelConfig 提供实际配置,通过 extends 继承其他别名,包括系统预设。
{
"modelConfigs": {
"customAliases": {
"precise-mode": {
"extends": "chat-base",
"modelConfig": {
"generateContentConfig": {
"temperature": 0.0,
"topP": 1.0
}
}
}
}
}
}这沿用官方示例,覆盖生成参数,保留父配置的其他内容。降低 temperature 可以减少采样随机性,但不要把它当作回答必然正确或每次完全相同的保证。
继承与实际模型
别名可以不指定具体 model,作为其他配置的基类。准备实际调用的配置时,要确认继承结果包含适用的模型和参数;不要将仅用于继承的抽象别名误当成提供方模型 ID。
解析会先合并系统 aliases 和用户 customAliases,再递归展开 extends:先父后子,子级值覆盖父级。如果请求字符串找不到别名,系统将其当作原始模型名称。
常用配置字段
| 字段 | 作用 |
|---|---|
modelConfig.model | 实际调用的模型标识 |
modelConfig.generateContentConfig | 传入 @google/genai SDK 的生成配置 |
temperature | 采样随机性 |
topP | Nucleus sampling 概率参数 |
maxOutputTokens | 生成响应长度上限 |
thinkingConfig | 支持推理模型的配置,例如 thinkingBudget、includeThoughts |
后三类生成参数都放在 generateContentConfig 内。各模型支持的思考参数、值域和兼容组合不同,以所用模型官方定义为准;本页不提供跨模型通用的预算默认值。
控制改动范围
直接覆盖 chat-base 等系统基类会影响继承它的配置。先用自定义名称组织实验,再核对最终请求;需要只针对一个模型或代理时,用条件覆盖。