便利だけど知られていないGemini APIの機能 📎 ファイルの渡し方、インラインとFiles API、どっちを使えばいいの？ Geminiの「ファイル入力方法（File input methods）」は、ファイルをモデルに渡す2つの方法の使い分けを整理した機能ガイドです。サイズや再利用パターンに応じた最適な選択ができます。 📌 タイトル：ファイル入力方法（File input methods） 🔗 URL： 🧩 概要 Geminiにファイルを渡す方法は主に2つ。リクエストにBase64で直接埋め込む「インラインデータ」と、事前にアップロードして参照IDで使う「Files API」です。それぞれにサイズ制限、再利用性、レイテンシ特性が異なり、適切に使い分けることでパフォーマンスとコストを最適化できます。 🛠 使い方 小さなファイル（数MB以下）はインラインデータとしてリクエストに直接含めるのが手軽。大きなファイルや繰り返し使うファイルはFiles APIでアップロードし、ファイルURIで参照。Files APIは一度アップロードすれば複数リクエストで再利用でき、毎回の転送を省けます。 🏗 本番システムへの組み込み方 ・チャットbotの画像入力：ユーザーが1回だけ送る小さな画像はインラインで。セッション内で何度も参照する資料はFiles APIで先にアップ。 ・バッチ処理：同じファイルに対して複数の分析を行う場合、Files APIで一度アップして参照IDを使い回すことで転送コストを削減。 ・ドキュメント分析パイプライン：大きなPDFはFiles APIでアップロード必須。小さな設定ファイルや短いテキストはインラインで。 ・モバイルアプリ：帯域が限られる環境では、Files APIで事前アップロードしておき、リクエストを軽量に保つ。 💡 ユースケース 📱 小さなファイルの手軽なインライン添付 📂 大きなファイルのFiles APIアップロード 🔄 同一ファイルの複数リクエストでの再利用 ⚡ 転送量の最適化によるレイテンシ改善 ⚠️ 注意点 インラインデータにはサイズ制限があり、大きなファイルはエラーになります。Files APIのファイルには有効期限があるため、長期保存が必要な場合は自前のストレージとの併用が必要です。また、Files APIのアップロードにはレート制限があるため、大量ファイルを短時間にアップする場合は注意しましょう。 ✨ 「とりあえず全部インラインで」は小規模なら問題ありませんが、規模が大きくなると差が出ます。ファイルの特性に合わせた使い分けで、効率的な入力設計を。 #Gemini# #LLM#