Gemini チャット

Gemini の全チャットモデルはOpenAI Chat Completions 互換プロトコルを使用します:POST https://api.hop-base.com/v1/chat/completions に Authorization: Bearer sk-your-key を付けてリクエストします(認証は x-api-key でも受け付けます)。x-goog-api-key、/v1beta/models/{model}:generateContent、/v1/responses、/v1/messages には対応していません。2 つの Gemini プランのプランでは対応パラメータが異なります——接続前に下記の「プランごとの機能差分」を確認してください。

利用可能なモデル

プランごとの機能差分

curl の例

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

SSE ストリーミング("stream": true を追加)

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemini-3.1-pro-preview", "stream": true,
    "messages": [{"role": "user", "content": "Hello"}]}'

Gemini 官方直连 プランのストリーミングは、応答全体を生成してからチャンクとして送信する方式のままです——最初のチャンクが届くタイミングは、ストリーミングなしで完全な応答を待つ場合とほぼ同じで、最後のチャンクには必ず usage が含まれます。Gemini 全系（含生图） プランはトークン単位でストリーミングします。usage が必要な場合は stream_options.include_usage を追加してください。

思考

Gemini モデルはデフォルトで思考を行い、完全にオフにすることはできません。思考トークンは出力上限に含まれます:max_tokens を小さくしすぎると、可視テキストが数文字しかないまま finish_reason=length になることがあるため、4096 以上を推奨します。OpenAI 形式では、思考トークンはすでに completion_tokens に含まれています(Gemini 全系（含生图） プランではさらに completion_tokens_details.reasoning_tokens に個別集計されます);ネイティブ形式では usageMetadata.thoughtsTokenCount に個別に報告されます。reasoning_effort: none を指定すると、思考量が明確に減少します。

Gemini ネイティブ形式のパススルー

Gemini SDK からそのまま持ってきたリクエストボディを送信できます:Gemini 官方直连 プランの同じエンドポイントはネイティブの contents フィールドも受け付け、レスポンスもネイティブ形式で返されます。受け付けるのは公式のトップレベルフィールドのみです(contents、systemInstruction、generationConfig、safetySettings、tools、toolConfig、cachedContent、labels、serviceTier、model)。それ以外のフィールド——store、max_tokens、messages など——を含めると 400 Unknown name … が返ります。ネイティブ形式はストリーミングに対応していないため、"stream": true を送らないでください。

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "contents": [{"role": "user", "parts": [{"text": "Hello"}]}]
  }'

Gemini Omni の動画生成(ネイティブ Interactions)

gemini-omni-flash-preview はテキスト・画像・動画の入力を受け付け、動画を直接出力できます。テキストから動画を生成する場合は model と input だけで十分です。完全なネイティブ動画レスポンスを得るには POST https://api.hop-base.com/v1beta/interactions を使用してください。Chat Completions エンドポイントはテキストチャットには引き続き使用できますが、完全な動画ペイロードの受信には使用しないでください。POST /v1/interactions は互換用のエイリアスとして引き続き利用できます。

curl https://api.hop-base.com/v1beta/interactions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-omni-flash-preview",
    "input": "Generate a 3-second video of a red ball slowly rolling on a white background"
  }'

動画は steps[].content[] に格納され、data に base64 エンコードされた MP4 が入ります。usage.output_tokens_by_modality は出力トークンをモダリティ別に参考として分解したもので、その数値はすでに total_output_tokens に含まれています。完全な仕様はGemini Omni 動画を参照してください。

{
  "status": "completed",
  "model": "gemini-omni-flash-preview",
  "steps": [{
    "type": "model_output",
    "content": [{
      "type": "video",
      "mime_type": "video/mp4",
      "data": "<base64-mp4>"
    }]
  }],
  "usage": {
    "total_input_tokens": 20,
    "total_output_tokens": 17819,
    "output_tokens_by_modality": [{"modality": "video", "tokens": 17376}]
  }
}