GPT Image 2 Official

通过 OpenAI 官方原生接口格式调用 GPT Image 2，获得与 OpenAI 完全一致的图像生成体验。

在线体验

在 Playground 中测试 ↗ · 查看模型列表 ↗

快速开始

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-official",
    prompt="A watercolor painting of a Japanese garden in spring",
    size="1024x1024",
    quality="high",
    n=1
)

print(response.data[0].url)

请求端点

项目	值
方法	POST
路径	/v1/images/generations
Base URL	https://open.dieyuyun.com
兼容协议	OpenAI Images API (Official)

认证

Bearer Token: Authorization: Bearer YOUR_API_KEY

标准请求字段

字段	类型	必填	默认值	说明
model	string	是	—	模型标识: gpt-image-2-official
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
output_format	string	否	—	输出格式: png、jpeg、webp

与兼容接口的区别

GPT Image 2 Official 使用 OpenAI 官方原生接口格式，与兼容接口（gpt-image-2）的主要区别：

特性	兼容接口 (gpt-image-2)	官方接口 (gpt-image-2-official)
协议格式	OpenAI 兼容适配	OpenAI 原生格式
异步任务	支持异步轮询	同步返回
适用场景	通用集成	需要官方原生行为的场景

请求示例

cURL

curl https://open.dieyuyun.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-official",
    "prompt": "A watercolor painting of a Japanese garden in spring",
    "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-official",
    prompt="A watercolor painting of a Japanese garden in spring",
    size="1024x1024",
    quality="high",
    n=1
)

print(response.data[0].url)

Node.js

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-official',
  prompt: 'A watercolor painting of a Japanese garden in spring',
  size: '1024x1024',
  quality: 'high',
  n: 1,
})

console.log(response.data[0].url)

响应格式

成功响应

{
  "created": 1717000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A delicate watercolor painting depicting a serene Japanese garden in spring, cherry blossoms in full bloom, koi pond, stone lanterns, soft pastel colors"
    }
  ]
}

字段	类型	说明
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	优化后的提示词

错误响应

详见 错误码。

最佳实践

• 官方接口优先: 如果您从 OpenAI 官方迁移，使用 gpt-image-2-official 可确保接口行为完全一致。
• 提示词优化: GPT Image 2 会自动优化提示词（返回在 revised_prompt 中），无需手动进行复杂调优。
• 透明背景: 支持 background: "transparent" 生成透明背景图片，适合 logo 和素材设计。
• 质量档位选择: 对于商业用途的最终出图使用 high，快速原型验证使用 low 或 medium。

速率限制

详见 速率限制。

相关文档

• GPT Image 2 兼容接口 - 使用兼容接口生图
• 模型列表与定价 - 浏览可用模型和定价信息
• 使用 Playground 测试 - 交互式测试图像生成