Skip to main content
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://model-api.skyengine.com.cn/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "一只可爱的小猫在花园里玩耍，阳光明媚，油画风格"
}
'
{
  "created": 1589478378,
  "background": "auto",
  "output_format": "png",
  "quality": "high",
  "size": "1024x1024",
  "data": [
    {
      "url": "https://oaidalleapiprodscus.blob.core.windows.net/private/org-abc123/user-abc123/img-abc123.png"
    }
  ],
  "usage": {
    "input_tokens": 15,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 15
    },
    "output_tokens": 1,
    "total_tokens": 16
  }
}

Authorizations

​
Authorization
string
header
required

OpenAI API密钥认证。在 Authorization HTTP Header 中包含您的 API-Key，格式为 Bearer {API_KEY}

Body

application/json
​
prompt
string
required

描述所需图像的文本提示。gpt-image-1 最大长度为 32000 个字符，dall-e-2 最大长度为 1000 个字符，dall-e-3 最大长度为 4000 个字符

Maximum string length: 32000
Example:

"一只可爱的小猫在花园里玩耍，阳光明媚，油画风格"

​
background
enum<string> | null
default:auto

设置生成图像背景的透明度。此参数仅支持 gpt-image-1。必须是 transparent、opaque 或 auto（默认值）之一。当使用 auto 时，模型将自动确定图像的最佳背景。如果是 transparent，输出格式需要支持透明度，因此应设置为 png（默认值）或 webp

Available options:
transparent,
opaque,
auto
​
model
enum<string> | null

用于图像生成的模型。dall-e-2、dall-e-3 或 gpt-image-1 之一。

Available options:
dall-e-2,
dall-e-3,
gpt-image-1
Example:

"gpt-image-1"

​
moderation
enum<string> | null
default:auto

控制 gpt-image-1 生成图像的内容审核级别。必须是 low（较少限制的过滤）或 auto（默认值）

Available options:
low,
auto
​
n
integer | null
default:1

要生成的图像数量。必须在 1 到 10 之间。对于 dall-e-3，仅支持 n=1

Required range: 1 <= x <= 10
Example:

1

​
output_compression
integer | null
default:100

生成图像的压缩级别（0-100%）。此参数仅支持使用 webp 或 jpeg 输出格式的 gpt-image-1，默认为 100

Required range: 0 <= x <= 100
​
output_format
enum<string> | null
default:png

生成图像返回的格式。此参数仅支持 gpt-image-1。必须是 png、jpeg 或 webp 之一

Available options:
png,
jpeg,
webp
​
partial_images
integer
default:0

要生成的部分图像数量。此参数用于返回部分图像的流式响应。值必须在 0 到 3 之间。当设置为 0 时，响应将是在一个流式事件中发送的单个图像。注意，如果完整图像生成得更快，最终图像可能会在生成完整数量的部分图像之前发送

Required range: 0 <= x <= 3
​
quality
enum<string> | null
default:auto

将要生成的图像质量。auto（默认值）将自动为给定模型选择最佳质量。gpt-image-1 支持 high、medium 和 low。dall-e-3 支持 hd 和 standard。dall-e-2 仅支持 standard

Available options:
auto,
high,
medium,
low,
hd,
standard
​
response_format
enum<string> | null
default:url

dall-e-2 和 dall-e-3 生成图像的返回格式。必须是 url 或 b64_json 之一。URL 仅在生成图像后的 60 分钟内有效。此参数不支持 gpt-image-1，后者始终返回 base64 编码的图像

Available options:
url,
b64_json
​
size
enum<string> | null
default:auto

生成图像的尺寸。gpt-image-1 必须是 1024x1024、1536x1024（横向）、1024x1536（纵向）或 auto（默认值）之一。dall-e-2 必须是 256x256、512x512 或 1024x1024 之一。dall-e-3 必须是 1024x1024、1792x1024 或 1024x1792 之一

Available options:
1024x1024,
1536x1024,
1024x1536,
auto,
256x256,
512x512,
1792x1024,
1024x1792
​
stream
boolean | null
default:false

以流式模式生成图像。默认为 false。有关更多信息，请参阅图像生成指南。此参数仅支持 gpt-image-1

​
style
enum<string> | null
default:vivid

生成图像的风格。此参数仅支持 dall-e-3。必须是 vivid 或 natural 之一。vivid 使模型倾向于生成超现实和戏剧性的图像。natural 使模型产生更自然、不太超现实的图像

Available options:
vivid,
natural
​
user
string

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用

Response

图像创建成功

​
created
integer<int64>
required

图像创建时的 Unix 时间戳（以秒为单位）

Example:

1677649963

​
data
object[]
required

生成的图像列表

​
background
enum<string>

用于图像生成的背景参数。transparent 或 opaque

Available options:
transparent,
opaque
​
output_format
enum<string>

图像生成的输出格式。png、webp 或 jpeg

Available options:
png,
webp,
jpeg
​
quality
enum<string>

生成图像的质量。low、medium 或 high

Available options:
low,
medium,
high
​
size
enum<string>

生成图像的尺寸。1024x1024、1024x1536 或 1536x1024

Available options:
1024x1024,
1024x1536,
1536x1024
​
usage
object

仅适用于 gpt-image-1，图像生成的 token 使用信息