使用指南
特殊用法
模型名后缀快捷参数、Gemini 联网搜索与代码执行等超出标准 OpenAI 格式的扩展用法。
一些模型能力没有对应的标准 OpenAI 参数。FIM Gate 通过模型名后缀和约定的工具名提供这些扩展，本页逐一说明。
模型名后缀切换推理强度
对 o1 / o1-mini / o3-mini 这类推理模型，可以直接在模型名后追加 #low、#medium 或 #high，等价于设置 reasoning_effort 参数，无需改动请求体结构：
curl https://api.gate.fim.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $FIM_API_KEY" \
-d '{
"model": "o3-mini#high",
"messages": [{"role": "user", "content": "设计一个 LRU 缓存的数据结构"}]
}'这种写法对只能填模型名、不能自定义参数的第三方客户端尤其有用。
Gemini 联网搜索
在 OpenAI 兼容接口中调用 Gemini 模型时，传入名为 googleSearch 的工具即可启用联网搜索：
curl https://api.gate.fim.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $FIM_API_KEY" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{"role": "user", "content": "今天的科技头条有哪些？"}],
"tools": [
{
"type": "function",
"function": {
"name": "googleSearch",
"parameters": {}
}
}
]
}'Gemini 代码执行
同样的方式，工具名换成 codeExecution，模型即可在沙箱中运行代码来回答问题：
curl https://api.gate.fim.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $FIM_API_KEY" \
-d '{
"model": "gemini-2.5-flash",
"messages": [{"role": "user", "content": "斐波那契数列第 50 项是多少？"}],
"tools": [
{
"type": "function",
"function": {
"name": "codeExecution",
"parameters": {}
}
}
]
}'googleSearch 和 codeExecution 是约定的保留工具名，parameters 留空对象即可；它们不会触发普通的函数调用流程，而是直接开启 Gemini 的对应内置能力。