切换主题
生成图像
在给定提示的情况下创建图像。了解更多。
生成图像
POST /v1/images/generations/
在给定提示的情况下创建图像。了解更多。
认证
Bearer
请求体
必填：否
application/json
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 否 | string | 用于图像生成的模型。dall-e-2、dall-e-3 或 gpt-image-1 之一。默认为 dall-e-2，除非使用特定于 gpt-image-1 的参数。 |
| prompt | 是 | string | 所需图像的文本描述。gpt-image-1 的最大长度为 32000 个字符，dall-e-2 的最大长度为 1000 个字符，dall-e-3 的最大长度为 4000 个字符。 |
| n | 否 | integer | 要生成的图像数量。必须介于 1 到 10 之间。对于 dall-e-3，仅支持 n=1。 |
| size | 否 | string | 生成的图像的大小。对于 gpt-image-1，必须是 1024x1024、1536x1024（横向）、1024x1536（纵向）或自动（默认值）之一，对于 dall-e-2，必须是 256x256、``512x512 或 1024x1024 之一，对于 dall-e-3，必须是 1024x1024、1792x1024 或 1024x1792 之一。 |
| background | 否 | string | 允许为生成的图像的背景设置透明度。此参数仅支持 gpt-image-1。必须是以下之一 透明、不透明或自动（默认值）。使用自动时，模型将自动确定图像的最佳背景。如果 是透明的，则输出格式需要支持透明度，因此应将其设置为 png（默认值）或 webp。 |
| moderation | 否 | string | 控制 gpt-image-1 生成的图像的内容审核级别。必须为低， 以进行限制较少的筛选或自动（默认值）。 |
| quality | 否 | string | 将生成的图像的质量。 |
| stream | 否 | string | - |
| style | 否 | string | - |
| user | 否 | string | - |
原始 Schema
json
{
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "用于图像生成的模型。`dall-e-2`、`dall-e-3` 或 `gpt-image-1` 之一。默认为 `dall-e-2`，除非使用特定于 `gpt-image-1` 的参数。"
},
"prompt": {
"type": "string",
"description": "所需图像的文本描述。`gpt-image-1` 的最大长度为 32000 个字符，`dall-e-2` 的最大长度为 1000 个字符，`dall-e-3` 的最大长度为 4000 个字符。"
},
"n": {
"type": "integer",
"description": "要生成的图像数量。必须介于 1 到 10 之间。对于 `dall-e-3`，仅支持 `n=1`。"
},
"size": {
"type": "string",
"description": "生成的图像的大小。`对于 gpt-image-1`，必须是 `1024x1024`、`1536x1024`（横向）、`1024x1536`（纵向）或`自动`（默认值）之一，`对于 dall-e-2`，必须是 `256x256、``512x512` 或 `1024x1024` 之一，对于 `dall-e-3`，必须是 `1024x1024`、`1792x1024` 或 `1024x1792` 之一。"
},
"background": {
"type": "string",
"description": "允许为生成的图像的背景设置透明度。此参数仅支持 `gpt-image-1`。必须是以下之一 `透明`、`不透明`或`自动`（默认值）。使用`自动`时，模型将自动确定图像的最佳背景。\n\n如果`是透明`的，则输出格式需要支持透明度，因此应将其设置为 `png`（默认值）或 `webp`。"
},
"moderation": {
"type": "string",
"description": "控制 `gpt-image-1` 生成的图像的内容审核级别。必须为`低，` 以进行限制较少的筛选或`自动`（默认值）。"
},
"quality": {
"type": "string",
"description": "将生成的图像的质量。"
},
"stream": {
"type": "string"
},
"style": {
"type": "string"
},
"user": {
"type": "string"
}
},
"required": [
"prompt"
],
"x-apifox-orders": [
"model",
"prompt",
"n",
"size",
"background",
"moderation",
"quality",
"stream",
"style",
"user"
]
}响应
200 Response
application/json
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| created | 是 | integer | - |
| data | 是 | array<object> | - |
| data[].b64_json | 否 | string | - |
| data[].url | 否 | string | - |
| usage | 是 | object | - |
| usage.total_tokens | 是 | integer | - |
| usage.input_tokens | 是 | integer | - |
| usage.output_tokens | 是 | integer | - |
| usage.input_tokens_details | 是 | object | - |
| usage.input_tokens_details.text_tokens | 是 | integer | - |
| usage.input_tokens_details.image_tokens | 是 | integer | - |
原始 Schema
json
{
"type": "object",
"properties": {
"created": {
"type": "integer"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"b64_json": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"url"
],
"x-apifox-orders": [
"b64_json",
"url"
]
}
},
"usage": {
"type": "object",
"properties": {
"total_tokens": {
"type": "integer"
},
"input_tokens": {
"type": "integer"
},
"output_tokens": {
"type": "integer"
},
"input_tokens_details": {
"type": "object",
"properties": {
"text_tokens": {
"type": "integer"
},
"image_tokens": {
"type": "integer"
}
},
"required": [
"text_tokens",
"image_tokens"
],
"x-apifox-orders": [
"text_tokens",
"image_tokens"
]
}
},
"required": [
"total_tokens",
"input_tokens",
"output_tokens",
"input_tokens_details"
],
"x-apifox-orders": [
"total_tokens",
"input_tokens",
"output_tokens",
"input_tokens_details"
]
}
},
"required": [
"created",
"data",
"usage"
],
"x-apifox-orders": [
"created",
"data",
"usage"
]
}