编辑图像

在给定原始图像和提示的情况下创建编辑或扩展图像。

Request Body

model*string

模型名，本网关必填

image*string

待编辑图片，公网 URL 或 Base64 字符串

images?array<string>

多张待编辑图片。本网关扩展字段

prompt*string

编辑指令

mask?string

遮罩图，公网 URL 或 Base64 字符串

n?integer

生成数量，网关侧允许 1–128，缺省按 1 处理

Range1 <= value <= 128

size?string

输出尺寸，格式宽x高

quality?string

画质档位；gpt-image-1 缺省 auto

Value in"auto" | "low" | "medium" | "high" | "standard"

background?string

背景处理，仅 GPT image 系列支持

Value in"transparent" | "opaque" | "auto"

input_fidelity?string

输入还原强度，仅 gpt-image-1 及更新的模型支持

Value in"low" | "high"

output_format?string

输出图片格式，仅 GPT image 系列支持

Value in"png" | "jpeg" | "webp"

output_compression?integer

压缩率 0–100

Range0 <= value <= 100

response_format?string

返回形式，仅 dall-e-2 支持

Value in"url" | "b64_json"

stream?boolean

是否流式返回中间结果

watermark?boolean

是否添加水印。本网关扩展字段

user?string

终端用户标识

Response Body

application/json

curl -X POST "https://jiniu.ai/v1/images/edits" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "image": "https://example.com/input.png",
    "prompt": "string"
  }'

curl -X POST "https://jiniu.ai/v1/images/edits" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-image-1",    "image": "https://example.com/input.png",    "prompt": "string"  }'

{
  "created": 0,
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}

Request Body

Response Body

200application/json

application/json