FIM Gate 文档
使用指南

对话接口

chat/completions 与 responses 两种接口的兼容范围,以及 Responses 系模型走 chat 接口时的扩展参数。

FIM Gate 同时提供 chat/completions 与 responses 两种 OpenAI 格式接口,本页说明二者的适用范围。

responses 接口

所有非 OpenAI 厂商的模型都可以通过 responses 接口调用。OpenAI 自家模型对 responses 的支持情况以 OpenAI 模型列表的官方说明为准。

chat 接口

部分 OpenAI 模型原生只提供 Responses API。为了让你不必改造现有的 chat/completions 集成,FIM Gate 为下列模型做了 chat 接口的转换兼容:

  • o3-pro / o3-pro-2025-06-10
  • o1-pro / o1-pro-2025-03-19
  • o3-deep-research / o3-deep-research-2025-06-26
  • o4-mini-deep-research / o4-mini-deep-research-2025-06-26
  • codex-mini-latest

对这些模型,你可以照常向 https://api.gate.fim.ai/v1/chat/completions 发请求,并使用下面几个扩展能力。

调用内置工具

在 tools 数组里声明工具类型即可启用模型的内置工具,例如联网搜索:

{
  "model": "o3-pro",
  "stream": true,
  "messages": [
    {"role": "user", "content": "帮我查一下最近的 Rust 版本发布说明"}
  ],
  "tools": [
    {"type": "web_search_preview"}
  ]
}

获取推理摘要

通过 reasoning.summary 请求推理摘要,结果会出现在响应消息的 reasoning_content 字段中:

{
  "model": "o3-pro",
  "stream": true,
  "messages": [
    {"role": "user", "content": "证明根号 2 是无理数"}
  ],
  "reasoning": {
    "summary": "detailed"
  }
}

设置推理强度

以下两种写法等效,任选其一:

写法一:reasoning.effort
{
  "model": "o3-pro",
  "stream": true,
  "messages": [
    {"role": "user", "content": "证明根号 2 是无理数"}
  ],
  "reasoning": {
    "effort": "high"
  }
}
写法二:reasoning_effort
{
  "model": "o3-pro",
  "stream": true,
  "messages": [
    {"role": "user", "content": "证明根号 2 是无理数"}
  ],
  "reasoning_effort": "high"
}