---
title: "画像生成の統合"
description: "OpenAI Images APIを使用して画像を生成し、Base64の結果を保存し、モデルの権限とタイムアウトをトラブルシューティングします。"
headingIds: {"APIと準備":"section-1","画像を1枚生成して保存する":"section-2","パラメータを追加する前にモデルのサポートを確認する":"section-3","よくある問題":"section-4"}
---

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

ドキュメントは [1ZheAI](https://1zheai.com/en/editorial/#publisher) が管理しています。[出典と訂正](https://1zheai.com/en/editorial/)。

エラーを見つけましたか？ページのアドレスと説明を添えて[サポートに連絡](mailto:support@1zheai.com)してください。API キーやアカウント情報は送信しないでください。

</aside>
本サイトの公開モデルカタログには現在 `gpt-image-1.5` と `chatgpt-image-latest` が掲載されています（2026-10-16 確認）。使用前にまず[利用可能なキーモデルの確認](/ja/docs/api-models/)を照会し、次に[コンソールのモデルカタログ](https://1zheai.com/model-catalog?lng=ja)で画像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` を実行します：

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

プロトコルパラメータの参考：[OpenAI 画像生成リファレンス](https://developers.openai.com/api/reference/resources/images/methods/generate)。料金は本サイトのリアルタイムモデルカタログに準拠します。リトライ戦略については[タイムアウトとリトライ](/ja/docs/retries/)を参照してください。