跳转到主要内容

OpenAI 异步图像接口

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

模型

工作流程

1

创建任务

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

轮询

GET /openai/tasks?taskId=<taskId>,直到 completed 或 failed。
3

读结果

result 跟 response_format:默认 url(自家 S3)。要 base64 设 b64_json。只返回其中一个字段。
image 和 mask 只能是 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 兼容接口。