跳转到主要内容

​
OpenAI 异步图像接口

统一端点，同时支持文生图和图像编辑。根据请求体中是否包含 image 字段自动判断操作类型。

​
支持的模型

模型说明
gpt-image-2OpenAI 最新图像模型

​
工作流程

1

创建任务

调用 POST /openai/images 并传入 prompt。接口会自动判断操作类型：
  • 不传 image → 文生图
  • 传 image → 图像编辑
  • 传 image + mask → 局部重绘（mask 透明区域被重绘）
返回 { "taskId": "..." }。
2

轮询结果

调用 GET /openai/tasks?taskId=<taskId>，直到 status 变为 completed 或 failed。
3

使用结果

任务 result 字段包含生成的图像（gpt-image-2 默认返回 base64 编码）。

​
快速示例

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

​
参数说明

字段类型必填说明
promptstring✅提示词（编辑时描述修改内容）
modelstring—默认 gpt-image-2
sizeenum—auto、1024x1024（默认）、1024x1536、1536x1024
nnumber—生成数量（目前仅支持 1）
qualityenum—auto、low、medium、high、standard
backgroundenum—transparent、opaque、auto
output_formatenum—png / jpeg / webp
output_compressionnumber—JPEG/WebP 压缩等级 0-100
moderationenum—auto、low
response_formatenum—url 或 b64_json（gpt-image-2 总是返回 b64_json）
input_fidelityenum—high 或 low，仅编辑场景生效，控制输出与输入图的相似度
imagestring / string[]—图像 URL 或 base64 data URL。传此字段触发编辑模式，支持单张或多张
maskstring—Mask 图（URL 或 base64），透明区域将被重绘，仅编辑场景

​
任务状态

状态含义
pending任务已创建，等待处理
ready准备分配
assigned已分配到 worker
processing正在生成
completed完成 —— result 包含图像
failed失败 —— 查看 errorMessage / errorCode
cancelled已取消
timeout处理超时
建议每 2-5 秒 轮询一次。任务通常在 10-60 秒内完成，具体取决于质量与尺寸。

​
可用端点

端点方法描述
/openai/imagesPOST创建图像任务（生成或编辑）
/openai/tasksGET通过 taskId 查询任务状态 / 结果

​
浏览 API 文档

需要同步 OpenAI 兼容接口？查看 OpenAI 兼容接口，可直接使用官方 openai SDK。