OpenAI 兼容接口

OpenAI 兼容接口 是 OpenAI 官方 Images API 的 直接替代。完全兼容官方 openai SDK（Python 与 Node.js）和原生 OpenAI REST 接口 —— 只需修改 base_url。

无需修改代码 —— 如果您已使用 OpenAI 的 images.generate / images.edit，只需将 base_url 覆盖为 https://api.mountsea.ai/openai/v1，使用 Mountsea API Key 即可。

为什么使用兼容接口？

官方 SDK 支持

完美兼容 OpenAI 官方 openai Python 与 Node.js SDK

接口形状一致

请求/响应格式与 https://api.openai.com/v1/images/* 完全一致

同步返回

直接返回生成的图像，无需轮询

统一计费

一个 API Key，通过 Mountsea 统一跟踪用量

配置

Base URL

https://api.mountsea.ai/openai/v1

鉴权

使用您的 Mountsea API Key：

HTTP 头部：Authorization: Bearer your-api-key
或通过 SDK 的 api_key / apiKey 参数传入

支持的端点

端点	方法	描述
`/openai/v1/images/generations`	POST	文生图（JSON）。扩展：JSON 带 `image` 则同步改走编辑
`/openai/v1/images/edits`	POST	图像编辑（multipart/form-data）—— 与 OpenAI 完全一致
`/openai/v1/models`	GET	当前支持的 GPT Image 静态列表

支持的模型

模型	说明
`gpt-image-2`	默认。质量 `low` / `medium` / `high` / `auto`
`gpt-image-2.5-flare`	官方 2.5 — 额外 `xhigh` / `max`
`gpt-image-2.5-sunburst`	官方 2.5 — 额外 `xhigh` / `max`

使用官方 `openai` SDK

安装

pip install openai

npm install openai

pnpm add openai

Python

from openai import OpenAI
import base64

client = OpenAI(
    api_key="your-mountsea-api-key",
    base_url="https://api.mountsea.ai/openai/v1",
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="A photorealistic cat wearing a space helmet, floating in orbit",
    size="1024x1024",
    quality="high",
    n=1,
)

# 默认 response_format 为 url（自家 S3）
image_url = response.data[0].url
# 或传 response_format="b64_json" 后使用 response.data[0].b64_json

from openai import OpenAI
import base64

client = OpenAI(
    api_key="your-mountsea-api-key",
    base_url="https://api.mountsea.ai/openai/v1",
)

with open("source.png", "rb") as img:
    response = client.images.edit(
        model="gpt-image-2",
        image=img,
        prompt="Add a dramatic sunset sky with orange and purple clouds",
        size="1024x1024",
        input_fidelity="high",
    )

image_url = response.data[0].url

from openai import OpenAI
import base64

client = OpenAI(
    api_key="your-mountsea-api-key",
    base_url="https://api.mountsea.ai/openai/v1",
)

with open("source.png", "rb") as img, open("mask.png", "rb") as mask:
    response = client.images.edit(
        model="gpt-image-2",
        image=img,
        mask=mask,
        prompt="Replace the masked area with a sunset beach",
        size="1024x1024",
    )

image_url = response.data[0].url

Node.js / TypeScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'your-mountsea-api-key',
  baseURL: 'https://api.mountsea.ai/openai/v1',
});

const response = await client.images.generate({
  model: 'gpt-image-2',
  prompt: 'A photorealistic cat wearing a space helmet, floating in orbit',
  size: '1024x1024',
  quality: 'high',
  n: 1,
});

const imageUrl = response.data[0].url;

import OpenAI, { toFile } from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'your-mountsea-api-key',
  baseURL: 'https://api.mountsea.ai/openai/v1',
});

const response = await client.images.edit({
  model: 'gpt-image-2',
  image: await toFile(fs.createReadStream('source.png'), 'source.png'),
  prompt: 'Add a dramatic sunset sky with orange and purple clouds',
  size: '1024x1024',
  input_fidelity: 'high',
});

const imageUrl = response.data[0].url;

import OpenAI, { toFile } from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'your-mountsea-api-key',
  baseURL: 'https://api.mountsea.ai/openai/v1',
});

const response = await client.images.edit({
  model: 'gpt-image-2',
  image: await toFile(fs.createReadStream('source.png'), 'source.png'),
  mask: await toFile(fs.createReadStream('mask.png'), 'mask.png'),
  prompt: 'Replace the masked area with a sunset beach',
  size: '1024x1024',
});

