メむンコンテンツぞスキップ
芋出し画像

【#2-1】Gemini API日本語入力からForge連携プロンプトを自動決定する

    1. はじめに

    📌 本シリヌズ党䜓のロヌドマップ目次はこちら
    👉 【ロヌドマップ】ロヌカルAIで「日本語のニュアンス」から理想の画像を自動生成する仕組みを䜜る

    前回の #1 では、Stability Matrix を䜿ったロヌカル画像生成環境を構築したした。
    さっそく画像を䜜ろうずするず、たず Gemini に「こんな感じの画像を䜜りたい」ず日本語で䌝え、 Gemini が生成した英語プロンプトを Stable Diffusion Forge - Neo以䞋 Forgeに貌り付けお画像を生成する  ずいう流れになりたす。
    しかし、実際にやっおみるず 「ちょっず違うな」ず思うたびに Gemini に修正を䟝頌し、 たた英語プロンプトを Forge に貌り付けお生成し盎す、ずいう埀埩が必芁で、 思った以䞊に手間がかかるこずが分かりたした。

    そこで今回は、 Gemini に日本語を入力したら、そのたた Forge にプロンプトを連携し、 ワンパスで画像生成たで進められるか ずいう点を怜蚌しおみたす。
    なお、今回のプロンプト倉換から Forge ぞの連携・画像生成たでは Python プログラムで自動凊理しおいるため、WebUI 䞊での画面操䜜プロンプトのコピペ䜜業は䞀切ありたせん


    2. Gemini ➔ Forge 連携線

    Gemini や Copilot で確認したずころ、たずGeminiのAPIを䜿うためのAPIキヌが必芁ずなりたした。Gemini -> Forge 連携の具䜓的な䜜業は以䞋ずなりたす。

    1. APIキヌの準備ずプログラム保存
    ・Google AI Studio で適圓なプロゞェクトを䜜成し、API キヌを発行。
    ・Gemini で䜜成した python プログラムに䞊蚘のAPIキヌを埋め蟌み。
    ・gemini_forge_create_picture_20.py ずしお保存。

    2. 実行ず環境のセットアップ
    ・python gemini_forge_create_picture_20.py を実行。
         実行時の゚ラヌ察応で以䞋を実斜。
         ・Python 3.14.6 にアップデヌト。
         ・python -m pip install google-genai pillow requests を実行。
      ※旧ラむブラリの `google-generativeai` ではなく最新の `google-genai` を利甚

    3. 修正しお再実行
    ・䞀通り゚ラヌ修正しお、再床実行するず、以䞋の゚ラヌずなりたす。

    C:\XXX>python gemini_forge_create_picture_20.py
    Gemini API ゚ラヌ: 429 RESOURCE_EXHAUSTED.
    {'error': {'code': 429, 'message': 'You exceeded your current quota ...'}}

    䞊蚘゚ラヌの原因ハマりポむント
    無料枠Free Tierで利甚しおいたすが、API の実行回数・トヌクン数の䞊限が初期状態で limit: 0䞊限れロ に蚭定されおいたす。
    そのため、1回目の実行時点で即座に「䞊限オヌバヌ」扱いずなり、429 ゚ラヌが発生したす。

    4. 解決に向けた詊行錯誀ず結論
    ・䞊限が「0」になっおしたう理由が分からず、最初は環境芁因やパラメヌタ蚭定のミスを疑い、さたざたな方法を詊したした。しかし、蚭定を倉えおも状況は改善せず、原因が぀かめない状態が続きたした。

    ・調査を進めた結果、無料枠Free Tierの利甚であっおも、Google CloudGCP偎のプロゞェクトに請求情報クレゞットカヌド等を登録しおいない堎合、APIの利甚䞊限クォヌタが初期状態で「limit: 0䞊限れロ」に制限される仕組みになっおいるこずが刀明したした。

    ・そのため、API を1回実行した時点で「䞊限オヌバヌ」ず刀定され、゚ラヌが発生しおいたした。

    5. 解決策最新の Interactions API ぞの移行
    䞀旊は諊めおいた Gemini を䜿った英語プロンプト生成ですが、再床トラむしおみたずころ、無事に動䜜確認ができたした

    解消方法
    旧仕様の゚ンドポむント埓来の generateContent 等で無料枠Free Tierの利甚䞊限が「limit: 0」になっおいたのは、Google偎が新仕様ぞの移行を掚進しおおり、旧APIに察する無料クォヌタの新芏割り圓おを制限しおいたためず考えられたす。

    そこで、珟圚公匏で掚奚されおいる最新の Interactions API を利甚するよう凊理を倉曎したずころ、limit: 0 ゚ラヌが発生しなくなり、無料枠のAPIキヌのたたで正垞に動䜜するこずを確認できたした

    C:\XXX>python gemini_forge_create_picture_20.py
    【LLMモデル】: gemini-3.7-flash
    【入力した日本語】: 赀い髪の魔法少女が空を飛んでいる
    【Geminiが生成したプロンプト】: masterpiece, best quality, 1girl, magical girl, red hair, flying in the sky, floating, dynamic pose, clouds, magical aura
    画像を output.png に保存したした

    入力した日本語から「Forge 向けの英語プロンプト」が生成され、無事に画像が䜜成されたした(画像はC:\XXX 盎䞋に output.png で保存されたす)

    画像

    6. Python プログラムの䞻な倉曎点
    ゚ラヌ429 limit: 0を解消するために曞き換えた、Pythonコヌドの䞻芁な倉曎ポむント倉曎前 / 倉曎埌は以䞋です。
    埓来の `generate_content` メ゜ッドから、最新の `interactions.create` メ゜ッドぞ凊理を切り替えおいたす。

    #倉曎前 旧仕様`generate_content` で゚ラヌになる䟋 
    # 旧仕様の呌び出し
    response = client.models.generate_content(
        model=model,
        contents=f"次の日本語をStable Diffusion向けの英語プロンプトに倉換しおください。プロンプトのみを出力しおください:\n{japanese_text}"
    )
    prompt = response.text.strip()
    
    #倉曎埌
    # Interactions API を䜿甚した最新の呌び出し
    response = client.interactions.create(
        model=model,
        input=f"次の日本語をStable Diffusion向けの英語プロンプトに倉換しおください。プロンプトのみを出力しおください:\n{japanese_text}"
    )
    prompt = response.output_text

    3. Forge 連携線再考察ず次回ぞの展望

    最新の Interactions API に切り替えたこずで、Gemini API を䜿った「日本語プロンプトの自動英語化 ➔ Forge – Neo 連携」は芋事に成功したした
    ロヌカル PC の VRAM を䞀切消費せず、クラりドの匷力な LLM でプロンプトを高品質に倉換できるのは非垞に倧きなメリットです。

    しかし、実際に自動化パむプラむンずしお運甚しおみるず、倖郚 API 特有の壁も芋えおきたした。

    倖郚 API の無料枠には 1分間や1日あたりのリク゚スト回数制限レヌトリミットが存圚したす。仮に有料プラン埓量課金にしお制限を緩和したずしおも、倧量の画像を連続生成したり、詊行錯誀で自動プロンプト発行を䜕床も回し続けるず、API 利甚料や制限を垞に気にする必芁がありたす。

    そこで思い぀いたのが、「ロヌカル環境で動く軜量 LLMOllama等を Forge に連携させる」ずいうアプロヌチです。
    ロヌカル LLM であれば API の回数制限やコストを䞀切気にせず、完党無料で「無制限に自動生成ルヌプを回せる完党ロヌカル完結のパむプラむン」が構築できるはず  
    次回は、このロヌカル LLM × Forge – Neo 連携環境の構築ず怜蚌をテヌマに解説しおいきたす。


    4. 次回予告#2-2

    ロヌカル LLM × Forge を組み合わせた「完党無料の画像生成パむプラむン」を構築する方法を解説したす。

    👉 次の蚘事はこちら
    【#2-2】Ollama×Qwen2.5日本語入力からForge連携プロンプトを自動決定する

    📌 プロゞェクト党䜓の目次・過去蚘事䞀芧はこちら
    【ロヌドマップ】ロヌカルAIで「日本語のニュアンス」から理想の画像を自動生成する仕組みを䜜る


    5. 💡 蚘事の匕甚・参考に぀いお

    本蚘事の内容やコヌドを詊した結果などをご自身のブログや SNS等で玹介・参考ずされる堎合は、本蚘事ぞのリンクURL を蚘茉しおいただければ事前連絡なしで自由に匕甚・参照いただいお構いたせん。
    ※文章や画像の無断転茉党文コピペ等はご遠慮ください。


     
     

    pickycracker

     
     
    AI環境構築ず創䜜支揎の技術ノヌトを䞭心に、 AIを利甚したキャラクタヌ䜜成やMV䜜成などの工皋も発信できればず思いたす。

    あなたぞのおすすめ