Gemini APIの大きなファイル入力はどの方式を選ぶ？

入力方式ごとの容量と利用期間を比較する

inlineはリクエストまたはペイロード単位、外部URL、File APIのアップロード、GCS URI登録はファイル単位で容量を確認します。File APIを使う場合も、アップロードとGCS URI登録では保存量や利用期間の条件が異なります。

再利用する容量と日数、保存場所を確認する

まずファイル形式と容量を確認します。inlineを選ぶ場合は、リクエストまたはペイロードの上限が100 MBで、PDFには50 MBの条件がある点を確認してください。100 MB以内ならすべての形式やモデルで処理できるという意味ではありません。

公開HTTPS URLまたは署名付きURLを直接渡す方式は、1ファイル15 MBまでです。URLにするだけで大容量を扱えるわけではありません。15 MBを超える場合はFile APIなどの別方式を検討してください。この外部URL方式はGemini 2.0系列に対応しておらず、利用するモデルとMIMEタイプの条件も確認してください。

100 MBを超える規模のファイルを繰り返し使う場合は、File APIへのアップロードやGCS URI方式を検討します。File APIへのアップロードでは、上限が1ファイル2 GB、プロジェクト全体で20 GBであることを確認し、48時間の保持期間が利用予定に合うか判断してください。

GCSに保存済みのファイルを使う場合はGCS URI方式を検討し、1ファイルの上限である2 GB以内かを確認します。1回の登録でアクセスできるのは最大30日間なので、利用予定と照合してください。アップロードの48時間とGCS URI登録の最大30日間を混同しないでください。

最後に、使うファイル形式、モデル、トークナイザーの個別条件を確認します。方式別の容量上限内であっても、その入力を処理できることまでは確定しません。