画像生成

OpenAIのImages APIを使い、プロンプトから画像を生成します。Nano Banana、GPT Image、Grok Imagine、FLUX 3を、それぞれ1回の呼び出しで利用できます。

画像を生成

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.zurelay.com/v1", api_key=os.environ["ZURELAY_API_KEY"])
result = client.images.generate(
    model="nano-banana-pro",
    prompt="A red fox curled up asleep in fresh snow at dawn, soft golden light, 85mm photo",
    size="2K",
    extra_body={
      "aspect_ratio": "3:2"
    },
)
print(result.data[0].url)

{
  "created": 1790870400,
  "data": [
    { "url": "https://...signed link, valid for 24 hours..." }
  ]
}

パラメータ

サイズ

Nano Bananaの料金は解像度によって決まり、指定されたサイズどおりに生成します。生成された画像が指定より小さい場合は再試行し、その画像は返しません。1Kの場合:

Grok Imagineは、1Kで約1メガピクセル、2Kで約4メガピクセルの画像を、モデル固有のサイズで生成します（1Kの16:9なら1280 × 720）。縦横比や解像度が異なる場合は再試行し、その画像は返しません。Grok Imagine Imageガイドをご覧ください。

FLUX 3は、1Kで約1メガピクセル、2Kで約4メガピクセル、4Kで約16メガピクセルの画像を、21:9から9:21までの15種類の縦横比で生成します。指定より小さい場合や縦横比が異なる場合は再試行し、その画像は返しません。FLUX 3ガイドをご覧ください。

GPT Image 2の料金はどのサイズでも同じです: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840。GPT Image 2.5 FlareとSunburstの料金はサイズによって決まります。1024 × 1024以下は1K、2560 × 1440以下は2K、それより大きいサイズは4Kです。サイズを指定しない場合、またはautoを指定した場合は、1024 × 1024で生成します。

リンクと履歴

• urlのリンクは署名付きで、24時間有効です。保存したい画像はダウンロードしてください。
• urlで返された画像は、ダッシュボードのライブラリにも30日間保存されます。ダウンロードや削除、参照画像としての利用ができます。b64_jsonで返された画像は保存されません。
• 保存された画像には、生成に使用したプロンプトも記録され、ダッシュボードで画像の横に表示されます。画像とプロンプトは、どちらも同じ30日後に削除されます。

所要時間

ほとんどの画像は10～60秒で完成しますが、4Kではさらに時間がかかります。処理が止まった場合は自動的に別の経路で再試行するため、クライアントのタイムアウトは10分に設定してください。待たずに受け取ることもできます。callback_urlを追加すると、完成した画像がサーバーに送信されます（コールバックをご覧ください）。

画像が生成されなかった場合

モデルがプロンプトを拒否した場合（コンテンツポリシーに抵触する場合など）は、モデルが示した理由とともに400 image_not_generatedが返され、料金はかかりません。nを1より大きく指定した場合は、生成された画像だけが返され、その分だけ料金がかかります。