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

图片编辑

需要通过multipart/form-data形式上传图片

POST
/api/v1/image/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

model?string

模型名称,固定值:

gpt-image-1.5

gpt-image-2

prompt?string

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

background?string

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

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

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

input_fidelity?string

可选“high”或“low”,控制对原始输入图像的保真度。

mask?string

传入图片URL

一张附加图像,其完全透明的区域(例如 alpha 值为零的部分)指示出图像需要编辑的位置。如果提供了多张图像,则该蒙版将应用于第一张图像。必须为有效的 PNG 文件,大小不超过 4MB,且尺寸与原图像相同。

moderation?string

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

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

n?integer

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

最小值:1

最大值:10

output_compression?integer

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

output_format?string

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

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

quality?string

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

size?string

size:可选字符串,或 "auto"、"1024x1024"、"1536x1024" 。

user?string

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

images?

传入图片URL

用于编辑的输入图像参考。对于GPT图像模型,您最多可以提供16张图像。

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"
}