Gemini ネイティブ形式

Google GenAI SDK ベースで開発されたアプリケーション向けに、4ALL API は Gemini ネイティブプロトコル 互換を提供します:

POST https://api.4allapi.com/v1beta/models/{model}:generateContent
POST https://api.4allapi.com/v1beta/models/{model}:streamGenerateContent

リクエスト例

curl "https://api.4allapi.com/v1beta/models/omni-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $AIPROXY_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "黒洞を三文で紹介してください"}]
    }]
  }'

要点:

認証には x-goog-api-key ヘッダーを使用します(?key= クエリパラメータにも対応);
マルチモーダル入力は parts 配列を通じて inline_data(base64 画像) などとして渡します;
ストリーミングでは :streamGenerateContent を使用し、増分 JSON ブロックを返します;
生成パラメータは generationConfig に入れます(temperature、maxOutputTokens など)。

ネイティブと OpenAI 互換、どちらを使うべき?

場合	推奨
新規プロジェクト / 複数モデルの切り替え	OpenAI 互換インターフェースを使用し、モデル変更時は `model` だけ変更
既存の Google SDK コード	ネイティブプロトコルを使用し、base_url を変更するだけで可
Gemini 固有のフィールド(例: safety 設定)が必要	ネイティブプロトコルを使用