GPTImage-2 中转 API 调用教程

本教程介绍如何通过中转 API 调用 gpt-image-2 图像生成模型，使用 Python 和 OpenAI SDK 实现文字生图和参考图生图两种方式。

环境准备

安装依赖

所需库说明

openai: OpenAI 官方 SDK，用于调用 API

httpx: 异步 HTTP 客户端，用于下载图片

requests: 同步 HTTP 请求库

base64: Python 内置库，用于图像编码解码

基础配置

使用 OpenAI SDK 配置客户端：

文字生图（单图）

基本用法

最简单的文字生图示例：

参数说明

参数	类型	说明	可选值
`model`	string	模型名称	`"gpt-image-2"`
`prompt`	string	图片描述文本	任意文本
`size`	string	图片尺寸	见图像尺寸与比例
`quality`	string	图片质量	`"low"`, `"high"`

文字生图（并发批量）

使用异步方式并发生成多张图片，提高效率：

性能对比

同步方式: 生成 5 张图片约需 50-75 秒（每张 10-15 秒）

异步并发: 生成 5 张图片约需 15-20 秒（并发执行）

参考图生图

基于参考图像和文本描述生成新图像（图生图）：

使用本地图片作为参考

如果需要使用本地图片，需要先转换为 base64 或上传到图床：

图像尺寸与比例

gpt-image-2 支持多种图像尺寸和比例，长边固定为 1024px 或 2048px：

常用尺寸（1024px 长边）

比例	尺寸	说明	适用场景
1:1	1024x1024	正方形	社交头像、Logo
3:2	1024x683	横构图	单反相机常见比例
2:3	683x1024	竖构图	海报竖版
4:3	1024x768	横构图	经典显示器、PPT
3:4	768x1024	竖构图	竖版海报
5:4	1024x819	横构图	传统照片
4:5	819x1024	竖构图	Instagram 竖版帖子
16:9	1024x576	横构图	宽屏视频封面
9:16	576x1024	竖构图	手机全屏、短视频封面
2:1	1024x512	横构图	网页 Banner
1:2	512x1024	竖构图	竖版 Banner
21:9	1024x439	横构图	电影超宽屏
9:21	439x1024	竖构图	超窄竖版

高清尺寸（2048px 长边）

将上述尺寸的宽高都乘以 2 即可，例如：

2048x2048 (1:1)

2048x1366 (3:2)

2048x1152 (16:9)

尺寸测试示例

完整示例代码

示例 1: 简单文字生图

示例 2: 并发批量生成

示例 3: 参考图生图

常见问题

1. 如何选择图片质量？

quality="low": 生成速度快，适合测试和预览

quality="high": 生成质量高，细节丰富，适合正式使用

2. 同步 vs 异步客户端

3. 返回格式选择

API 支持两种返回格式：

4. 错误处理

5. 超时设置

6. 如何提高生成质量？

优化 Prompt 技巧：

Prompt 要素：

主体描述（什么）

细节特征（颜色、材质、姿态）

环境背景

艺术风格（水彩、油画、摄影等）

光线效果

画质要求（高清、细节丰富等）

7. 性能优化建议

批量生成优化：

8. 文件命名建议

进阶技巧

1. 批量生成不同尺寸

2. 重试机制

3. 进度显示

总结

本教程介绍了使用 OpenAI SDK 调用 gpt-image-2 中转 API 的完整方法：

文字生图: 通过文本描述直接生成图像

参考图生图: 基于参考图像和文本描述生成新图像

并发批量: 使用异步方式提高批量生成效率

多种尺寸: 支持 13 种常用比例和自定义尺寸

核心要点：

使用 OpenAI SDK 简化 API 调用

异步并发可大幅提升批量生成效率

合理选择图片尺寸和质量参数

做好错误处理和超时设置

参考资源

OpenAI Python SDK 文档

OpenAI Images API 文档

httpx 异步客户端文档

完整示例代码: gpt-image-2单图并发请求.py

目录#

环境准备#

安装依赖#

所需库说明#

基础配置#

文字生图（单图）#

基本用法#

参数说明#

文字生图（并发批量）#

性能对比#

参考图生图#

使用本地图片作为参考#

图像尺寸与比例#

常用尺寸（1024px 长边）#

高清尺寸（2048px 长边）#

尺寸测试示例#

完整示例代码#

示例 1: 简单文字生图#

示例 2: 并发批量生成#

示例 3: 参考图生图#

常见问题#

1. 如何选择图片质量？#

2. 同步 vs 异步客户端#

3. 返回格式选择#

4. 错误处理#

5. 超时设置#

6. 如何提高生成质量？#

7. 性能优化建议#

8. 文件命名建议#

进阶技巧#

1. 批量生成不同尺寸#

2. 重试机制#

3. 进度显示#

总结#

参考资源#

目录