OpenAI 生图

文生图

curl "$BASE_URL/v1/images/generations" -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" -d '{"model":"IMAGE_MODEL","prompt":"一间有落地窗的安静书房，写实摄影风格","size":"1024x1024","n":1}'

响应通常包含 data 数组，图片可能是 URL 或 Base64。媒体 URL 可能有有效期，应及时下载或转存。

图像编辑

/v1/images/edits 使用 multipart 上传图片：

curl "$BASE_URL/v1/images/edits" -H "Authorization: Bearer $API_KEY" -F "model=IMAGE_MODEL" -F "prompt=把背景改成晴天的城市公园" -F "image=@./input.png"

异步图片任务

POST /v1/images/generations/async
POST /v1/images/edits/async
GET  /v1/images/tasks/{task_id}

适合经过代理、CDN 或浏览器时可能超过请求超时的图片任务。创建成功后按 task_id 查询，不要重复提交。

注意事项

• 图片权限由分组的媒体能力开关控制。
• 图片模型不一定与文本模型同名。
• 不要将图片 Base64 长期写入日志。
• 生成失败时先查看错误消息，再决定是否重试。