Gemini 2.5 Flash-Liteは、Googleが2025年6月17日にプレビュー版を発表し、同年7月22日に安定版の提供を発表したモデルです。ここではGoogleの英語版発表記事の日付を基準にしています。公開時には、速度とコスト効率を重視し、翻訳や分類などの処理に向くモデルとして紹介されました。[1][2]
APIの基本操作を覚えたあと、「モデルの返答を何に使えばよいか」で迷うことがあります。今回は、あらかじめ用意した10問の英単語問題を、採点と復習ができるWebページにする課題を選びました。
2026年11月2日、Crazyrouter APIからgemini-2.5-flash-liteを呼び出してHTMLを生成しました。初版には主要なゲーム機能がありましたが、結果画面などに不足があったため、ローカルで修正しています。ここでは依頼を「入力する教材」と「画面の動作」に分け、返答と実装の差を確認していきます。接続設定は最後にまとめます。
Gemini 2.5 Flash-Liteに渡す問題と画面の動作を決める
英単語クイズのデモでは、1問につき4つの選択肢から答えを選びます。正解は10点、不正解は0点。解答後には正解と説明を表示し、終了後は全問の再挑戦と、間違えた問題だけの復習ができます。
問題文は英語ですが、ボタン、問題の訳、解説は元の簡体字中国語のままです。「开始闯关」が開始、「下一题」が次の問題、「查看成绩」が結果表示に相当します。生成時の指示も中国語で、日本語での生成能力を測った実験ではありません。
問題、正解、解説は生成前に用意しました。たとえばborrowとlendの違いを、ペンや傘を借りる場面で練習する内容です。モデルには問題作成と自己採点まで任せず、決まった教材をページに組み込む役割を与えました。
依頼には見た目だけでなく、操作の条件も含めました。
| 項目 | 指定した動作 |
|---|---|
| 問題数と得点 | 全10問、1問10点。誤答による減点はしない |
| 解答後 | 選択肢をロックし、同じ問題で再加点しない |
| 次の問題へ進む | 未解答の問題は飛ばせない |
| 間違えた問題の復習 | 対象の問題数に合わせて満点も変える |
| 全問をやり直す | 前の得点と解答記録を消す |
| ファイル構成 | 外部画像やフォントに依存しない単一HTML |
このように書くと、生成後に期待する結果が明確になります。3問間違えた場合、復習は3問で満点は30点です。全問の再挑戦を選ぶと、10問・満点100点に戻る必要があります。
解答前は選択肢を選べる一方、次の問題には進めません。解答後は同じ問題に再回答できず、正解と解説を読んでから先へ進みます。終了後は、その回の記録を確認するか、新しい問題集合でやり直します。
重要なのは、ボタンが表示されることだけでなく、状態が変わった後のデータです。復習で3問に減ったのに満点が100点のままだったり、再挑戦で前回の得点が残ったりすると、学習者に誤った結果を伝えてしまいます。
Gemini 2.5 Flash-Liteでクイズページを生成できる理由
モデル、APIサービス、ブラウザーは別々の役割を持っています。モデルは入力を処理して回答を生成し、APIサービスはプログラムからそのモデルを呼び出す窓口になります。生成したHTMLを表示し、ボタン操作や採点を実行するのはブラウザーです。
Googleのモデル資料には、入力としてテキスト、画像、動画、音声、PDF、出力としてテキストが挙げられています。画像を入力できることと、画像を生成できることは異なります。この型番の出力はテキストです。また、実際に利用できる入力形式やパラメーターは、接続先のAPIでも確認する必要があります。[3]
HTMLや画面のスタイル、採点処理もテキストで記述できるため、モデルに小さなWebページを作らせることができます。今回のAPI呼び出しは、そのファイルを生成するためのものでした。完成後のクイズは、解答のたびにモデルを呼び出しません。
今回は、問題データを渡してページの構造と操作を生成させます。モデルに判断を任せる部分を減らしておくと、出力と元の教材を照合しやすくなります。
ほかにも、通知文から日時を取り出す、問い合わせを決めた区分に分類する、用語集から練習問題の案を作る、といった使い方が考えられます。Googleも分類や単純な情報抽出を用途として挙げていますが、この記事で実測したのはクイズページの生成だけです。[3]
Gemini 2.5 Flash-Liteを1回呼び出して得られた結果
今回の生成条件と返答は次のとおりです。
| 項目 | 内容 |
|---|---|
| 実行日 | 2026年11月2日 |
| 接続先 | CrazyrouterのChat Completions API |
| モデルID | gemini-2.5-flash-lite |
| 指示の言語 | 中国語 |
| 生成リクエスト | 1回 |
| 主な設定 | temperatureは0.3、max_tokensは9000、streamはfalse |
| 返答 | HTTP 200、finish_reasonはstop |
| 完全な返答を受け取るまで | 約18.1秒 |
18.1秒はこの1回の所要時間です。修正や検証に使った時間は含みません。繰り返し測定した速度比較でもありません。
まず確認するのは、返答が空でないか、HTMLの途中で切れていないかです。ただし、HTTP 200で完全なファイルを受け取っても、ゲームの仕様が正しく実装されたとは判断できません。
Gemini 2.5 Flash-Liteの初版を仕様と照合して修正する
初版をスクリプトで操作すると、全問正解で100点、全問不正解で0点、7問正解・3問不正解で70点になりました。そこから復習に進むと3問・満点30点になり、同じ選択肢を繰り返し選んでも追加の得点は入りませんでした。
一方で、次の4点は修正が必要でした。
| 初版の不足 | ローカルで行った修正 |
|---|---|
| 最終問題でも「次の問題」に相当するボタン名 | 結果表示に進むことが分かる名前へ変更 |
| 振り返り画面に各問の解説がない | 問題に対応する解説を追加 |
| 全問正解時に、誤答がないことを明示しない | 誤答なしのメッセージを表示 |
| 正解の単語が解答フィードバックの見出しにない | 見出しにも正解を表示 |
これらは追加のモデル呼び出しを行わずに修正しました。操作状態の保護、キーボード処理、狭い画面向けのスタイルも調整しています。公開デモは、この修正版です。
修正後は11項目の自動テストを通過しました。使用したのはjsdomによる仮想DOMで、ページ要素とスクリプトの動作を確認しています。実ブラウザーでの見た目、タッチ操作、端末ごとの表示確認は未完了です。自動テストの成功を、そのままスマートフォンでの操作確認済みとは扱っていません。
次の変更でも、画面が表示されるかに加えて、解答前に進めないか、解答後に再加点されないか、復習を始めると古い得点が消えるかを確認します。
Gemini 2.5 Flash-Liteで作ったクイズの問題を入れ替える
自分の題材に変える場合も、まず問題を差し替え、採点や画面遷移は保つと原因を追いやすくなります。選択肢を増やす場合は、複数の正解が成立しないかも確認してください。
ソースファイルからindex.htmlをダウンロードすれば、ローカルで開けます。現在の問題は固定で、ページを再読み込みしても新しい問題は生成されません。学習記録の永続保存もありません。
その代わり、ファイルを開いて遊ぶ段階ではAPIキーが不要です。オンラインで毎回問題を生成したい場合は、サーバー側の呼び出しと使用量の管理を別途設計する必要があります。
Gemini 2.5 Flash-Liteの利用先とAPI接続設定
利用可否は提供元ごとに確認します。2026年11月2日時点のGemini Developer API資料は、2.5系へのアクセスを過去に利用実績のあるユーザーに制限しています。一方、Google Cloud側のページには2026年10月20日の提供終了日が記載され、Gemini APIは別のライフサイクルに従うと説明されています。[3][5]
今回使ったのはCrazyrouter APIです。呼び出し前に現在のアカウントのモデル一覧で型番を確認しました。Gemini 2.5 Flash-Liteのモデル情報を確認したうえで、自分のアカウントでも利用できるかを確かめてください。
OpenAI互換の接続先を指定できるツールでは、主に次の3項目を設定します。[4]
| 設定 | 指定する内容 |
|---|---|
| API Key | Crazyrouterの管理画面で取得した自分のキー |
| Base URL | https://api.crazyrouter.com/v1 |
| Model | gemini-2.5-flash-lite |
HTTPリクエストを直接送る場合は、POST先をhttps://api.crazyrouter.com/v1/chat/completionsとし、Bearer認証を使います。Base URLだけを求めるツールに完全なエンドポイントを入れると、パスを重複させる場合があるため、入力欄の意味を確認します。[4]
モデルへの指示はmessagesに含めて送ります。問題データ、採点条件、復習の動作、単一HTMLで返す要求をまとめます。返答を直接処理する場合は、choicesの最初の要素にあるmessage.contentから生成された本文を取り出します。[4]
受け取ったHTMLは、前後の説明文やコードを囲む記号を除いて保存します。ファイル名の末尾が.html.txtにならないよう注意し、ブラウザーで開いて問題数と得点を確認します。APIキーは呼び出し用のツールやサーバー側で管理し、共有するHTMLには埋め込みません。
今回のように小さな題材でも、仕様に沿った初版を作る助けになります。次の機能を足す前に、全問正解、誤答だけの復習、全問の再挑戦という3つの流れを確認すると、変更後の問題を見つけやすくなります。
参考資料（2026年11月2日確認）：
[1] Google：2025年6月17日のプレビュー発表。
[2] Google Developers Blog：2025年7月22日の安定版発表。
[3] Google AI for Developers：Gemini 2.5 Flash-Liteのモデル仕様。
[4] Crazyrouter：APIドキュメントとリクエスト・レスポンス形式。
[5] Google Cloud：モデル仕様とライフサイクル。