---
title: 图片生成接入
description: 使用 OpenAI Images 接口生成图片，保存 Base64 结果，并排查模型权限和超时。
---

<aside className="docs-publication" data-pagefind-ignore>

文档由 [1折AI](https://1zheai.com/editorial/#publisher) 维护。[来源与纠错说明](https://1zheai.com/editorial/)。

发现错误？[联系支持](mailto:support@1zheai.com)，请附页面地址和问题说明。不要发送密钥或账号资料。

</aside>

本站公开模型目录目前列有 `gpt-image-1.5` 与 `chatgpt-image-latest`（2026-10-16 核对）。使用前先查询[密钥可用模型](/docs/api-models/)，再到[控制台模型目录](https://1zheai.com/model-catalog)确认图片接口与参数。

本页按 OpenAI Images 协议提供接入示例；本次文档更新没有执行付费图片生成，不能将下面的示例当作所有模型、尺寸和质量组合均已实测。

## 接口与准备

- 完整地址：`POST https://1zheai.com/v1/images/generations`
- OpenAI SDK Base URL：`https://1zheai.com/v1`
- 使用本站的 `ONEZHE_API_KEY` 环境变量。
- 安装 Python SDK：`python -m pip install openai`。

## 生成并保存一张图片

保存为 `generate-image.py`，在终端执行 `python generate-image.py`：

```python
import base64
import os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ONEZHE_API_KEY"],
    base_url="https://1zheai.com/v1",
    timeout=300.0,
    max_retries=0,
)
result = client.images.generate(
    model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
    prompt="一只白色陶瓷茶杯放在浅灰色桌面上，柔和自然光，无文字。",
)
if not result.data:
    raise RuntimeError("响应没有图片数据，请检查错误信息与调用日志。")
item = result.data[0]
if item.b64_json:
    target = Path("generated-image.png")
    target.write_bytes(base64.b64decode(item.b64_json, validate=True))
    print(f"图片已保存到 {target.resolve()}")
elif item.url:
    print("返回的是图片地址，请及时下载：", item.url)
else:
    raise RuntimeError("响应没有 b64_json 或 url。")
```

示例使用默认输出格式。若另行指定 JPEG / WebP 等格式，保存时也要改成对应文件扩展名。不要把 Base64 字符串直接写成文本文件后改名为 PNG。

## 添加参数前先确认模型支持

先用只有 `model` 和 `prompt` 的请求验证。尺寸、质量、透明背景、输出格式等参数并非所有图片模型通用；不要直接复制其他供应商的模型名或专有参数。

返回 `data[].b64_json` 时进行 Base64 解码；返回 `data[].url` 时及时下载，不把临时 URL 当永久存储。应用需要自己安排结果存储。

## 常见问题

| 情况 | 排查方法 |
| --- | --- |
| 400 参数不支持 | 去掉自定义尺寸、质量等可选参数后逐项验证 |
| 403 / 404 | 核对图片模型 ID、密钥权限和完整接口路径 |
| 等待时间长 | 给生成设置合理超时并显示进行中状态，避免连续点击重复提交 |
| 超时后没有图片 | 先查看调用日志；未收到结果不代表上游没有处理请求 |
| 想编辑已有图片 | 图片编辑是另一种接口与输入方式，本页的文本生图示例不能直接替代 |

协议参数参考 [OpenAI 图片生成参考](https://developers.openai.com/api/reference/resources/images/methods/generate)。费用以本站实时模型目录为准；重试策略见[超时与重试](/docs/retries/)。