API 参考
OpenAI 兼容接口
用统一的 OpenAI 请求格式调用 FIM Gate 上的各家模型。
FIM Gate 为绝大多数模型提供 OpenAI 兼容的调用方式:请求和响应结构与 OpenAI API 一致,只需把 Base URL 换成 FIM Gate,就能用同一套代码调用 GPT、Claude、Gemini 等不同厂商的模型。
接入信息
| 项目 | 值 |
|---|---|
| Base URL | https://api.gate.fim.ai/v1 |
| 鉴权 | Authorization: Bearer $FIM_API_KEY |
| 请求格式 | JSON(Content-Type: application/json) |
最小示例
curl https://api.gate.fim.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $FIM_API_KEY" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "用一句话介绍一下你自己"}
]
}'切换模型只需改 model 字段,例如换成 claude-sonnet-4-5 或 gemini-2.5-pro,请求结构不变。
配合 OpenAI SDK 使用
任何支持自定义 base_url 的 OpenAI SDK 都可以直接接入:
from openai import OpenAI
client = OpenAI(
api_key="$FIM_API_KEY",
base_url="https://api.gate.fim.ai/v1",
)
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FIM_API_KEY,
baseURL: "https://api.gate.fim.ai/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);包含的端点
| 端点 | 方法 | 用途 | 文档 |
|---|---|---|---|
/v1/chat/completions | POST | 多轮对话、多模态输入、工具调用、流式输出 | Chat Completions |
/v1/responses | POST | OpenAI 新一代统一接口,支持内置工具与推理参数 | Responses |
图像与音频端点同样已开通:
/v1/images/generations— 文生图,支持dall-e-2、dall-e-3、gpt-image-1、gemini-2.5-flash-image、gemini-3-pro-image-preview、gemini-3.1-flash-image-preview,见 图像接口/v1/audio/speech— 文字转语音,支持tts-1、tts-1-hd、gpt-4o-mini-tts、gemini-2.5-flash-preview-tts、gemini-2.5-pro-preview-tts,见 音频接口/v1/audio/transcriptions— 语音转文字,支持whisper-1,见 音频接口
如何选择 Chat Completions 与 Responses
- 已有基于 Chat Completions 的代码、或使用的第三方框架只支持该格式:继续用
/v1/chat/completions。 - 需要 OpenAI 内置工具(如网页搜索)、推理强度控制等新能力:用
/v1/responses。
两者共用同一个 Key 和额度,可以混用。