Skip to main content
GPT-Image-2 是 SmewAI 提供的 AI 图片生成服务,使用独立的图片接口。

准备工作

1. 创建 API Key

前往 API Keys 管理页面,点击「创建 API Key」,分组选择 GPT-Image 创建完成后请妥善保存,后续所有请求都需要在 Header 中携带此 Key。

2. 接口地址

GPT-Image-2 使用 OpenAI 兼容图片接口,文档和新接入请优先使用标准路径:
查询异步任务结果时使用:
说明:/images/generations 是兼容别名,但不建议新接入继续使用;/gpt-image/v1 也不是当前推荐路径。

AI Agent 一键接入

如果你使用 Codex 等支持 Skills 的 AI 编码工具,可以直接将以下地址发送给你的 AI:
AI 会自动安装生图技能并引导你完成配置,之后只需对 AI 说「帮我生成一张图片」即可。

API 详细说明

文生图(Text to Image)

提交生成任务:
成功响应:

查询任务结果

task_xxx 替换为提交任务时返回的 task_id
任务处理中:
任务完成:
最终图片地址为 data.result.images[0].url[0],可直接在浏览器打开或放到 <img src="..."> 中展示。

图生图(Image to Image)

在请求体中添加 image_urls 字段,即可基于参考图进行编辑或风格转换。 使用 URL 引用图片:
使用 base64 传入图片:
图生图注意事项:
  • image_urls 为数组,最多支持 16 张参考图
  • 支持 URL 和 base64 data URI 两种格式,可混用
  • base64 图片会占用请求体大小,过大可能被网关拦截,建议优先使用 URL
  • 图生图的计费方式不变,仍按 resolution 档位计费

参数说明

resolution 支持

size 支持

注意: 4k 分辨率仅支持 16:99:162:11:221:99:21 这几种比例。其他比例搭配 4k 会报错。

Python 示例