图像

给定提示和/或输入图像，模型将生成新图像。

相关指南：图像生成

---

创建图像 beta

POST https://api.openai.com/v1/images/generations

根据提示创建图像。

请求正文

prompt string 必填

所需图像的文本描述。最大长度为 1000 个字符。

---

n integer 可选 默认 1

要生成的图像数。必须介于 1 和 10 之间。

---

size string 可选 默认 1024x1024

生成图像的大小。必须是 256x256、512x512 或 1024x1024之一。

---

response_format string 默认 url

生成的图像返回的格式。必须是 url 或 b64_json 之一。

---

user string 可选

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。了解更多。

请求示例

curl

curl https://api.openai.com/v1/images/generations \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
  "prompt": "A cute baby sea otter",
  "n": 2,
  "size": "1024x1024"
}'

参数

{
  "prompt": "A cute baby sea otter",
  "n": 2,
  "size": "1024x1024"
}

响应结果

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

创建图像编辑 beta

POST https://api.openai.com/v1/images/edits

在给定原始图像和提示的情况下创建编辑或扩展图像。

请求正文

image string 必填

要编辑的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。如果未提供遮罩，图像必须具有透明度，将用作遮罩。

---

mask string 可选

完全透明区域（例如 alpha 为零的区域）的附加图像指示应编辑图像的位置。必须是有效的 PNG 文件，小于 4MB，并且与图像具有相同的尺寸。

---

prompt string 必填

所需图像的文本描述。最大长度为 1000 个字符。

---

n integer 可选 默认 1

要生成的图像数。必须介于 1 和 10 之间。

---

size string 可选 默认 1024x1024

生成图像的大小。必须是 256x256、512x512 或 1024x1024 之一。

---

response_format string 默认 url

生成的图像返回的格式。必须是 url 或 b64_json 之一。

---

user string 可选

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。了解更多。

创建图像变体 beta

POST https://api.openai.com/v1/images/variations

创建给定图像的变体。

请求正文

image string 必填

要编辑的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。如果未提供遮罩，图像必须具有透明度，将用作遮罩。

---

n integer 可选 默认 1

要生成的图像数。必须介于 1 和 10 之间。

---

size string 可选 默认 1024x1024

生成图像的大小。必须是 256x256、512x512 或 1024x1024 之一。

---

response_format string 默认 url

生成的图像返回的格式。必须是 url 或 b64_json 之一。

---

user string 可选

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。了解更多。