Gemini
Gemini 3.1 Pro Preview · Chat completions
Text / Gemini / Gemini 3.1 Pro Preview / Chat completions
POST
/v1/chat/completionsRequest parameters
Authorization
Add an Authorization header whose value is Bearer followed by your API key.
Authorization: Bearer ****************
Header parameters
Content-TypestringOptional
application/json
AcceptstringOptional
application/json
Body parametersapplication/jsonrequired
modelstringRequired
Model ID, fixed to `gemini-3.1-pro-preview`
messagesarray[object]Required
List of conversation messages; each has `role` (system / user / assistant) and `content`
streamboolOptional
Whether to stream the response (SSE), default `false`
temperaturenumberOptional
Sampling temperature; higher is more random
top_pnumberOptional
Nucleus sampling; alternative to `temperature`. Range `0`–`1`
max_tokensintOptional
Maximum number of generated tokens
nintOptional
Number of completions to generate, default `1`
stoparrayOptional
Stop sequences; output halts when any is produced
presence_penaltynumberOptional
Penalize tokens already present to boost novelty. Range `-2`–`2`
frequency_penaltynumberOptional
Penalize tokens by frequency to reduce repetition. Range `-2`–`2`
reasoning_effortstringOptional
Reasoning depth for thinking models: `low` / `medium` / `high`
toolsarrayOptional
Tool / function definitions for function calling
tool_choicestring/objectOptional
Whether and which tool to call: `auto` / `none` / a named tool
response_formatobjectOptional
Constrain the output format, e.g. force a JSON object
extra_bodyobjectOptional
Vendor-specific options such as `thinking_config`, passed via `extra_body`
Example
{ "model": "gemini-3.1-pro-preview", "messages": [ { "role": "user", "content": "Hi, tell me about yourself" } ]}Request code samples
curl https://api.hotrouter.ai/v1/chat/completions \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-3.1-pro-preview", "messages": [ { "role": "user", "content": "Hi, tell me about yourself" } ] }'Response
200 · Success
idstringRequired
Unique id of this response
objectstringRequired
Object type
createdintegerRequired
Creation timestamp (seconds)
modelstringRequired
Model actually used
choicesarray[object]Required
List of generated results
usageobjectRequired
Token usage of this call
Example
{ "id": "chatcmpl-xxx", "object": "chat.completion", "created": 1730000000, "model": "gemini-3.1-pro-preview", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Hi! Nice to meet you…" }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 12, "completion_tokens": 24, "total_tokens": 36 }}