典名词元典名词元首页
API 文档
AI 模型接口图像OpenAi

图片生成

POST
/api/v1/image/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

prompt?string

所需图像的文本描述。GPT 图像模型的最大长度为 32000 个字符。

n?integer

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

最小值:1

最大值:10

size?string

size:可选字符串,或 "auto"、"1024x1024"、"1536x1024" 以及其他 5 个选项。

生成图像的尺寸。对于 gpt-image-2 和 gpt-image-2-2026-04-21,支持任意分辨率,以 宽x高 字符串形式指定,例如 1536x864。宽度和高度都必须能被 16 整除。高于 2560x1440 的分辨率为实验性功能,最大支持的分辨率为 3840x2160。请求的尺寸还必须满足模型当前的像素和边长限制。GPT 图像模型支持标准尺寸 1024x1024、1536x1024 和 1024x1536;对于允许自动调整尺寸的模型,支持 auto。

background?string

可选参数 "transparent"、"opaque" 或 "auto"。

当使用 auto 时,模型会自动为图像确定最佳背景。

如果设置为 transparent,则输出格式需要支持透明度,因此应设置为 png(默认值)或 webp。

moderation?string

可选参数 "low" 或 "auto"。

用于控制 GPT 图像模型生成图像的内容审核级别。取值必须为 low(限制较少的过滤)或 auto(默认值)。

output_compression?integer

生成图像的压缩级别(0-100%)。此参数仅受 GPT 图像模型支持,且仅在输出格式为 webp 或 jpeg 时有效,默认值为 100。

output_format?string

可选参数 "png"、"jpeg" 或 "webp"。

返回生成图像的格式。此参数仅受 GPT 图像模型支持。取值必须为 png、jpeg 或 webp 之一。

user?string

用于标识最终用户的唯一标识符,这有助于 OpenAI 监控和检测滥用行为。

model?string

模型名称,固定值:

gpt-image-1.5

gpt-image-2

Value in"gpt-image-1.5" | "gpt-image-2"
quality?string

quality:可选参数 "auto"、"low"、"medium" 或 "high"。

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}