# 编辑图像

来源: https://docs.aicentos.com/api/images/openai/edits

Language: zh-CN

> OpenAI 兼容的图像编辑接口：端点、鉴权与请求示例

OpenAI 兼容格式的图像编辑接口，请求体为 `multipart/form-data`。

`POST /images/edits`

## 鉴权

Bearer Token：API Key 在控制台「令牌管理」获取，放在请求头 `Authorization`。

## 请求

```bash
export AICENTOS_API_KEY="sk-your-aicentos-api-key"

curl -X POST "https://aicentos.com/v1/images/edits" \
  -H "Authorization: Bearer $AICENTOS_API_KEY" \
  -F "image=@photo.png" \
  -F "prompt=把背景换成夜晚的霓虹街头"
```

`image` 为要编辑的原图，`prompt` 描述编辑要求。

## 响应

`data` 数组返回编辑后的图像（`url` 或 `b64_json`）：

```json
{
  "created": 0,
  "background": "string",
  "output_format": "string",
  "size": "string",
  "data": [
    {
      "url": "string",
      "b64_json": "string"
    }
  ],
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0
  }
}
```