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

# 图像编辑

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

## 请求头

**Authorization** `string` *required*

Bearer Token 认证，格式：`Bearer <token>`

## 请求体

格式：`multipart/form-data`

**image** `file` *required*

要编辑的图像。必须是有效的 PNG 文件，小于 4MB，并且是方形的。如果未提供遮罩，图像必须具有透明度，将用作遮罩。

格式：`binary`

**mask** `file`

附加图像，其完全透明区域（例如，alpha 为零的区域）指示 `image` 应编辑的位置。必须是有效的 PNG 文件，小于 4MB，并且尺寸与原始 `image` 相同。

格式：`binary`

**prompt** `string` *required*

所需图像的文本描述。最大长度为 1000 个字符。

**n** `string`

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

**size** `string`

生成图像的大小。必须是 `256x256`、`512x512` 或 `1024x1024` 之一。

**response\_format** `string`

生成的图像返回的格式。必须是 `url` 或 `b64_json`。

**user** `string`

代表您的最终用户的唯一标识符，可以帮助 OpenAI 监控和检测滥用行为。[了解更多](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids)。

**model** `string`

模型 ID

## 响应

### 200

格式：`application/json`

**created** `integer`

创建时间戳（Unix 时间）。

**data** `object[]`

编辑后的图像列表。

**属性**

**b64\_json** `string`

Base64 编码的图像数据

**url** `string`

图像 URL

```bash cURL theme={"dark"}
curl -X POST "https://t.ato2.nodesms.com/v1/images/edits/" \
  -H "Authorization: Bearer $API_KEY" \
  -F image="@otter.png" \
  -F mask="@mask.png" \
  -F prompt="A cute baby sea otter wearing a beret"
```

```python Python theme={"dark"}
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxx",
    base_url="https://t.ato2.nodesms.com/v1"
)

response = client.images.edit(
    model="dall-e-2",
    image=open("otter.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="A cute baby sea otter wearing a beret",
    n=1,
    size="1024x1024"
)
print(response.data[0].url)
```

```json 200 theme={"dark"}
{
  "created": 1719123456,
  "data": [
    {
      "url": "https://example.com/edited_image.png"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.