Skip to main content

Light — We add no content filter, but this model goes past its own limits only some of the time, even with a fiction-writing system prompt. Expect refusals and plan for retries. Legal and consent duties remain with the customer.Browse every model at this filtering level
google/gemini-3-flash-preview/chat

Gemini 3 Flash Preview is Google's lightweight chat model with an OpenAI-compatible API. It reads up to 256,000 tokens and replies up to 65,536, with three reasoning-effort levels, up to 128 tools, JSON output and streaming.

Input $0.45Output $2.70per 1 million tokens10% below the publisher's list priceCached input $0.045Google official priceInput $0.50Output $3
Run model

Workbench

Send a request

Quickstart

Examples use the selected endpoint’s public parameter definitions. Replace the API key and example media, then send the request from your server.

SDKs & integrations
POSThttps://api.spicyapi.ai/v1/chat/completions

API authentication

Keep the API key in the server environment variable SPICY_API_KEY. Use Bearer authentication and Content-Type: application/json for JSON requests.

Authorization: Bearer $SPICY_API_KEY
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "google/gemini-3-flash-preview/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Generated from this model’s input schema — the same one the API validates every request against.

Keep one Idempotency-Key for each logical request. After a network interruption, do not automatically resend with a new key; retain request_id to investigate the accepted request. Idempotency does not replay an earlier chat stream.

Input parameters

Place the model parameters directly in the JSON request body alongside model. This endpoint does not use an input wrapper.

messagesarray<object>Required

Ordered turns, oldest first. Content is a string, or an array of text, image_url, video_url, audio_url and input_audio parts. Uploaded video and audio can total 14 MB per request. Put the character and the narration rules in the system message and append one turn at a time.

Default
Not specified
Constraints
minItems:1
response_formatobjectOptional

Ask for a JSON object and name every key in the system message - this is how branching options come back parseable.

Default
Not specified
tool_choicestring | objectOptional

auto, none, required, or an object naming one function.

Default
Not specified
toolsarray<object>Optional

Up to 128 function definitions per request.

Default
Not specified
Constraints
maxItems:128
top_pnumberOptional

0.01 to 1. Adjust this or temperature, never both in the same comparison.

Default
1
Constraints
minimum:0.01
maximum:1
temperaturenumberOptional

0 to 2, default 1. Google recommends keeping Gemini 3 models at the default 1.0 - lower values can make the model loop or degrade - so shape structured output with response_format and the system message instead.

Default
1
Constraints
minimum:0
maximum:2
seedintegerOptional

Any integer. The same seed with an otherwise identical request makes replies repeat closely, so you can change one thing at a time and compare fairly; it does not guarantee identical output. No default: each request draws fresh. No effect on price.

Default
Not specified
stopstring | arrayOptional

Up to 4 sequences, as a string or an array. The reply ends as soon as the model writes one of them, and the matched text itself is left out. No default. It does not change the rate; a reply cut short is billed only for the tokens it produced.

Default
Not specified
Constraints
minLength:1
minItems:1
maxItems:4
reasoning_effortstringOptional

minimal, low, medium or high; medium is the default. Routine turns run fine on low, and the turn that has to land can be raised to high on its own. Google's own default for this model is high; this endpoint defaults to medium to keep ordinary turns quick.

Default
"medium"
Allowed values
"minimal""low""medium""high"
max_tokensintegerOptional

Caps the reply at 65,536; the default is 16,384. For turn-by-turn play, 300 to 800 stops the model from answering with a whole chapter. Reasoning tokens are billed as output too, so leave headroom above the visible answer you expect.

Default
16384
Constraints
minimum:1
maximum:65536

Read the result

With stream set to false, the request returns the completed chat response directly. Read choices[].message; no task polling is needed. Set stream to true when your client supports Server-Sent Events.

Completed response example
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "google/gemini-3-flash-preview/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

The response example is illustrative. usage reports token counts; token counts and charges depend on your actual request.

SDKs & integrations

Use SpicyAPI in your app, terminal, AI assistant or visual workflow. Choose a setup guide below.

SDKs
TypeScript · Python · Go · PHP · Java
CLI
Terminal commands and automation scripts.
MCP
Claude Code · Cursor · Codex
Agent Skill
Reusable instructions for your AI assistant.
n8n
Self-hosted community nodes and importable HTTP Request templates for n8n Cloud.
ComfyUI
Image, video and audio workflows on a node canvas.

More integrations

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Browse ready-to-use workflows

Use it in SillyTavern and roleplay apps

In SillyTavern, RisuAI, Agnai or any app with an OpenAI-compatible setting, paste the base URL below and your API key, then pick google/gemini-3-flash-preview/chat as the model. Browser calls are allowed, and sliders this model does not take are ignored instead of rejected.

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-3-flash-preview/chat
SillyTavern guideRisuAI, Agnai and moreSillyTavern extension

Use it in ComfyUI

Install the SpicyAPI nodes from ComfyUI Manager or with the command below, then pick google/gemini-3-flash-preview/chat in the SpicyAPI Chat node to use this model inside a ComfyUI graph.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi
Workflow examplesSetup guideSource on GitHub