画像生成の統合

OpenAI Images APIを使用して画像を生成し、Base64の結果を保存し、モデルの権限とタイムアウトをトラブルシューティングします。

本サイトの公開モデルカタログには現在 gpt-image-1.5 と chatgpt-image-latest が掲載されています（2026-10-16 確認）。使用前にまず利用可能なキーモデルの確認を照会し、次にコンソールのモデルカタログで画像APIとパラメータを確認してください。

このページはOpenAI Imagesプロトコルに準拠した統合サンプルを提供しています。今回のドキュメント更新では有料の画像生成は実行していないため、以下のサンプルをすべてのモデル、サイズ、品質の組み合わせが実測済みであると見なさないでください。

APIと準備

完全なアドレス：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。

画像を1枚生成して保存する

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 パラメータ非対応	カスタムサイズ、品質などのオプションパラメータを削除し、1つずつ検証する
403 / 404	画像モデルID、キーの権限、完全なAPIパスを確認する
待機時間が長い	生成に適切なタイムアウトを設定し、進行中の状態を表示して、連続クリックによる重複送信を防ぐ
タイムアウト後に画像がない	まず呼び出しログを確認する。結果が受信されないことは、上流でリクエストが処理されなかったことを意味しない
既存の画像を編集したい	画像編集は別のAPIと入力方式であり、このページのテキストから画像を生成するサンプルでは直接代替できない

プロトコルパラメータの参考：OpenAI 画像生成リファレンス。料金は本サイトのリアルタイムモデルカタログに準拠します。リトライ戦略についてはタイムアウトとリトライを参照してください。