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

# 图像生成

> POST /v1/images/generations —— 文生图

根据自然语言描述生成图片。

## 请求

```bash theme={null}
curl https://openp.ai/v1/images/generations \
  -H "Authorization: Bearer $OPENPAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A black-and-white pencil sketch of a Shiba Inu wearing glasses",
    "size": "1024x1024",
    "n": 1,
    "quality": "high"
  }'
```

### 参数

| 字段                | 类型      |  必填 | 说明                                                                 |
| ----------------- | ------- | :-: | ------------------------------------------------------------------ |
| `model`           | string  |  ✅  | `gpt-image-2` / `gpt-image-1` / `dall-e-3` / `dall-e-2`            |
| `prompt`          | string  |  ✅  | 文本提示词,最长 4000 字符                                                   |
| `n`               | integer |     | 张数(dall-e-3 仅支持 1)                                                 |
| `size`            | string  |     | `1024x1024` / `1792x1024` / `1024x1792`(DALL·E 3);gpt-image-1 支持更多 |
| `quality`         | string  |     | `standard` / `hd`(dall-e-3) `low` / `medium` / `high`(gpt-image-1) |
| `style`           | string  |     | `vivid` / `natural`(dall-e-3)                                      |
| `response_format` | string  |     | `url`(默认)或 `b64_json`                                              |
| `background`      | string  |     | `transparent` / `opaque`(gpt-image-1)                              |
| `output_format`   | string  |     | `png` / `jpeg` / `webp`(gpt-image-1)                               |

## 响应

```json theme={null}
{
  "created": 1715750400,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A pencil sketch in black and white of a Shiba Inu..."
    }
  ]
}
```

`url` 链接通常仅在 1 小时内有效,请下载或转存到自有存储。

`response_format: "b64_json"` 时返回 base64:

```json theme={null}
{
  "data": [{"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."}]
}
```

## DALL·E 3 注意

* 只能 `n=1`,生成多张请多次调用。
* `prompt` 会被模型自动改写,返回的 `revised_prompt` 是实际使用的提示词。
* 不支持 `mask` 编辑(请使用 [images/edits](/api-reference/openai/images-edits))。

## gpt-image-1 注意

* 支持 `n > 1`,可一次生成多图。
* 支持 `quality` 三档,价格差异明显。
* 支持透明背景(`background: "transparent"`)。

## 计费

按 **模型 × 尺寸 × 质量 × 张数** 一笔固定扣费,与 token 计费不同。
具体倍率以 [控制台 → 模型](https://openp.ai/dashboard/models) 显示为准。