OpenAI 图像生成（绘画） - 数字先锋API文档

## Chat（生成图片）OpenAI兼容接口 API文档

> 图像生成统一走 OpenAI 兼容接口：`/v1/chat/completions`

体验地址：https://try.cxsee.com/image/openai

## 1. 接口地址

```http
POST /v1/chat/completions
```

Base URL:
```text
https://api.cxsee.com
```

完整地址：
```text
https://api.cxsee.com/v1/chat/completions
```

---

## 2. 认证方式

请求头：

```http
Authorization: Bearer sk-your_api_key
Content-Type: application/json
```

---

## 3. 支持模型
所有对话模型，都可使用此接口， 修改 model 属性为模型名，需要模型支持生图能力，如
- `gpt-4o-image`
- `gpt-image-1`
- `gpt-image-1.5`
- `gpt-image-1-mini`
- `dall-e-3`

---

## 4. 请求参数

| 参数 | 类型 | 必填 | 说明 |
|---|---|---:|---|
| `model` | string | 是 | 图像生成模型名 |
| `messages` | array | 是 | 对话消息，通常传一条 `user` 文本描述 |
| `stream` | boolean | 否 | 是否流式，建议 `false` |
| `max_tokens` | integer | 否 | 最大输出 token，按需设置 |

### `messages` 推荐写法

```json
"messages": [
  {
    "role": "user",
    "content": "画一只猫"
  }
]
```

---

## 5. 标准请求示例（cURL）

```bash
curl -X POST "https://api.cxsee.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "画一只猫"
      }
    ]
  }'
```

---

## 6. 标准成功响应

```json
{
  "id": "chatcmpl-2167285c-4b27-49e8-aca5-59a14897dc1a",
  "object": "chat.completion",
  "created": 1772733704,
  "model": "gpt-image-1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "![image](https://oss.filenest.top/uploads/b4c44cd0-c3f8-42ec-8505-10a6eca04667.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 807,
    "total_tokens": 817
  }
}
```

---

## 7. 返回结果解析规则（重要）

- 图片地址位于：`choices[0].message.content`
- 内容为 **Markdown 图片格式**，例如：
  ```md
  ![image](https://xxx.png)
  ```
- 业务侧可解析括号中的 URL 并直接展示图片。

### URL 提取示例（正则）

- 正则：`!\[.*?\]\((.*?)\)`
- 提取第一个分组即图片链接。

---

## 8. 错误码

- `400` 请求参数错误
- `401` API Key 无效或缺失
- `403` 无模型权限
- `429` 请求过于频繁
- `500/502/503` 服务异常

---

## 9. 最佳实践

1. 提示词尽量具体（主体、风格、构图、光线、色彩）。
2. 对外隐藏 API Key，务必走服务端中转。
3. 增加失败重试与超时处理。
4. 解析 `content` 中图片 URL 后再渲染，避免直接展示原 Markdown。

---

生成质量效果
![](/uploads/editor/20260321/img_69bdac41e70f14.50491115.png)

![](https://img.cxhao.com/images/5/2026/02/o4sbBT64XBSB2tBuLwaBJjUBbBBx6l.png)

上一篇：Models（列出可用模型）下一篇：体验中心 API 如何设置