Gemini ネイティブ

1 つの BeatAPI キーで、Gemini generateContent リクエストから Gemini 4 Argon、Gemini 3.8 Flash、Gemini 3.1 Pro を呼び出せます。

• POST /v1beta/models/{model}:generateContent で、現行の Gemini モデルすべてを呼び出せます。ストリーミングは :streamGenerateContent?alt=sse を使います。
• テキストと画像の入力、テキスト出力、ストリーミング、関数呼び出し、思考に対応しています。
• キーは x-goog-api-key ヘッダー、または Bearer トークンで送ります。
• モデル ID は URL に入れ、リクエストボディには入れません。

このエンドポイントをテスト画面で開きます。BeatAPI の API キーを入力して送信してください。実際に呼び出され、ご自身の残高から課金されます。

モデル

次の ID のいずれかを、URL の {model} の位置に入れます。

• 価格は基本ティアで、割引適用後です。長文コンテキストのティア、キャッシュ入力価格、キャッシュ書き込み価格はこの表に含まれません。価格表を参照してください。
• — はカタログが数値を公開していないことを示します。

このファミリーの旧 ID は引き続き使え、旧モデルにまとめています。

クイックスタート

キーは BEATAPI_API_KEY に置き、ブラウザーのコードには入れないでください。モデル ID は URL に入るため、ボディに model フィールドはありません。以下はリクエスト例であり、実際のモデル出力の記録ではありません。

回答は candidates[0].content.parts[0].text から読み取り、続けて candidates[0].finishReason と usageMetadata を確認します。HTTP 200 だけでは回答がタスクを満たす証拠にならないため、内容はアプリケーション側で検証してください。テキストリクエストは直接結果を返すので、/v1/tasks をポーリングする必要はありません。

curl --request POST \
  --url https://direct.beatapi.io/v1beta/models/gemini-3.8-flash:generateContent \
  --header "x-goog-api-key: $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Design a resilient webhook retry strategy for a payments API."
        }
      ]
    }
  ]
}'

エンドポイントと認証

POST https://direct.beatapi.io/v1beta/models/{model}:generateContent

ストリーミングは POST /v1beta/models/{model}:streamGenerateContent?alt=sse を呼びます。キーは x-goog-api-key ヘッダー、または Authorization: Bearer <key> で送ります。どちらでも動きます。

:countTokens は使えず、404 が返ります。

リクエストパラメーター

以上が有効なフィールドです。それ以外の Gemini フィールドはリクエストに含めても受け付けられますが、効果はありません：generationConfig.thinkingConfig、generationConfig.responseMimeType、generationConfig.responseSchema、generationConfig.seed、safetySettings、toolConfig、cachedContent。これらに頼らないでください。

[
  {
    "role": "user",
    "parts": [
      { "text": "What is in this image?" },
      { "inlineData": { "mimeType": "image/png", "data": "<base64>" } }
    ]
  }
]

{
  "parts": [{ "text": "Answer in one short paragraph." }]
}

{
  "temperature": 0.7,
  "topP": 0.95,
  "maxOutputTokens": 2048,
  "stopSequences": ["END"]
}

[
  {
    "functionDeclarations": [
      {
        "name": "get_weather",
        "description": "Get the current weather for a city.",
        "parameters": {
          "type": "object",
          "properties": { "city": { "type": "string" } },
          "required": ["city"]
        }
      }
    ]
  }
]

レスポンス

ストリーミングなしの呼び出しは JSON オブジェクトを 1 つ返します。以下は省略した例です。

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Retry with exponential backoff and jitter, and make every handler idempotent."
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 19,
    "candidatesTokenCount": 16,
    "totalTokenCount": 120,
    "thoughtsTokenCount": 85
  }
}

レスポンスのフィールド

ストリーミング

:streamGenerateContent?alt=sse を呼びます。各イベントは data: {...} の 1 行で、中身は candidates オブジェクトです。形はストリーミングなしの回答と同じです。

• 最後のイベントに finishReason（例："STOP"）が入ります。
• レスポンスは text/event-stream です。モデルを呼ぶ前に起きた失敗は、ストリームイベントではなく、HTTP ステータス付きの通常の JSON エラーで返されます。
• 明示的なタイムアウトを設定し、ストリーミングレスポンスを安全に再接続してください。

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"Retry"}]},"index":0}]}
data: {"candidates":[{"content":{"role":"model","parts":[{"text":" with backoff"}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":19,"candidatesTokenCount":16,"totalTokenCount":120,"thoughtsTokenCount":85}}

エラー

HTTP エラー早見表

Gemini ネイティブのエンドポイントのエラーは {"error": {"message", "type": "beatapi_error", "code"}} の 1 形式だけで、コードは error.code、request id は message の末尾にあり、retryable はありません。詳しくはエラーを参照してください。

全エラーコード表と再試行ポリシーはエラーを参照してください。

注意事項

• Gemini モデルは Chat Completions、Responses、Anthropic Messages でも呼び出せます。Gemini のほかのページを参照してください。
• 思考トークンは出力トークンとして課金されます。回答だけでなく、思考と回答の両方に足りる出力枠を確保してください。
• キーは信頼できるサーバーだけに置き、レスポンスのリクエスト ID を記録し、再試行は 429、500、503 に限ってください。