FIM Gate: 所有 AI 模型，一个 API

FIM Gate 提供 OpenAI 兼容的 Images 接口，包含三个端点：

端点	方法	用途
`/v1/images/generations`	POST	文生图
`/v1/images/edits`	POST	基于原图与蒙版的局部编辑
`/v1/images/variations`	POST	生成原图的变体

基础信息

项目	值
Base URL	`https://api.gate.fim.ai/v1`
鉴权方式	请求头 `Authorization: Bearer $FIM_API_KEY`

生成图像（generations）

POST /v1/images/generations，请求体为 JSON。

请求参数

参数	类型	必填	说明
`model`	string	是	模型 ID，如 `dall-e-3`
`prompt`	string	是	图像描述文本
`n`	integer	否	生成张数，默认 1
`size`	string	否	尺寸，如 `1024x1024`
`quality`	string	否	质量档位（视模型而定）
`response_format`	string	否	`url` 或 `b64_json`

当前可用的图像模型：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。完整列表见 gate.fim.ai/pricing。

请求示例

curl https://api.gate.fim.ai/v1/images/generations \
  -H "Authorization: Bearer $FIM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "雪后的江南园林，水墨画风格",
    "n": 1,
    "size": "1024x1024"
  }'

响应示例

{
  "created": 1718000000,
  "data": [
    { "url": "https://example.com/generated/xxxx.png" }
  ]
}

编辑图像（edits）

POST /v1/images/edits，请求体为 multipart/form-data。

参数	类型	必填	说明
`image`	file	是	原始图片
`mask`	file	否	蒙版图片，透明区域为可编辑区域
`prompt`	string	是	期望的编辑结果描述
`n`	integer	否	生成张数
`size`	string	否	输出尺寸

curl https://api.gate.fim.ai/v1/images/edits \
  -H "Authorization: Bearer $FIM_API_KEY" \
  -F image=@./room.png \
  -F mask=@./room-mask.png \
  -F prompt="把窗外的天空换成晚霞" \
  -F n=1 \
  -F size=1024x1024

图像变体（variations）

POST /v1/images/variations，请求体为 multipart/form-data，无需 prompt。

参数	类型	必填	说明
`image`	file	是	原始图片
`n`	integer	否	生成张数
`size`	string	否	输出尺寸

curl https://api.gate.fim.ai/v1/images/variations \
  -H "Authorization: Bearer $FIM_API_KEY" \
  -F image=@./logo.png \
  -F n=2

提示

edits 与 variations 的具体可用字段随模型不同会有差异，调用前先确认目标模型支持的能力。
返回的图片 URL 通常有有效期，建议生成后及时下载转存。

图像接口（Images）