# 生成图片

根据文字描述生成图片。计费方式：按生成张数 × 单价（CNY）扣费。
成功后返回图片 URL 列表。

## POST /v1/images/generations

> 生成图片

根据文字描述生成图片。计费方式：按生成张数 × 单价（CNY）扣费。
成功后返回图片 URL 列表。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **model** `string` **(required)**  
  图片模型 ID，可通过 `GET /v1/models` 过滤 `type: image` 获取
- **prompt** `string` **(required)**  
  图片描述提示词
- **n** `integer` (default: `1`)  
  生成图片数量，默认为 1
- **size** `string`  
  图片尺寸，格式为 `宽x高`
- **response_format** ``url` | `b64_json``  
  返回方式。`url` 返回图片链接；`b64_json` 返回 Base64。
- **output_format** ``png` | `jpeg` | `webp``  
  生成图像文件格式。Seedream 支持 png/jpeg；

### 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`: