🎉 Get Free $5 on Signup!
Models
Enterprise
Subscribe
Resource
Activity
Documentation
Console

/google/gemini-3-flash-preview

G

Google: Gemini 3 Flash Preview

Google released Gemini 3 Flash Preview (gemini-3-flash-preview) on December 17, 2025. The model supports multimodal workloads and was introduced as a faster, lower-cost option within the Gemini 3 model family, with support for features such as tool use and computer-use workflows.

Modetext、image、file、audio、video → text
Input price$0.5 per M tokens
Output price$3 per M tokens
Context length1048576 tokens
Listed at2025-12-17T00:00:00Z

Google

Latency—
Throughput—
Upload rate—
Context length1048576 tokens
Max output65536 tokens
Input price$0.5per 1M tokens
Output price$3per 1M tokens
Cache read$0.05per 1M tokens
Cache write—per 1M tokens

Performance

Avg TPS—
Avg latency—
Avg success rate—
TPS—
TTFT—
Latency—
Success rate—

Success rate

Speed

Code Example

curl ${API_BASE_URL}/v1beta/models/gemini-3-flash-preview:generateContent \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-flash-preview",
    "messages": [
      {
        "role": "user",
        "content": "Hello"
      }
    ]
  }'

Replace <YOUR_API_KEY> with the API key generated on your token management page.

Authentication

All requests must include the Authorization: Bearer <TOKEN> header.

Endpoint Path

POST
google-generate-content

Supported Parameters

ParameterTypeDefaultDescription
boolean-Deprecated alias for reasoning.exclude. When true, reasoning tokens are returned in the response when supported by the model.
integer-This sets the upper limit for the number of tokens the model can generate in response. It won't produce more than this limit. The maximum value is the context length minus the prompt length.
map-Controls reasoning behavior for models that support thinking tokens, including whether reasoning is enabled, the reasoning effort, maximum reasoning tokens, and whether reasoning is excluded from the response.
map-Forces the model to produce specific output format. Setting to `{ "type": "json_object" }` enables JSON mode, which guarantees the message the model generates is valid JSON. **Note**: when using JSON mode, you should also instruct the model to produce JSON yourself via a system or user message.
integer-If specified, the inferencing will sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed for some models.
array-Stop generation immediately if the model encounter any token specified in the stop array.
boolean-If the model can return structured outputs using response\_format json\_schema.
float1.0This setting influences the variety in the model's responses. Lower values lead to more predictable and typical responses, while higher values encourage more diverse and less common responses. At 0, the model always gives the same response for a given input.
string or object-Controls which (if any) tool is called by the model. 'none' means the model will not call any tool and instead generates a message. 'auto' means the model can pick between generating a message or calling one or more tools. 'required' means the model must call one or more tools. Specifying a particular tool via `{"type": "function", "function": {"name": "my_function"}}` forces the model to call that tool.
array-Tool calling parameter, following OpenAI's tool calling request shape. For non-OpenAI providers, it will be transformed accordingly. [Click here to learn more about tool calling](/docs/guides/features/tool-calling)
float1.0This setting limits the model's choices to a percentage of likely tokens: only the top tokens whose probabilities add up to P. A lower value makes the model's responses more predictable, while the default setting allows for a full range of token choices. Think of it like a dynamic Top-K.

Rate Limits

GroupRPMTPMRPD

RPM = requests per minute, TPM = tokens per minute, RPD = requests per day. Limits apply by token group.

Pricing

ProviderBilling typePrice summary
G
Gemini
Per token
Input price$0.5per 1M tokens
Completion price$3per 1M tokens
Cache read price$0.05per 1M tokens
Cache write price$—per 1M tokens