# 生成图片

使用「GPT 图片」分组对应的密钥，调用图片生成接口。使用 Magpie 时，先在 [Magpie 教程](./magpie.md) 添加「懒人AI · 图片」供应商。

**已实测：** 2026-10-28，Magpie 0.1.1888 本地 Images API → 懒人AI，`gpt-image-2` 返回 1 张 1024×1024 图片，用时约 56 秒，本站实际扣费 **¥0.05**。这次验证没有经过 Agent 聊天生图/MCP，也不代表所有模型、尺寸都已测过。

下面是直接 API 接入步骤，可交给你的 AI 执行。若经 Magpie 本地 API 调用，地址与模型前缀应使用你本机实际配置，不能照抄本站直连接口的密钥与模型写法。

## 模型与尺寸

四款完整名称为`gpt-image-2`、`gpt-image-2.5`、`gpt-image-2.5-flare`、`gpt-image-2.5-sunburst`。[统一单张价格见这里](./billing.md#gpt图片)，1K/2K/4K不再对应不同收费档。

`size`使用像素字符串，例如`1024x1024`，不要把`1K`直接当作所有接口均接受的值。2K/4K请求也必须使用该模型实际支持的尺寸；没有确认的尺寸列表不要猜填。返回像素和细节可能不等于请求值，下载后检查实际图片尺寸。

## 1 准备最小请求

保存为`image.json`：

```json
{
  "model": "gpt-image-2",
  "prompt": "一只戴紫色围巾的橘猫，简洁插画，无文字",
  "size": "1024x1024",
  "n": 1
}
```

`gpt-image-2`先不传`quality`，不要擅自填`standard`、`hd`或`4k`。三款2.5在本站2026-10-27的单张测试使用`quality: "low"`；换模型时按其说明填写，不把所有模型强行统一参数。

## 2 只提交一次

下载 [request.py](/docs/examples/request.py)，执行：

```sh
python3 request.py /v1/images/generations --json image.json --allow-charge --out image-result.json
```

程序隐藏输入密钥，提示确认后才提交。结果文件仅保存在本机，不覆盖同名文件。生成可能需要等待；超时并不证明没有生成或扣费，先查使用记录，不盲目重试。

## 3 保存图片

常见结果为`data`数组，元素中包含`b64_json`或`url`，以实际响应为准。

如果是`b64_json`，在本机执行：

```python
import base64
import json
from pathlib import Path

result = json.loads(Path("image-result.json").read_text(encoding="utf-8"))
for index, item in enumerate(result["data"], start=1):
    if not item.get("b64_json"):
        print(f"第{index}张使用URL返回，请在本机查看结果文件。")
        continue
    raw = base64.b64decode(item["b64_json"], validate=True)
    suffix = ".png" if raw.startswith(b"\x89PNG") else ".jpg" if raw.startswith(b"\xff\xd8\xff") else ".webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else ".bin"
    with open(f"image-{index}{suffix}", "xb") as output:
        output.write(raw)
```

如果是URL，用浏览器打开返回地址及时保存；**不要把本站Authorization请求头转发给图片托管域名**。图片URL可能具有临时访问权限，不要公开分享原链接。

## 常见问题

- **返回了文字没有图片：** 检查是否错用了Chat接口。
- **quality参数错误：** 先按以上最小参数使用，不自动做参数排列组合测试。
- **实际尺寸不同：** 以文件像素为准。Flare在历史1K请求中曾返回1254×1254，不能承诺严格尺寸。
- **想编辑图片：** 本页仅覆盖已核对的生成接口，不代表所有模型支持`images/edits`或multipart上传。

历史测试范围见[核验记录](./verification.md)，不是实时可用性保证。