Skip to main content

OpenAI 异步图像接口

一个端点同时做文生图和编辑。是否传 image 决定走哪条路。

模型

工作流程

1

创建任务

POST /openai/images
  • 不传 image → 文生图
  • image → 编辑
  • image + mask → 局部重绘
返回 { "taskId": "..." }
2

轮询

GET /openai/tasks?taskId=<taskId>,直到 completedfailed
3

读结果

resultresponse_format:默认 url(自家 S3)。要 base64 设 b64_json。只返回其中一个字段。
imagemask 只能是 http(s):// URL。这里不接 base64 / data URL — 请用 兼容文生图兼容编辑

快速示例

参数说明

尺寸

预设:auto 1024x1024 1536x1024 1024x1536 2048x2048 2048x1152 3840x2160 2160x3840 自定义 WxH(如 1280x960)须同时满足:
  1. 单边 ≤ 3840 px
  2. 宽、高均为 16 的倍数
  3. 长边 : 短边 ≤ 3:1
  4. 总像素 ∈ [655360, 8294400]
不满足约束,或渠道不支持自定义尺寸,请求会被拒绝。

任务状态

终态结果含 elapsedMs
建议每 2–5 秒 轮询。通常 10–60 秒,取决于质量和尺寸。

可用端点

要同步官方 SDK?见 OpenAI 兼容接口