Skip to content

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 URLhttps://open.dieyuyun.com
兼容协议OpenAI Images API

认证

Bearer Token: Authorization: Bearer YOUR_API_KEY

标准请求字段

字段类型必填默认值说明
modelstring模型标识: gpt-image-2
promptstring图像描述文本,最大 32000 字符
sizestring1024x1024图像尺寸: 1024x10241536x1024(横版)、1024x1536(竖版)、auto
qualitystringauto生成质量: autolowmediumhigh
ninteger1生成数量,1~10
response_formatstringurl返回格式: urlb64_json
backgroundstringauto背景类型: autoopaquetransparent
moderationstringauto内容审核级别: autolow
output_compressioninteger输出图片压缩比例,0~100,仅 b64_json 格式有效
output_formatstring输出格式: pngjpegwebp

模型特有参数

透明背景 (background)

设置 backgroundtransparent 可生成透明背景的 PNG 图片,适用于 logo 设计、贴纸等场景。

json
{
  "model": "gpt-image-2",
  "prompt": "A company logo of a mountain",
  "background": "transparent",
  "output_format": "png"
}

输出压缩 (output_compression)

response_formatb64_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"
    }
  ]
}
字段类型说明
createdintegerUnix 时间戳
dataarray生成结果数组
data[].urlstring图像 URL(response_formaturl 时)
data[].b64_jsonstringBase64 编码的图像数据(response_formatb64_json 时)
data[].revised_promptstring优化后的提示词

错误响应

详见 错误码

最佳实践

  • 提示词要具体: GPT Image 2 对详细描述响应更好,包含风格、光照、构图等细节能显著提升生成质量。
  • 利用透明背景: 设计 logo、图标或需要叠加到其他图片上的素材时,设置 background: "transparent" 省去后期抠图。
  • 选择合适质量: low 适合快速预览和迭代,high 适合最终出图。使用 auto 让系统根据提示词复杂度自动选择。
  • 尺寸选择: 横版内容用 1536x1024,竖版内容用 1024x1536,方形内容用 1024x1024
  • 批量生成: 设置 n 参数一次生成多张图片进行对比选择,比多次单独请求更高效。

速率限制

详见 速率限制

相关文档