跳转到主要内容

​
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/generationsPOST文生图（JSON）—— 与 OpenAI 完全一致
/openai/v1/images/editsPOST图像编辑（multipart/form-data）—— 与 OpenAI 完全一致

​
支持的模型

模型说明
gpt-image-2OpenAI 最新图像模型（默认）

​
使用官方 openai SDK

​
安装

pip install 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,
)

# gpt-image-2 总是返回 b64_json
image_b64 = response.data[0].b64_json
with open("output.png", "wb") as f:
    f.write(base64.b64decode(image_b64))

​
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 imageB64 = response.data[0].b64_json!;
fs.writeFileSync('output.png', Buffer.from(imageB64, 'base64'));

​
直接调用 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)

字段类型说明
promptstring（必填）生成提示词
modelstring默认 gpt-image-2
sizeenumauto、1024x1024、1024x1536、1536x1024
nnumber目前仅支持 1
qualityenumauto、low、medium、high、standard
backgroundenumtransparent、opaque、auto
output_formatenumpng、jpeg、webp
output_compressionnumberJPEG/WebP 压缩等级 0-100
moderationenumauto、low
response_formatenumurl 或 b64_json（gpt-image-2 总是返回 b64_json）
userstring终端用户标识，用于滥用监控

​
images/edits (multipart/form-data)

上述字段再加上：
字段类型说明
imagefile（必填）源图像
maskfile可选 mask，透明区域将被重绘
input_fidelityhigh / low输出与输入图的相似度

​
响应格式

与 OpenAI 官方响应完全一致： 
{
  "created": 1712345678,
  "data": [
    {
      "b64_json": "<base64 编码的图像>",
      "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
  }
}
gpt-image-2 总是以 b64_json 返回图像。response_format=url 字段只是为了兼容 DALL·E，对 gpt-image 系列会被忽略。

​
注意事项与限制

目前 n 仅支持 1，暂不支持单次请求生成多张图像。
  • 兼容所有 OpenAI 官方参数；未知参数会被优雅忽略。
  • 接受 response_format=url，但 gpt-image-2 仍会返回 b64_json。
  • openai SDK 调用与直接 REST 调用行为完全一致。

​
浏览 API 文档