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

## OpenAI 绘画 (chat聊天格式)生成图片
适用于OpenAI图像模型 `/v1/chat/completions` 接口，以及 `gpt-image-1-mini`、`gpt-4o-image` 两个图像生成模型。

## 图像生成 API 文档

## 1. 接口说明

通过 `/v1/chat/completions` 接口调用图像生成模型，用户以自然语言描述图片内容，模型会返回图片 URL。

适用模型：

- `gpt-4o-image`
- `gpt-image-1-mini`

接口地址：

```text
POST https://api.cxsee.com/v1/chat/completions
```

请求格式：

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

鉴权方式：

```text
Authorization: Bearer YOUR_API_KEY
```

---

## 2. 请求示例

### 2.1 使用 gpt-4o-image 生成图片

```bash
curl --location 'https://api.cxsee.com/v1/chat/completions' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4o-image",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "画只小狗"
      }
    ]
  }'
```

### 2.2 使用 gpt-image-1-mini 生成图片

```bash
curl --location 'https://api.cxsee.com/v1/chat/completions' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-mini",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "画一座未来主义生态住宅，玻璃幕墙与垂直花园融合，黄昏柔和光线，鸟瞰视角"
      }
    ]
  }'
```

---

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 |
|---|---:|---:|---|
| `model` | string | 是 | 使用的模型名称，支持 `gpt-4o-image`、`gpt-image-1-mini` |
| `stream` | boolean | 否 | 是否开启流式响应。图像生成建议使用 `false` |
| `messages` | array | 是 | 对话消息列表 |
| `messages[].role` | string | 是 | 消息角色，用户输入固定为 `user` |
| `messages[].content` | string | 是 | 图片生成提示词，即用户希望生成的图片描述 |

---

## 4. 参数说明

### model

指定图像生成模型。

可选值：

```text
gpt-4o-image
gpt-image-1-mini
```

示例：

```json
{
  "model": "gpt-4o-image"
}
```

### stream

是否启用流式返回。

图像生成场景建议使用：

```json
{
  "stream": false
}
```

### messages

用于传入用户提示词。

示例：

```json
{
  "messages": [
    {
      "role": "user",
      "content": "画只小狗"
    }
  ]
}
```

---

## 5. 完整请求体示例

```json
{
  "model": "gpt-4o-image",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": "画只小狗"
    }
  ]
}
```

---

## 6. 响应示例

成功响应：

```json
{
  "id": "chatcmpl-6aef3e28-5ba3-4601-a086-8e0be80d97d6",
  "object": "chat.completion",
  "created": 1782382496,
  "model": "gpt-4o-image",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![image](https://webstatic.aiproxy.vip/output/c4ad91b4-9e79-46c9-8e96-0cde5b0ab9fe.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 809,
    "total_tokens": 819
  }
}
```

---

## 7. 响应字段说明

| 字段 | 类型 | 说明 |
|---|---:|---|
| `id` | string | 本次请求的唯一 ID |
| `object` | string | 响应对象类型，通常为 `chat.completion` |
| `created` | integer | 响应创建时间戳 |
| `model` | string | 实际调用的模型名称 |
| `choices` | array | 模型返回结果列表 |
| `choices[].index` | integer | 结果序号 |
| `choices[].message.role` | string | 返回消息角色，通常为 `assistant` |
| `choices[].message.content` | string | 返回内容，图片通常以 Markdown 图片格式返回 |
| `choices[].finish_reason` | string | 结束原因，正常为 `stop` |
| `usage` | object | Token 用量统计 |

---

## 8. 图片 URL 提取说明

接口返回的图片地址位于：

```text
choices[0].message.content
```

返回内容通常是 Markdown 图片格式：

```markdown
![image](https://webstatic.aiproxy.vip/output/xxx.png)
```

业务系统可从 Markdown 中提取括号内的图片 URL：

```text
https://webstatic.aiproxy.vip/output/xxx.png
```

---

## 9. 常见错误

### 9.1 未授权或 Key 错误

可能响应：

```json
{
  "error": {
    "message": "Unauthorized",
    "type": "invalid_request_error"
  }
}
```

原因：

- `Authorization` 请求头缺失
- API Key 错误
- API Key 已过期或被禁用

处理方式：

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

### 9.2 请求方法错误

错误示例：

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

原因：

- 使用了 `GET` 请求
- 浏览器直接打开接口地址

处理方式：

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

### 9.3 模型不存在或不支持

可能原因：

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

处理方式：

```text
确认 model 为 gpt-4o-image 或 gpt-image-1-mini。
```

### 9.4 内容安全拦截

可能响应：

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

原因：

- 提示词包含敏感内容
- 涉及色情、暴力、未成年人、违法等内容
- 图片生成请求被安全系统误判

处理方式：

```text
修改提示词，避免敏感描述；如确认误判，请联系平台支持并提供 request id。
```

### 9.5 请求超时

可能响应：

```json
{
  "error": {
    "message": "context deadline exceeded",
    "type": "read_response_body_failed",
    "code": "read_response_body_failed"
  }
}
```

原因：

- 图片生成耗时较长
- 上游模型响应慢
- 服务端或网关超时时间较短

处理方式：

```text
稍后重试，或简化提示词；服务端可适当增加超时时间。
```

---

## 10. 提示词建议

为了获得更好的图片效果，建议在 `content` 中描述清楚以下内容：

- 主体：图片中要画什么
- 风格：写实、插画、3D、赛博朋克、水彩等
- 构图：近景、远景、鸟瞰、正面视角等
- 光线：黄昏、柔和光线、电影感、自然光等
- 细节：材质、颜色、背景、氛围等

示例：

```text
画一只可爱的金毛小狗，坐在草地上，阳光明媚，背景是公园，写实摄影风格，浅景深
```
![](/uploads/editor/20260625/img_6a3d01b9337d93.40639364.png)

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

---

## 11. 注意事项

- 请求必须使用 `POST` 方法。
- 请求头必须包含 `Authorization` 和 `Content-Type: application/json`。
- 图片生成耗时可能比普通文本对话更长。
- `stream` 建议设置为 `false`。
- 返回的图片地址在 `choices[0].message.content` 中。
- 不要在公开文档、前端代码或日志中暴露真实 API Key。

上一篇：封面生成与文字叠加功能下一篇：OpenAI 绘画 (绘画格式)