图片生成接入

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

本站公开模型目录目前列有 gpt-image-1.5 与 chatgpt-image-latest（2026-10-16 核对）。使用前先查询密钥可用模型，再到控制台模型目录确认图片接口与参数。

本页按 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：

1
import base64
2
import os
3
from pathlib import Path
4
from openai import OpenAI
5

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

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

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

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

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

常见问题

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

协议参数参考 OpenAI 图片生成参考。费用以本站实时模型目录为准；重试策略见超时与重试。