generate_images から generate_content へ書き換えるとき、引数は素直に移りません

from google.genai import types
 
gi = set(types.GenerateImagesConfig.model_fields) - {"http_options"}
ic = set(types.ImageConfig.model_fields)
gc = set(types.GenerateContentConfig.model_fields)
 
print(len(gi), sorted(gi & ic))      # そのまま残る
print(sorted((gi - ic) & gc))        # 上位の config へ移る
print(sorted(gi - ic - gc))          # 同名の行き先がない

from google.genai import types
 
IMAGE_CONFIG_KEYS = {"aspect_ratio", "image_size", "output_compression_quality",
                     "output_mime_type", "person_generation"}
TOP_LEVEL_KEYS = {"seed"}
NO_DESTINATION = {"add_watermark", "enhance_prompt", "guidance_scale",
                  "include_rai_reason", "include_safety_attributes",
                  "language", "output_gcs_uri", "labels"}
 
 
class UnportedArgument(RuntimeError):
    pass
 
 
def build_request(*, model, prompt, config):
    """旧 GenerateImagesConfig 相当の dict から generate_content の引数を組む。"""
    cfg = dict(config)
    notes = []
 
    for key in sorted(cfg):
        if key in NO_DESTINATION:
            raise UnportedArgument(
                f"{key} には gemini-3.1-flash-image 側の対応先がありません。"
                f"落とすか、別の手段に置き換えるかを決めてください。")
 
    if "negative_prompt" in cfg:
        prompt = f"{prompt}\n\n避けてほしい要素: {cfg.pop('negative_prompt')}"
        notes.append("negative_prompt をプロンプト本文に畳みました")
    if "safety_filter_level" in cfg:
        cfg.pop("safety_filter_level")
        notes.append("safety_filter_level は safety_settings への手当てが必要です")
 
    n = cfg.pop("number_of_images", 1)
    image_config = {k: cfg.pop(k) for k in list(cfg) if k in IMAGE_CONFIG_KEYS}
    top = {k: cfg.pop(k) for k in list(cfg) if k in TOP_LEVEL_KEYS}
    if cfg:
        notes.append(f"未知のキーを無視しました: {sorted(cfg)}")
 
    gen_config = types.GenerateContentConfig(
        response_modalities=["IMAGE"],
        image_config=types.ImageConfig(**image_config) if image_config else None,
        **top,
    )
    return {"model": model, "contents": prompt, "config": gen_config}, n, notes
 
 
def generate_images_compat(client, *, model, prompt, config):
    kwargs, n, notes = build_request(model=model, prompt=prompt, config=config)
    images, failures = [], []
    for i in range(n):
        try:
            res = client.models.generate_content(**kwargs)
        except Exception as e:            # 1回落ちても残りは続ける
            failures.append((i, repr(e)))
            continue
        for part in res.parts:
            if getattr(part, "inline_data", None):
                images.append(part.inline_data.data)
    return images, failures, notes

class _Part:
    def __init__(self, data): self.inline_data = type("D", (), {"data": data})()
class _Res:
    def __init__(self, data): self.parts = [_Part(data)]
class _Models:
    def __init__(self): self.calls = []
    def generate_content(self, **kw):
        self.calls.append(kw)
        if len(self.calls) == 2:
            raise RuntimeError("503 UNAVAILABLE")   # 2回目だけ落としてみる
        return _Res(b"\x89PNG-stub")
class StubClient:
    def __init__(self): self.models = _Models()

呼び出し回数      : 3
取得できた画像    : 2 枚
失敗した回        : [(1, "RuntimeError('503 UNAVAILABLE')")]
注記              : negative_prompt をプロンプト本文に畳みました
注記              : safety_filter_level は safety_settings への手当てが必要です
送った contents   : '夜明けの海を上から見た抽象画\n\n避けてほしい要素: 文字, 透かし'
image_config      : aspect_ratio='9:16' person_generation='ALLOW_ADULT' output_mime_type='image/png'
seed              : 42
response_modalities: ['IMAGE']
strict 判定       : guidance_scale には gemini-3.1-flash-image 側の対応先がありません。