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 字符
sizestring否1024x1024图像尺寸: 1024x1024、1536x1024(横版)、1024x1536(竖版)、auto
qualitystring否auto生成质量: auto、low、medium、high
ninteger否1生成数量,1~10
response_formatstring否url返回格式: url 或 b64_json
backgroundstring否auto背景类型: auto、opaque、transparent
moderationstring否auto内容审核级别: auto、low
output_compressioninteger否—输出图片压缩比例,0~100,仅 b64_json 格式有效
output_formatstring否—输出格式: 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"
    }
  ]
}
字段类型说明
createdintegerUnix 时间戳
dataarray生成结果数组
data[].urlstring图像 URL(response_format 为 url 时)
data[].b64_jsonstringBase64 编码的图像数据(response_format 为 b64_json 时)
data[].revised_promptstring优化后的提示词

错误响应 ​

详见 错误码。

最佳实践 ​

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

速率限制 ​

详见 速率限制。

相关文档 ​