gpt-image-2 绘画 - 数字先锋API文档

## gpt-image-2绘画模型 
###### 该模型目前处于行业领先地位，特别适用于电商主图、营销海报、UI 原型设计及需要包含准确文字的视觉内容创作。
gpt-image-2 是 OpenAI 于 2026 年 4 月 21 日发布的旗舰图像生成模型（API 标识为 gpt-image-2），已全面替代 DALL-E 3。其核心突破在于引入视觉推理机制，实现了从“单纯绘图”到“理解并规划画面”的跨越，尤其在文字渲染和复杂指令遵循上表现卓越。
### 核心功能能力
高精度文字渲染：支持中、英、日等多语言文字精准生成，准确率超 99%。可在海报、Logo、UI 界面中直接输出清晰可读的文本，无需后期修正。
### 双模式生成架构：
Instant 模式：主打速度，适合快速出图和批量生成，所有用户可用。
Thinking 模式：生成前进行任务拆解、布局规划及自我核查，适合复杂构图、信息图及需逻辑推理的场景（通常需 Plus/Pro 权限）。
局部编辑与多轮迭代：支持基于已有图片的局部重绘（Inpainting），可指定修改特定区域（如换背景、改文字），并支持多轮对话式增量调整，保持画面一致性。
照片级真实感与 UI 生成：原生支持最高 4K 分辨率输出，光影、材质纹理自然；能精准理解界面布局逻辑，直接生成符合规范的 App 截图或网页设计稿。
强指令遵循与角色一致性：通过显式场景规划，能准确处理多对象空间关系、遮挡逻辑；在连续生成中可保持角色面部特征和服装风格的高度稳定。
### 技术参数与限制
分辨率支持：默认 2K，支持 1K 快速迭代及 4K 高清输出；宽高比支持范围从 3:1 到 1:3。

------------

##### 图片生成与编辑工具
独立工具使用文档：https://docs.cxsee.com/doc/view_197.html

## 1. 接口说明

该接口用于通过文本提示词生成图片。用户提交图片描述、尺寸、模型名称和生成数量，接口返回生成后的图片 URL。

接口地址：

```text
POST https://api.cxsee.com/v1/images/generations
```

请求格式：

```text
Content-Type: application/json
```

鉴权方式：

```text
Authorization: Bearer YOUR_API_KEY
```

---

## 2. 支持模型

| 模型 | 说明 |
|---|---|
| `gpt-image-2` | 图片生成模型，适合高质量图像生成 |
| `gpt-image-1` | 图片生成模型，适合通用图像生成 |
| `gpt-image-1.5` | 图片生成模型，适合增强质量或更复杂提示词场景 |
| `gpt-image-2-all` | 图片生成模型，适合综合能力更强的图片生成场景 |

---

## 3. 请求示例

### 3.1 使用 gpt-image-2

```bash
curl --location 'https://api.cxsee.com/v1/images/generations' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "未来主义生态住宅，玻璃幕墙与垂直花园融合，黄昏柔和光线，鸟瞰视角，参数化设计风格，柔和渲染效果",
    "size": "1024x1024",
    "n": 1
  }'
```

### 3.2 使用 gpt-image-1

```bash
curl --location 'https://api.cxsee.com/v1/images/generations' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1",
    "prompt": "一只可爱的金毛小狗坐在草地上，阳光明媚，背景是公园，写实摄影风格，浅景深",
    "size": "1024x1024",
    "n": 1
  }'
```

### 3.3 使用 gpt-image-1.5

```bash
curl --location 'https://api.cxsee.com/v1/images/generations' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1.5",
    "prompt": "赛博朋克风格的未来城市夜景，高楼林立，霓虹灯反射在雨后的街道上，电影感构图，高细节",
    "size": "1024x1024",
    "n": 1
  }'
```

### 3.4 使用 gpt-image-2-all

```bash
curl --location 'https://api.cxsee.com/v1/images/generations' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2-all",
    "prompt": "高端品牌香水广告图，透明玻璃瓶，水面倒影，柔和光线，极简背景，商业摄影风格",
    "size": "1024x1024",
    "n": 1
  }'
```

