GPT Image 2
OpenAI 最新图像生成模型,支持高质量文生图、透明背景输出和灵活的图片压缩选项。
在线体验
快速开始
python
from openai import OpenAI
client = OpenAI(
base_url="https://open.dieyuyun.com/v1",
api_key="YOUR_API_KEY"
)
response = client.images.generate(
model="gpt-image-2",
prompt="A golden retriever on a beach at sunset, photorealistic",
size="1024x1024",
quality="high",
n=1
)
print(response.data[0].url)请求端点
| 项目 | 值 |
|---|---|
| 方法 | POST |
| 路径 | /v1/images/generations |
| Base URL | https://open.dieyuyun.com |
| 兼容协议 | OpenAI Images API |
认证
Bearer Token: Authorization: Bearer YOUR_API_KEY
标准请求字段
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | — | 模型标识: gpt-image-2 |
| prompt | string | 是 | — | 图像描述文本,最大 32000 字符 |
| size | string | 否 | 1024x1024 | 图像尺寸: 1024x1024、1536x1024(横版)、1024x1536(竖版)、auto |
| quality | string | 否 | auto | 生成质量: auto、low、medium、high |
| n | integer | 否 | 1 | 生成数量,1~10 |
| response_format | string | 否 | url | 返回格式: url 或 b64_json |
| background | string | 否 | auto | 背景类型: auto、opaque、transparent |
| moderation | string | 否 | auto | 内容审核级别: auto、low |
| output_compression | integer | 否 | — | 输出图片压缩比例,0~100,仅 b64_json 格式有效 |
| output_format | string | 否 | — | 输出格式: png、jpeg、webp |
模型特有参数
透明背景 (background)
设置 background 为 transparent 可生成透明背景的 PNG 图片,适用于 logo 设计、贴纸等场景。
json
{
"model": "gpt-image-2",
"prompt": "A company logo of a mountain",
"background": "transparent",
"output_format": "png"
}输出压缩 (output_compression)
当 response_format 为 b64_json 时,可通过 output_compression 控制输出图片的压缩级别,减少传输体积。
json
{
"model": "gpt-image-2",
"prompt": "A landscape painting",
"response_format": "b64_json",
"output_compression": 80
}请求示例
bash
curl https://open.dieyuyun.com/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A golden retriever on a beach at sunset",
"size": "1024x1024",
"quality": "high",
"n": 1
}'python
from openai import OpenAI
client = OpenAI(
base_url="https://open.dieyuyun.com/v1",
api_key="YOUR_API_KEY"
)
response = client.images.generate(
model="gpt-image-2",
prompt="A golden retriever on a beach at sunset",
size="1024x1024",
quality="high",
n=1
)
print(response.data[0].url)javascript
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'https://open.dieyuyun.com/v1',
apiKey: 'YOUR_API_KEY',
})
const response = await client.images.generate({
model: 'gpt-image-2',
prompt: 'A golden retriever on a beach at sunset',
size: '1024x1024',
quality: 'high',
n: 1,
})
console.log(response.data[0].url)透明背景示例
bash
curl https://open.dieyuyun.com/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A minimalist logo of a rocket",
"size": "1024x1024",
"background": "transparent",
"output_format": "png",
"n": 1
}'python
from openai import OpenAI
client = OpenAI(
base_url="https://open.dieyuyun.com/v1",
api_key="YOUR_API_KEY"
)
response = client.images.generate(
model="gpt-image-2",
prompt="A minimalist logo of a rocket",
size="1024x1024",
background="transparent",
output_format="png",
n=1
)
print(response.data[0].url)响应格式
成功响应
json
{
"created": 1717000000,
"data": [
{
"url": "https://...",
"revised_prompt": "A photorealistic image of a golden retriever running on a sandy beach during golden hour sunset, warm light reflecting off the ocean waves"
}
]
}| 字段 | 类型 | 说明 |
|---|---|---|
| created | integer | Unix 时间戳 |
| data | array | 生成结果数组 |
| data[].url | string | 图像 URL(response_format 为 url 时) |
| data[].b64_json | string | Base64 编码的图像数据(response_format 为 b64_json 时) |
| data[].revised_prompt | string | 优化后的提示词 |
错误响应
详见 错误码。
最佳实践
- 提示词要具体: GPT Image 2 对详细描述响应更好,包含风格、光照、构图等细节能显著提升生成质量。
- 利用透明背景: 设计 logo、图标或需要叠加到其他图片上的素材时,设置
background: "transparent"省去后期抠图。 - 选择合适质量:
low适合快速预览和迭代,high适合最终出图。使用auto让系统根据提示词复杂度自动选择。 - 尺寸选择: 横版内容用
1536x1024,竖版内容用1024x1536,方形内容用1024x1024。 - 批量生成: 设置
n参数一次生成多张图片进行对比选择,比多次单独请求更高效。
速率限制
详见 速率限制。
相关文档
- GPT Image 2 Official - 使用官方原生接口
- 模型列表与定价 - 浏览可用模型和定价信息
- 使用 Playground 测试 - 交互式测试图像生成