const imageUrl = response.data[0].url;

直接调用 REST API

如果不使用 SDK，可直接调用 REST 接口。

文生图（JSON）

curl -X POST "https://api.mountsea.ai/openai/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A photorealistic cat wearing a space helmet, floating in orbit",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

图像编辑（multipart/form-data）

curl -X POST "https://api.mountsea.ai/openai/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F "model=gpt-image-2" \
  -F "image=@source.png" \
  -F "prompt=Add a dramatic sunset sky" \
  -F "size=1024x1024" \
  -F "input_fidelity=high"

局部重绘（multipart/form-data）

curl -X POST "https://api.mountsea.ai/openai/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F "model=gpt-image-2" \
  -F "image=@source.png" \
  -F "mask=@mask.png" \
  -F "prompt=Replace the masked area with a sunset beach" \
  -F "size=1024x1024"

请求参数

`images/generations` (JSON)

字段	类型	说明
`prompt`	string（必填）	生成提示词
`model`	string	默认 `gpt-image-2`；也可 `gpt-image-2.5-flare` / `gpt-image-2.5-sunburst`
`size`	string	预设或自定义 `WxH`（约束同异步）。默认 `1024x1024`
`n`	number	目前仅支持 1
`quality`	enum	`auto` / `low` / `medium` / `high` / `standard`；2.5 另有 `xhigh` / `max`
`background`	enum	`transparent`、`opaque`、`auto`
`output_format`	enum	`png`、`jpeg`、`webp`
`output_compression`	number	JPEG/WebP 压缩等级 0-100
`moderation`	enum	`auto`、`low`
`response_format`	enum	`url`（默认，自家 S3）或 `b64_json` — 只出其中一个字段
`user`	string	终端用户标识，用于滥用监控
`image`	string / string[]	私有扩展。 URL / data URL / base64 — 有则同步改走编辑
`mask`	string	私有扩展。仅与 `image` 同时生效

`images/edits` (multipart/form-data)

上述字段再加上：

字段	类型	说明
`image`	file（必填）	源图像
`mask`	file	可选 mask，透明区域将被重绘
`input_fidelity`	`high` / `low`	输出与输入图的相似度

响应格式

与 OpenAI 官方响应完全一致：

{
  "created": 1712345678,
  "data": [
    {
      "url": "https://cdn.example.com/out.png",
      "revised_prompt": "<模型改写后的 prompt>"
    }
  ],
  "background": "opaque",
  "output_format": "png",
  "quality": "high",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 45,
    "input_tokens_details": { "image_tokens": 0, "text_tokens": 45 },
    "output_tokens": 3200,
    "total_tokens": 3245
  }
}

本服务对所有渠道都严格按 response_format 输出（含上游强制返 b64 的 gpt-image）。默认 url（自家 S3）。不会同时返回 url 和 b64_json。

注意事项与限制

目前 n 仅支持 1，暂不支持单次请求生成多张图像。

兼容所有 OpenAI 官方参数；未知参数会被优雅忽略。
/images/generations 的 JSON image 是 Mountsea 扩展（官方 SDK 不会传）。
openai SDK 调用与直接 REST 调用行为完全一致。

浏览 API 文档

images.generate（兼容） —— 文生图（JSON 带图则改走编辑）
images.edit（兼容） —— multipart 编辑
models.list（兼容） —— 支持的模型列表

​OpenAI 兼容接口

​为什么使用兼容接口？

官方 SDK 支持

接口形状一致

同步返回

统一计费

​配置

​Base URL

​鉴权

​支持的端点

​支持的模型

​使用官方 openai SDK

​安装

​Python

​Node.js / TypeScript

​直接调用 REST API

​文生图（JSON）

​图像编辑（multipart/form-data）

​局部重绘（multipart/form-data）

​请求参数

​images/generations (JSON)

​images/edits (multipart/form-data)

​响应格式

​注意事项与限制

​浏览 API 文档

OpenAI 兼容接口

为什么使用兼容接口？

配置

Base URL

鉴权

支持的端点

支持的模型

使用官方 `openai` SDK

安装

Python

Node.js / TypeScript

直接调用 REST API

文生图（JSON）

图像编辑（multipart/form-data）

局部重绘（multipart/form-data）

请求参数

`images/generations` (JSON)

`images/edits` (multipart/form-data)

响应格式

注意事项与限制

浏览 API 文档