---

## 4. 请求参数

| 参数 | 类型 | 必填 | 说明 |
|---|---:|---:|---|
| `model` | string | 是 | 图片生成模型名称 |
| `prompt` | string | 是 | 图片生成提示词 |
| `size` | string | 是 | 图片尺寸，例如 `1024x1024` |
| `n` | integer | 否 | 生成图片数量，通常传 `1` |

---

## 5. 参数说明

### model

指定本次调用使用的图片生成模型。

可选值：

```text
gpt-image-2
gpt-image-1
gpt-image-1.5
gpt-image-2-all
```

示例：

```json
{
  "model": "gpt-image-2"
}
```

---

### prompt

图片生成提示词，用于描述希望生成的图片内容。

示例：

```json
{
  "prompt": "未来主义生态住宅，玻璃幕墙与垂直花园融合，黄昏柔和光线，鸟瞰视角，参数化设计风格，柔和渲染效果"
}
```

建议在提示词中包含：

- 主体：要生成什么
- 场景：背景、环境、空间
- 风格：写实、插画、3D、电影感、商业摄影等
- 构图：近景、远景、鸟瞰、正面视角等
- 光线：清晨、黄昏、柔光、逆光、自然光等
- 质量：高清、高细节、精致渲染等

---

### size

指定生成图片尺寸。

示例：

```json
{
  "size": "1024x1024"
}
```

常见尺寸示例：

```text
1024x1024
1024x1536
1536x1024
```

> 实际可用尺寸以服务端支持为准。如果传入不支持的尺寸，可能返回参数错误。

---

### n

指定生成图片数量。

示例：

```json
{
  "n": 1
}
```

通常建议设置为：

```json
{
  "n": 1
}
```

---

## 6. 完整请求体示例

```json
{
  "size": "1024x1024",
  "prompt": "未来主义生态住宅，玻璃幕墙与垂直花园融合，黄昏柔和光线，鸟瞰视角，参数化设计风格，柔和渲染效果",
  "model": "gpt-image-2",
  "n": 1
}
```

---

## 7. 成功响应示例

```json
{
  "created": 1782383894,
  "data": [
    {
      "revised_prompt": "[用途] 社交媒体品牌广告图，用于小红书封面\n[尺寸] 1080×1600px (符合16倍数及比例要求)\n[质量] quality=\"high\"\n\n[场景/背景]\n清晨的日式极简室内空间，\n- 保持图像2的色调、饱和度和用光逻辑不变。\n- 无水印、无额外文字、无商标 logo、无道具摆拍感。\n- 不改变构图留白比例，不改变人物面部朝向（始终低头不直视镜头）。\n- 人物面部自然真实，无过度美颜，无滤镜感。",
      "url": "https://webstatic.aiproxy.vip/output/20260625/139929/e07bb3cb-ec6a-4208-8a8a-55af8828c6d0/bc6d6e6a-42ee-4898-9d51-9fd85404d4fd.png"
    }
  ],
  "model": "gpt-image-2",
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 2827,
    "input_tokens": 1722,
    "output_tokens": 1105,
    "input_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 1722,
      "audio_tokens": 0,
      "image_tokens": 0
    }
  }
}
```

---

## 8. 响应字段说明

| 字段 | 类型 | 说明 |
|---|---:|---|
| `created` | integer | 响应创建时间戳 |
| `data` | array | 图片生成结果列表 |
| `data[].url` | string | 生成图片的访问地址 |
| `data[].revised_prompt` | string | 模型优化或重写后的提示词 |
| `model` | string | 实际调用的模型名称 |
| `usage` | object | 本次请求的用量统计 |
| `usage.total_tokens` | integer | 总 token 用量 |
| `usage.input_tokens` | integer | 输入 token 用量 |
| `usage.output_tokens` | integer | 输出 token 用量 |
| `usage.input_tokens_details` | object | 输入 token 明细 |

---

上一篇：体验中心 API 如何设置下一篇：Gemini 绘画（nano-banana系列）