分享
图像生成（Image generation）
输入“/”快速插入内容
图像生成（Image generation）
了解如何使用我们的 DALL·E 模型生成或处理图像
介绍
图片 API 提供了三种与图片交互的方法：
1.
根据文本提示从头开始创建图像
2.
根据新文本提示创建现有图像的编辑
3.
创建现有图像的变体
本指南涵盖了使用这三个 API 端点的基础知识以及有用的代码示例。要查看它们的实际效果，请查看我们的
DALL·E 预览应用程序
。
图片 API 处于测试阶段。在此期间，API 和模型将根据您的反馈进行改进。为确保所有用户都能轻松制作原型，默认速率限制为每分钟 50 张图像。如果您想提高速率限制，请查看这篇
帮助中心文章
。随着我们对使用和容量要求的更多了解，我们将提高默认速率限制。
用法
图像
生成
端点允许您在给定文本提示的情况下创建原始图像。生成的图像的大小可以为 256x256、512x512 或 1024x1024 像素。较小的尺寸生成速度更快。
您可以使用 n
参数一次请求 1-10 张图像。
代码块
Python
response = openai.Image.create(
prompt="a white siamese cat",
n=1,
size="1024x1024"
)
image_url = response['data'][0]['url']
描述越详细，您就越有可能获得您或您的最终用户想要的结果。
您可以探索 DALL·E 预览应用程序
中的示例以获得更多提示灵感。这是一个简单的例子：
使用 response_format
参数，每个图像都可以作为 URL 或 Base64 数据返回。URL 将在一小时后过期。
编辑
图像
编辑
端点允许您通过上传蒙版来编辑和扩展图像。遮罩的透明区域指示应编辑图像的位置，提示应描述完整的新图像，而
不仅仅是擦除区域
。此端点可以启用类似
我们 DALL·E 预览应用程序中的编辑器的
体验。
代码块
Python
response = openai.Image.create_edit(
image=open("sunlit_lounge.png", "rb"),
mask=open("mask.png", "rb"),
prompt="A sunlit indoor lounge area with a pool containing a flamingo",
n=1,
size="1024x1024"
)
image_url = response['data'][0]['url']
提示：一个阳光充足的室内休息区，带有一个包含火烈鸟的游泳池
上传的图片和遮罩必须是小于 4MB 的正方形 PNG 图片，并且必须具有相同的尺寸。生成输出时不使用遮罩的非透明区域，因此它们不一定需要像上面的示例那样与原始图像匹配。
变化
图像
变体
端点允许您生成给定图像的变体。
代码块
Python
response = openai.Image.create_variation(
image=open("corgi_and_cat_paw.png", "rb"),
n=1,
size="1024x1024"
)
image_url = response['data'][0]['url']
与编辑端点类似，输入图像必须是大小小于 4MB 的方形 PNG 图像。
内容审核
提示和图像根据我们的
内容政策
进行过滤，当提示或图像被标记时返回错误。如果您对误报或相关问题有任何反馈，请通过我们的
帮助中心
联系我们。
特定语言提示
使用内存图像数据
上面指南中的 Node.js 示例使用该
fs
模块从磁盘读取图像数据。在某些情况下，您可能会将图像数据保存在内存中。下面是一个使用存储在 Node.js
Buffer
对象中的图像数据的 API 调用示例：
代码块
Python
// This is the Buffer object that contains your image data
const buffer = [your image data];
// Set a `name` that ends with .png so that the API knows it's a PNG image
buffer.name = "image.png";
const response = await openai.createImageVariation(
buffer,
1,
"1024x1024"
);