跳转到主要内容
POST
/
v1
/
images
/
generations
创建图像
curl --request POST \
  --url https://api.dedaluslabs.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "model": "openai/dall-e-3",
  "n": 1,
  "quality": "standard",
  "response_format": "url",
  "output_format": "png",
  "output_compression": 85,
  "stream": true,
  "partial_images": 0,
  "size": "1024x1024",
  "moderation": "auto",
  "background": "transparent",
  "style": "vivid",
  "user": "<string>"
}
'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ]
}

授权

​
Authorization
string
header
必填

使用 Bearer 令牌的 API 密钥身份验证

请求体

application/json

用于生成图像的请求对象。

​
prompt
string
必填

用文本描述你希望生成的图像。gpt-image-1 的最大长度为 32000 个字符，dall-e-2 的最大长度为 1000 个字符，dall-e-3 的最大长度为 4000 个字符。

示例:

"A white siamese cat"

​
model
string | null

用于图像生成的模型。可选值为 openai/dall-e-2、openai/dall-e-3 或 openai/gpt-image-1。默认使用 openai/dall-e-2，除非请求中使用了仅适用于 gpt-image-1 的特定参数。

示例:

"openai/dall-e-3"

​
n
integer | null

要生成的图像数量，取值范围为 1 到 10。对于 dall-e-3，仅支持 n=1。

必填范围: 1 <= x <= 10
示例:

1

​
quality
enum<string> | null

要生成的图像质量。

  • auto（默认）会根据所用的 model 自动选择最佳质量。
  • gpt-image-1 支持 high、medium 和 low。
  • dall-e-3 支持 hd 和 standard。
  • dall-e-2 仅支持 standard。
可用选项:
auto,
high,
medium,
low,
hd,
standard
示例:

"standard"

​
response_format
enum<string> | null

由 dall-e-2 和 dall-e-3 生成的图像的返回格式。必须是 url 或 b64_json 之一。图像生成后，其 URL 仅在 60 分钟内有效。此参数不适用于 gpt-image-1，该模型始终返回以 base64 编码的图像。

可用选项:
url,
b64_json
示例:

"url"

​
output_format
enum<string> | null

生成图像的返回格式。此参数仅 gpt-image-1 模型支持，取值必须为 png、jpeg 或 webp。

可用选项:
png,
jpeg,
webp
示例:

"png"

​
output_compression
integer | null

生成图像的压缩质量（0–100）。此参数仅在输出格式为 webp 或 jpeg 的 gpt-image-1 模型中受支持，默认值为 100。

必填范围: 0 <= x <= 100
示例:

85

​
stream
boolean | null

以流式传输方式生成图像。默认值为 false。详情请参阅 图像生成指南。 该参数仅支持 gpt-image-1。

示例:

true

​
partial_images
integer | null

要生成的局部图像数量。此参数用于在流式传输响应中返回局部图像。取值必须在 0 到 3 之间。 当设置为 0 时，响应将是一张通过单个流式传输事件发送的完整图像。

注意：如果完整图像生成得更快，则可能会在全部局部图像尚未生成完成之前，就先发送最终完整图像。

必填范围: 0 <= x <= 3
示例:

0

​
size
enum<string> | null

生成图像的尺寸。

对于 gpt-image-1，必须为以下值之一：1024x1024、1536x1024（横向）或 1024x1536（纵向），或 auto（默认）。

对于 dall-e-2，必须为以下值之一：256x256、512x512 或 1024x1024。

对于 dall-e-3，必须为以下值之一：1024x1024、1792x1024 或 1024x1792。

可用选项:
256x256,
512x512,
1024x1024,
1536x1024,
1024x1536,
1792x1024,
1024x1792,
auto
示例:

"1024x1024"

​
moderation
enum<string> | null

控制对 gpt-image-1 生成图像所应用的内容审核级别。取值必须为 low（审核/过滤更宽松）或 auto（默认值）。

可用选项:
low,
auto
示例:

"auto"

​
background
enum<string> | null

允许为生成图像的背景设置透明度。 此参数仅支持 gpt-image-1。取值只能为 transparent、opaque 或 auto（默认）。当使用 auto 时，model 会自动为图像选择最合适的背景。

如果设置为 transparent，则输出格式必须支持透明背景，因此应将其设置为 png（默认）或 webp。

可用选项:
transparent,
opaque,
auto
示例:

"transparent"

​
style
enum<string> | null

生成图像的风格。该参数仅在 dall-e-3 模型中受支持。取值必须是 vivid 或 natural 之一。vivid 会让模型倾向于生成更具戏剧效果、超现实的图像；natural 会让模型生成更加自然、不过分写实的图像。

可用选项:
vivid,
natural
示例:

"vivid"

​
user
string | null

终端用户的唯一标识符，用于帮助 OpenAI 监控和检测滥用行为。了解更多。

响应

成功响应

图像生成的响应。

​
created
integer
必填

图像创建时的 Unix 时间戳。

​
data
Image · object[]
必填

生成的图像列表。