Skip to main content
TokenLab は、ネイティブ Gemini 契約を公開し、同一プロトコルの upstream ルートを持つモデルにのみこのルートを提供します。Chat Completions へのフォールバックはありません。ProtoJSON の lowerCamelCase と proto 元来の snake_case はどちらも公式で、混在リクエストも保持されます。未知のフィールドは best-effort で転送され、対応可否は upstream が判断します。

パスパラメータ

string
必須
モデル名 (例: gemini-2.5-progemini-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_datafileData / file_data はいずれも公式表記で、TokenLab は fileData.mimeType をローカル必須にしません。TokenLab で作成した Files/Cache ID は所有権を確認して元の upstream binding を維持し、その他のメディアやツール規則は provider に委ねます。
object
モデルへのシステム指示。
object
ネイティブ生成設定です。maxOutputTokenscandidateCountthinkingConfig などの 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 を渡します。

画像入力例

音声入力例

動画入力例

動画入力の例

音声入力の例