跳转到主要内容
POST
/
openai
/
images
创建图片任务（异步）
curl --request POST \
  --url https://api.mountsea.ai/openai/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "model": "gpt-image-2",
  "size": "1024x1024",
  "n": 1,
  "output_compression": 50,
  "response_format": "url",
  "image": "<string>",
  "mask": "<string>"
}
'
{
  "taskId": "<string>"
}

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
​
prompt
string
必填

提示词（prompt）

​
model
enum<string>
默认值:gpt-image-2

模型

可用选项:
gpt-image-2
​
size
默认值:1024x1024

尺寸 / 分辨率。可传 ImageResolution 枚举值，或自定义 WxH（如 1280x960）。自定义尺寸须满足以下约束：① 单边 ≤ 3840 px；② 宽、高均为 16 的倍数；③ 长边 : 短边 ≤ 3:1；④ 总像素 ∈ [655 360, 8 294 400]。不满足约束或渠道不支持自定义尺寸时请求将被拒绝。

可用选项:
auto,
1024x1024,
1536x1024,
1024x1536,
2048x2048,
2048x1152,
3840x2160,
2160x3840
​
n
number
默认值:1

生成数量（当前仅支持 1）

必填范围: 1 <= x <= 1
​
quality
enum<string>

质量等级

可用选项:
auto,
low,
medium,
high,
standard
​
background
enum<string>

背景透明度

可用选项:
transparent,
opaque,
auto
​
output_format
enum<string>

输出文件格式

可用选项:
png,
jpeg,
webp
​
output_compression
number

JPEG / WebP 的压缩等级 0-100

必填范围: 0 <= x <= 100
​
moderation
enum<string>

审核强度

可用选项:
auto,
low
​
response_format
enum<string>
默认值:url

响应格式：url 返回图片自家 S3 URL；b64_json 返回 base64。本服务对所有渠道（含 OpenAI gpt-image-* 这种上游强制返 b64 的模型）都会按本字段严格输出，不会两个字段都返回。不传时按 url 处理。

可用选项:
url,
b64_json
​
input_fidelity
enum<string>

输入图保真度（gpt-image-2 新增，仅 edit 场景生效；generate 可忽略）

可用选项:
high,
low
​
image

输入图片，仅接受 http(s):// URL（异步任务约束，不接 base64 / data URL）。提供则走图片编辑；不提供则走文生图。支持单张字符串或数组。如需传 base64，请改用同步接口 /openai/v1/images/generations 或 /openai/v1/images/edits。

​
mask
string<uri>

mask 图片（仅编辑场景，仅接受 http(s):// URL）；透明区域将被重绘。如需传 base64，请改用同步接口 /openai/v1/images/edits。

响应

200 - application/json

返回 taskId

​
taskId
string
必填

任务 ID，用于后续查询结果