# 编辑图片（图生图）

基于一张或多张参考图 + 文字描述生成新图。请求体使用 `multipart/form-data`
直接上传图片二进制（OpenAI 标准）。多图通过 `image[]` 字段重复传入，
单图也可用 `image` 单字段。

计费跟 `/v1/images/generations` 一致，按上游回显的
`usage.input_tokens` / `output_tokens` 结算（参考图作为图像输入也计费）。

## POST /v1/images/edits

> 编辑图片（图生图）

基于一张或多张参考图 + 文字描述生成新图。请求体使用 `multipart/form-data`
直接上传图片二进制（OpenAI 标准）。多图通过 `image[]` 字段重复传入，
单图也可用 `image` 单字段。

计费跟 `/v1/images/generations` 一致，按上游回显的
`usage.input_tokens` / `output_tokens` 结算（参考图作为图像输入也计费）。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `multipart/form-data`

- **model** `string` **(required)**  
  
- **prompt** `string` **(required)**  
  图片描述（最长 32K 字符）
- **image** `string` **(required)**  
  参考图（PNG/JPEG/WebP，单张 ≤4MB）。多张时用 `image[]` 重复字段。
- **size** `string`  
  
- **quality** ``low` | `medium` | `high` | `auto`` (default: `auto`)  
  
- **n** `integer` (default: `1`)  
  
- **response_format** ``url` | `b64_json``  
  返回方式。Seedream（含 5.0 Pro）支持。
- **output_format** ``png` | `jpeg``  
  图像文件格式。Seedream（含 5.0 Pro）支持。

### Response

- **created** `integer`  
  创建时间（Unix 时间戳，秒）
- **data** `object[]`  
  生成的图片列表
- **data[].url** `string`  
  图片访问 URL
- **data[].b64_json** `string`  
  Base64 图像数据（`response_format=b64_json` 时返回）
- **usage** `object`  
  token 用量（按 token 计费的模型返回，如 `gpt-image-2`）
- **usage.input_tokens** `integer`  
  输入 token 数（含文本 + 参考图）
- **usage.output_tokens** `integer`  
  输出 token 数（生成图的 token 数）
- **usage.total_tokens** `integer`  
  

### Error Codes

- `400`: 
- `401`: 
- `402`: 
- `429`: 
- `502`: