> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 2 Light 编辑

GPT Image 2 Light 图片编辑 API。通过 images 数组接收图片 URL，根据提示词编辑输入图片，并返回编辑后的图片 URL。

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式: Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="mask" type="object">
  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="image_url" type="string">
      蒙版图片 URL 或 data URL。蒙版图必须是 PNG，且必须带 alpha channel，例如 RGBA 或 LA。透明区域表示需要被编辑或重绘的区域，不透明区域表示尽量保持不变的区域。蒙版尺寸通常需要和输入 image 一致。不支持 file\_id。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="size" type="string" default="auto">
  输出尺寸，默认 auto，不支持其他尺寸，auto 由模型提示词判定。

  可选值：`auto`
</ParamField>

<ParamField body="images" type="object[]" required={true}>
  JSON URL 模式下的待编辑原图列表。至少需要一个 image\_url，支持 URL 或 data URL。

  数组长度：1 - 16

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="image_url" type="string" required={true}>
      输入图片 URL 或 data URL。不支持 file\_id。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  描述希望如何修改输入图片的编辑指令。为空会返回 prompt is required。

  长度限制：0 - 32000
</ParamField>

<ParamField body="background" type="string">
  输出图片背景处理方式。

  可选值：`auto`, `opaque`
</ParamField>

<ParamField body="moderation" type="string">
  内容审核严格程度。

  可选值：`auto`, `low`
</ParamField>

## 响应信息

<ResponseField name="images" type="string[]" required={false}>
  平台存储转换后的编辑结果图片 URL 数组。
</ResponseField>