このAPIキーで使える画像生成モデルを列挙する。課金されない。キーが生きているかの確認にも使う（借りたキーはプロジェクト側で機能制限されていることがあるため、モデル名を推測せず必ずこれで確認する）。

プロンプトから画像を生成し、ファイルに保存してパスを返す（base64は返さない）。アバターの土台を作る用途では、背景を単色に・影とグラデーションを禁止・正面向きと明示すると後段の合成が楽になる。

既存画像を編集する。mask_path を渡すと、透明の画素だけが編集対象になる。 ⚠ 実測（2026-08-12）：マスクを渡しても画像全体が再生成される。マスク外の画素が0.7〜0.9%変化し、最大差分は220（ほぼ別の色）だった。同じキャラクターの差分絵（口の形・目の開閉）を作る用途では、この結果をそのままコマに使わないこと——30fpsで切り替えると顔が揺れる。compose_region で土台へ貼り直すこと。

edit_image の結果からマスク領域だけを切り出し、土台画像へ合成する。土台はビット単位で保たれるので、口の形や目の開閉を差し替えても顔が動かない。アバターの差分絵を作るなら必ずこれを通す。境界のぼかしは内側にだけ入る（単純にぼかすとマスクの外へ滲んで土台を汚すため）。numpy があれば土台の汚れを自動検証する。

編集したい領域（口・目など）を楕円で指定したマスクPNGを作る。座標は画像サイズに対する比率(0〜1)で渡す。例: 口 = left 0.40 / top 0.455 / right 0.60 / bottom 0.575、目 = 0.34 / 0.32 / 0.66 / 0.42。