Gemini Models | API Docs

Gemini models use the Common Chat Completions endpoint. This page records the supported model values and text chat contract.

text

POST https://api.requestbeam.com/v1/chat-completions

Available Models

`model` value	Non-streaming JSON	SSE streaming
`gemini-3.6-flash`	Yes	Yes
`gemini-3.7-flash`	Yes	Yes
`gemini-3.8-flash`	Yes	Yes
`gemini-3.5-flash-lite`	Yes	Yes

Model names distinguish product tiers; they are not latency, throughput, or quality SLAs. Compare models with your real workload. Check GET https://api.requestbeam.com/v1/models for availability to your API Key before making a request.

Authentication

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Non-streaming Request

json

{
  "model": "gemini-3.7-flash",
  "messages": [
    {
      "role": "system",
      "content": "You are a concise and accurate technical assistant."
    },
    {
      "role": "user",
      "content": "Explain idempotent APIs in five sentences."
    }
  ],
  "stream": false
}

Streaming Request

json

{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "Show a TypeScript API error-handling example."
    }
  ],
  "stream": true
}

This endpoint returns one complete JSON response by default. Set stream: true explicitly when you need SSE streaming.

Request Fields

modelstringrequired

Use gemini-3.6-flash, gemini-3.7-flash, gemini-3.8-flash, or gemini-3.5-flash-lite.

messagesobject[]required

OpenAI Chat Completions style messages. Each message contains role and content.

streambooleanDefault: false

true returns SSE; false returns one complete JSON response.

max_tokensinteger

Optional maximum output tokens, as a positive integer. Omit this field to use the upstream default for the selected model. Depending on the model, the budget may include reasoning tokens as well as final text. A small budget can truncate the answer or be exhausted before final text; increasing it may increase cost.

max_completion_tokensinteger

Optional compatibility alternative to max_tokens, with the same budget considerations. The selected model determines support; omit both fields to use the upstream default.

See Common Chat Completions for shared fields such as temperature, top_p, frequency_penalty, presence_penalty, stop, and n. Support and behavior of optional fields depend on the selected model; this page does not guarantee every shared field.

Success Response

json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "gemini-3.7-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "An idempotent API produces the same effective result when..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 118,
    "total_tokens": 144
  }
}

usage may include optional reasoning-token details; clients should tolerate them being absent or changing by model.

Usage Notes

The request body's model must be one of the public model IDs listed in the Available Models table.
Product names, display names, and other aliases are not accepted in place of a public model ID.
This page applies only to Chat Completions requests sent to

POST https://api.requestbeam.com/v1/chat-completions, not OpenAI Responses or Claude Messages.

Use GET https://api.requestbeam.com/v1/models for the models visible to the current API Key, and use the console for current pricing.