パスパラメータ
string
必須
モデル名 (例:
gemini-2.5-pro、gemini-3.5-flash)。クエリパラメータ
string
APIキー(ヘッダー認証の代替)。
認証
Geminiエンドポイントは、複数の認証方法をサポートしています:?key=YOUR_API_KEYクエリパラメータx-goog-api-key: YOUR_API_KEYヘッダーAuthorization: Bearer YOUR_API_KEYヘッダー
リクエストボディ
array
必須
会話コンテンツです。
role 値とすべての parts は送信時のまま保持され、trim/lowercase、Base64 の書き換え、MIME 推論は行いません。inlineData / inline_data と fileData / file_data はいずれも公式表記で、TokenLab は fileData.mimeType をローカル必須にしません。TokenLab で作成した Files/Cache ID は所有権を確認して元の upstream binding を維持し、その他のメディアやツール規則は provider に委ねます。object
モデルへのシステム指示。
object
ネイティブ生成設定です。
maxOutputTokens、candidateCount、thinkingConfig などの lowerCamelCase と対応する snake_case をそのまま受け付けます。失敗後に thinkingConfig を削除したり、streaming の candidateCount にローカル制限を設けたりせず、範囲や組み合わせは upstream が判断します。array
セーフティフィルター設定。
レスポンス
array
生成されたコンテンツの候補。
object
トークン使用状況の情報。
マルチモーダル入力例
Gemini のマルチモーダルリクエストでは、媒体をcontents[].parts[] に入れ、インラインバイトまたは URL ベースのファイル参照のどちらかで渡します。
現在の公共 Gemini 契約でサポートしている媒体カテゴリ:
- 画像
- 音声
- 動画
inlineData または inline_data を使い、Base64 化したファイルバイトを渡します。
URL 媒体では fileData または file_data を使い、公開到達可能な https URL を渡します。