OpenAI 绘画 (绘画格式) - 数字先锋API文档

### OpenAI 绘画 (chat绘画格式)生成图片，适用于以下模型：

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

# 图片生成 API 文档

## 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 明细 |

---

## 9. 图片 URL 获取方式

图片地址位于：

```text
data[0].url
```

示例：

```text
https://webstatic.aiproxy.vip/output/20260625/139929/e07bb3cb-ec6a-4208-8a8a-55af8828c6d0/bc6d6e6a-42ee-4898-9d51-9fd85404d4fd.png
```

如果 `n` 大于 `1`，可能返回多个图片结果：

```text
data[0].url
data[1].url
data[2].url
```

---

## 10. revised_prompt 说明

`revised_prompt` 表示模型实际用于生成图片的优化提示词。

例如你提交的原始提示词是：

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

接口可能返回经过优化后的：

```text
[用途] 社交媒体品牌广告图，用于小红书封面
[尺寸] 1080×1600px
[质量] quality="high"
...
```
如提示词示例：
生成一张[抖音]直播界面截图。
主播：[超级美女]，姿态：[坐姿]，服装：[古装]。
背景：[直播带货]，灯光：[暖色/冷色/混合]。

UI叠加层：
- 顶部：主播头像 + 关注按钮 + 在线人数 + 排名/热值
- 左下：弹幕/评论列表（[N]条，内容示例）
- 右下或中部：商品卡片 / 礼物特效 / PK进度条
- 底部：输入框 + 功能图标（分享/点赞/礼物/购物车）

风格：[高保真UI]，比例 9:16。
约束：文字清晰可读，弹幕内容合理，界面元素不遮挡主播面部。
输出：高仿直播截图画面。
![](/uploads/editor/20260625/img_6a3d07d8c49fd0.21403728.png)

说明：

- `revised_prompt` 不一定和原始 `prompt` 完全一致。
- 它可能是模型或服务端为了提升生成效果而改写后的提示词。
- 最终图片通常以 `revised_prompt` 为主要生成依据。
- 如果业务需要严格控制生成内容，应尽量在原始 `prompt` 中写清楚限制条件。

---

## 11. HTTP 请求要求

### 请求方法

必须使用：

```text
POST
```

不能使用：

```text
GET
```

如果直接在浏览器打开接口地址，浏览器默认会发送 `GET` 请求，可能返回：

```json
{
  "error": {
    "message": "Invalid URL (GET /v1/images/generations)",
    "type": "invalid_request_error"
  }
}
```

---

### 请求头

必须包含以下请求头：

```text
Accept: application/json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

说明：

| 请求头 | 必填 | 说明 |
|---|---:|---|
| `Accept` | 建议 | 指定期望返回 JSON |
| `Authorization` | 是 | API Key 鉴权 |
| `Content-Type` | 是 | 请求体格式，固定为 `application/json` |

---

## 12. 常见错误

### 12.1 请求方法错误

错误示例：

```json
{
  "error": {
    "message": "Invalid URL (GET /v1/images/generations)",
    "type": "invalid_request_error",
    "param": "",
    "code": ""
  }
}
```

原因：

- 使用了 `GET` 请求
- 在浏览器中直接打开接口地址
- `curl` 中没有使用 `--data` 或没有明确使用 `POST`

解决方法：

```text
使用 POST 请求，并提交 JSON 请求体。
```

---

### 12.2 API Key 错误或未授权

可能原因：

- `Authorization` 请求头缺失
- API Key 写错
- API Key 已过期
- API Key 被禁用
- API Key 没有对应模型权限

解决方法：

```text
检查 Authorization: Bearer YOUR_API_KEY 是否正确。
```

---

### 12.3 模型不存在或无权限

可能原因：

- `model` 参数填写错误
- 当前账号没有该模型权限
- 服务端未配置该模型

正确模型示例：

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

---

### 12.4 参数错误

可能原因：

- `prompt` 为空
- `size` 格式错误
- `n` 不是数字
- JSON 格式错误
- 请求头没有设置 `Content-Type: application/json`

错误请求示例：

```json
{
  "model": "gpt-image-2",
  "prompt": "",
  "size": "abc",
  "n": "1"
}
```

正确请求示例：

```json
{
  "model": "gpt-image-2",
  "prompt": "一只小狗坐在草地上",
  "size": "1024x1024",
  "n": 1
}
```

---

### 12.5 内容安全拦截

可能响应：

```text
Your request was rejected by the safety system
```

或：

```text
safety_violations=[sexual]
```

原因：

- 提示词包含敏感内容
- 涉及色情、暴力、未成年人、违法等内容
- 上传或引用的内容触发安全策略
- 提示词被安全系统误判

解决方法：

- 修改提示词，避免敏感描述
- 删除容易误判

上一篇：OpenAI 绘画 (chat)聊天格式下一篇：让模型直接给出搜索结果回答