Gemini 绘画（OpenAI 兼容） - 数字先锋API文档

# Gemini 绘画（聊天接口）模型格式

OpenAI兼容请求路径：/v1/chat/completions

模型包括gemini-2.5-flash-image、gemini-3-pro-image-preview、gemini-3.1-flash-image-preview、gemini-3.1-flash-image-preview-2k、gemini-3.1-flash-image-preview-4k、gemini-3.1-flash-image-preview-512px

Google最新的 第二代绘图模型，一致性极强, 快速版本，核心能力一览：

分辨率：最高 4K（4096×4096），与 Pro 持平参考图一致性：最多 14 张参考图（10 物体 + 4 角色），保持风格/角色一致极端比例：新增 1:4、4:1、1:8、8:1，适合长图、海报、Banner文字渲染：进阶文字生成，适合信息图、营销海报排版搜索增强：集成 Google Search + Image Search grounding思考链：内置 thinking process，复杂 prompt 先推理再生成

体验网址：https://try.cxsee.com/image/gemini/

## 1) 标准请求（非流式）

```bash
curl -s https://api.cxsee.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview-2k",
    "stream": false,
    "messages": [
      {
        "role": "user",
        "content": "画一只猫"
      }
    ]
  }'
```

---

## 2) 标准成功返回 JSON（图片场景）

```json
{
  "id": "chatcmpl-20260306052555462145928ivhFSgAl",
  "object": "chat.completion",
  "created": 1772746046,
  "model": "gemini-3.1-flash-image-preview-2k",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "\n画一只猫  \n ![image1](https://webstatic.aiproxy.vip/output/20260306/2335/9fe2f807-6c6f-400f-8f20-1dc20bd74781.png) [下载1](https://webstatic.aiproxy.vip/output/20260306/2335/9fe2f807-6c6f-400f-8f20-1dc20bd74781.png)  \n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 5,
    "completion_tokens": 2118,
    "total_tokens": 2123,
    "input_tokens": 0,
    "output_tokens": 0
  }
}
```

---

## 3) 字段标准说明（对外）

- `id`: 请求唯一ID
- `object`: 固定 `chat.completion`
- `created`: Unix 时间戳（秒）
- `model`: 实际使用模型名
- `choices[0].message.role`: 固定 `assistant`
- `choices[0].message.content`: 文本结果（图片任务通常含 Markdown 图片链接）
- `choices[0].finish_reason`: 常见 `stop`
- `usage`: token 用量统计（计费/审计参考）

---

## 4) 错误返回 JSON 标准

```json
{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}
```

常见 HTTP 状态码建议：
- `400` 参数错误
- `401` 鉴权失败
- `403` 无权限/额度不足
- `429` 频率限制
- `500` 服务内部错误
- `502/504` 上游网关或超时错误

---

## 5) 最简版

- Endpoint: `POST https://api.cxsee.com/v1/chat/completions`
- Auth: `Authorization: Bearer YOUR_API_KEY`
- Content-Type: `application/json`
- Compatible: OpenAI Chat Completions

---

上一篇：千问（Qwen）绘画下一篇：文本转语音（TTS）原生OpenAI格式