Gemini ネイティブインターフェース

概要

AIone は Google Gemini ネイティブ API フォーマットでゲートウェイを直接呼び出すことに対応しており、自社ゲートウェイ集約、Google Gemini SDK、および既存の Gemini 連携コードがあるシナリオに適しています。

リクエストとレスポンスのフォーマットは Google Gemini API と完全に同一です。ゲートウェイは認証、ルーティング、課金のみを行い、フォーマット変換は一切行いません。

接続情報

項目	値
Base URL	`https://api.nexara.net`
認証ヘッダー	`Authorization: Bearer sk-nex-your-key-here`
非ストリーミングエンドポイント	`POST /v1beta/models/{model}:generateContent`
ストリーミングエンドポイント	`POST /v1beta/models/{model}:streamGenerateContent?alt=sse`

注意： AIone の API キー（sk-nex-xxx）を使用してください。Google の API キーではありません。

対応モデル

接続済みのすべての Gemini モデルがネイティブインターフェースで利用可能です：

テキストモデル： gemini-2.5-flash、gemini-2.5-pro、gemini-3-pro-preview、gemini-3-flash-preview、gemini-3.1-pro など

画像生成モデル： gemini-3.1-flash-image-preview、gemini-3-pro-image-preview、gemini-2.5-flash-image など

完全なリストは GET https://api.nexara.net/v1/models で確認できます。

非ストリーミングリクエスト — generateContent

基本的な例

レスポンスフォーマット

{
  "candidates": [
    {
      "content": {
        "parts": [{"text": "量子コンピューティングとは量子力学の原理を利用して..."}],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 25,
    "totalTokenCount": 35
  },
  "modelVersion": "gemini-2.5-flash"
}

画像生成の例

画像はレスポンスの candidates[0].content.parts[] 内に inlineData（base64 エンコード）として返されます。

注意： 4K 画像生成には 2〜3 分かかる場合があります。クライアントの HTTP タイムアウトを 600 秒以上に設定してください。

ストリーミングリクエスト — streamGenerateContent

エンドポイント URL の末尾に ?alt=sse を追加すると、レスポンスが SSE（Server-Sent Events）形式でチャンクごとに返されます。

例

SSE レスポンスフォーマット

data: {"candidates":[{"content":{"parts":[{"text":"春風"}],"role":"model"},"index":0}],"usageMetadata":{"promptTokenCount":8,"candidatesTokenCount":2,"totalTokenCount":10}}

data: {"candidates":[{"content":{"parts":[{"text":"が吹いて、"}],"role":"model"},"index":0}],"usageMetadata":{"promptTokenCount":8,"candidatesTokenCount":5,"totalTokenCount":13}}

data: {"candidates":[{"content":{"role":"model"},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":8,"candidatesTokenCount":28,"totalTokenCount":36}}

各 data: 行は独立した JSON オブジェクトです。usageMetadata は累積値であり、最後のチャンクの値が最終的な使用量となります。

注意： 画像生成モデルは streamGenerateContent に対応していません。generateContent を使用してください。

Python SDK の例

Node.js SDK の例

注意： Google 公式 SDK はカスタムエンドポイントを直接サポートしていない場合があります。この制限に遭遇した場合は、HTTP での直接呼び出しまたはカスタム Base URL をサポートするサードパーティライブラリの使用を推奨します。

OpenAI 互換フォーマットとの比較

項目	Gemini ネイティブパォーマット	OpenAI 互換フォーマット
エンドポイント	`/v1beta/models/{model}:generateContent`	`/v1/chat/completions`
リクエストボディ	`contents` + `generationConfig`	`messages` + `max_tokens`
レスポンスボディ	`candidates` + `usageMetadata`	`choices` + `usage`
画像パラメータ	`imageConfig.imageSize` / `imageConfig.aspectRatio`	`image_size` / `aspect_ratio`
ストリーミング	`:streamGenerateContent?alt=sse`	`"stream": true`
適用シーン	自社ゲートウェイ集約、既存 Gemini コード	汎用クライアント、IDE プラグイン

両フォーマットは同一のモデルセットおよび上流チャネルにアクセスします。お使いのクライアントに応じて選択してください。

制限事項と注意点

認証方式：AIone の sk-nex- API キーを使用してください。Google API キーではありません

画像モデルはストリーミング非対応：streamGenerateContent は画像生成モデルに対して 503 を返します。generateContent を使用してください

対応アクション：generateContent と streamGenerateContent のみ対応。countTokens、embedContent などは非対応です

タイムアウト設定：画像生成（特に 4K）では HTTP タイムアウトを 600 秒以上に設定してください

バイトレベル透過：リクエストとレスポンスはバイトレベルで透過されます。ゲートウェイはフォーマット変換を一切行いません

15 - Geminiネイティブインターフェース

Gemini ネイティブインターフェース#

概要#

接続情報#

対応モデル#

非ストリーミングリクエスト — generateContent#

基本的な例#

レスポンスフォーマット#

画像生成の例#

ストリーミングリクエスト — streamGenerateContent#

例#

SSE レスポンスフォーマット#

Python SDK の例#

Node.js SDK の例#

OpenAI 互換フォーマットとの比較#

制限事項と注意点#